把 ConnectMachine 连接到 Zapier

Zapier 上的 ConnectMachine 应用为你的联系人提供三个触发器和两个动作。触发器是即时的，因此联系人发生变化后几秒内 Zap 就会运行，而不必等待轮询间隔。

你需要准备

• 一个已完成引导设置的 ConnectMachine 账号。
• 你的 ConnectMachine 套餐包含 Zapier 权限：付费订阅、组织许可席位，或处于有效期内的 Premium 试用。
• 一个 Zapier 账号。Zapier 免费版每月包含 100 次任务，足以应付大多数单步 Zap。

ConnectMachine 与 Zapier 只需连接一次。之后你搭建的每个 Zap 都可以复用同一个连接。

1. 1在 Zapier 中创建一个 Zap，然后搜索 ConnectMachine。
2. 2选择一个 ConnectMachine 触发器或动作，然后点击 登录。
3. 3ConnectMachine 会打开一个授权页面。用 Google 登录，或用发送到你邮箱的验证码登录。全程不会要求你输入密码。
4. 4确认你将授予的权限，然后点击 批准并继续。
5. 5Zapier 会返回 Zap 编辑器，你的 ConnectMachine 账号已连接完毕，可以开始使用。

你所批准的内容

触发器会在 ConnectMachine 中发生某件事时启动 Zap。动作则让其他应用把数据写入 ConnectMachine。

触发器

动作

本演练让 Google Sheets 与 ConnectMachine 保持同步。同样的模式适用于 Zapier 支持的任何应用。

需要灵感？ConnectMachine 的 Zapier 页面列出了适用于 Salesforce、HubSpot、Slack、Gmail 和 Airtable 的热门 Zap。想了解两条 CRM 路线的完整流程，包括各自所需的字段映射和查重规则，请看把名片扫描同步到 HubSpot 和把名片扫描同步到 Salesforce。

触发器提供的数据

每个触发器都会把完整的联系人记录交给 Zapier，因此下面这些字段你都可以映射到后续步骤。

动作接受的字段

“创建联系人”和“更新联系人”接受同一组字段。只需填写你想设置的那些。

校验规则

• 邮箱字段的值必须是有效的电子邮件地址。
• 网站、社交和地图链接必须以 http:// 或 https:// 开头。
• 纬度必须在 -90 到 90 之间。经度必须在 -180 到 180 之间。
• 空字段会被忽略。“更新联系人”不会因为字段留空而清除已有的值。
• 你选择的联系人和人脉圈必须属于已连接的 ConnectMachine 账号。

当一个 Zap 在 ConnectMachine 中创建或更新联系人时，这个变更和其他变更一样会触发“新增联系人”或“更新联系人”。如果同一个 Zap 又在监听这些触发器，它就可能不断触发自己，形成死循环。

每条触发记录都带有一个 Source 字段。由你自己的 Zap 造成的变更，来源值为 zapier，因此你可以把它们过滤掉。

只有会写回 ConnectMachine 的 Zap 才需要这一步。只把联系人发送到其他应用的 Zap 不可能形成循环。

大多数问题都出在连接、套餐或某个未通过校验的字段值上。请在下面找到你遇到的症状。

本参考文档列出了原生集成调用的每一个 ConnectMachine API 端点。它们都是生产环境的 HTTPS 端点；该集成不会调用沙箱、测试、预发布或开发环境的 API。

https://api.connectmachine.ai

认证与权限范围

该集成使用带 PKCE 的 OAuth 2.0 授权码流程。受保护的端点需要 Authorization: Bearer <access_token>。Zapier 会请求以下权限范围：user:read、contacts:read、contacts:write 和 webhooks:write。

{
  "access_token": "<access-token>",
  "refresh_token": "<refresh-token>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "user:read contacts:read contacts:write webhooks:write"
}

端点

联系人变更 JSON

“创建联系人”和“更新联系人”接受包含以下字段的 JSON。未知字段会被忽略。留空的值不会清除已有数据。

即时触发器投递

ConnectMachine 会向订阅的目标 URL 发送一次 HTTPS POST。创建和更新事件包含当前的联系人快照。删除事件包含 contact_ids，在可用时还会在 contacts 中包含删除前的快照。Zapier 会把每位联系人变成一条触发数据，其 Item ID 由事件 ID 和联系人 ID 组合而成。

{
  "event_id": "event_01",
  "occurred_at": "2026-08-04T12:00:00Z",
  "source": "app",
  "source_id": "contact_01",
  "data": {
    "event_type": "contacts.updated",
    "contacts": [{
      "id": "contact_01",
      "type": "person",
      "first_name": "John",
      "last_name": "Doe",
      "primary_email": "john.doe@example.com",
      "updated_at": "2026-08-04T12:00:00Z"
    }]
  }
}

错误

错误使用统一的 JSON 结构返回。429 响应还会带上 Retry-After 响应头。

{
  "error": "invalid_request",
  "error_description": "Invalid contact payload"
}