跳到主要内容

配置 API 密钥和 Webhooks

当外部系统需要与 Pragma 连接线索、集成或自动化时，请使用 API 密钥和 Webhooks。

前提条件​

  • 你是工作区 Owner 或 Master。
  • 工作区处于激活状态，未因试用到期而锁定。
  • Webhook 目标地址必须是可接收 POST 请求的 HTTPS URL。

创建 API 密钥​

  1. 打开 Platform & API。
  2. 进入 API 密钥。
  3. 点击 新建 API 密钥。
  4. 使用清晰名称，例如 Zapier Lead Import 或 Backend Sync。
  5. 只选择系统真正需要的 scopes。
  6. 创建后立即复制 token。token 只显示一次。
curl https://app.mikemuellers.de/api/leads \
  -H "Authorization: Bearer <your-api-key>"

注册 Webhook​

  1. 打开 Platform & API。
  2. 进入 Webhooks。
  3. 输入目标 URL。
  4. 选择事件，例如 lead.created 或 crm.synced。
  5. 保存 Webhook。
  6. 发送测试投递，并确认目标系统收到请求。

常见问题​

  • 401: token 缺失或格式错误。
  • 403: 用户或密钥权限不足。
  • 423: 工作区已锁定，通常是试用到期。
  • Webhook 未收到: 检查 HTTPS、防火墙、响应状态码和响应时间。