ConnectMachine 文档。

ConnectMachine 是一款由 AI 驱动的电子名片与联系人管理应用，专为那些有目的地拓展人脉、而不是盲目社交的人打造。你可以创建多张虚拟名片，几秒钟扫描纸质名片，并让你的专属 AI 助理记住你见过谁、在什么时候见的、以及为什么重要。

第一次使用 ConnectMachine？按照以下步骤设置你的账号，并建立第一个人脉连接。

1. 1下载应用：从 App Store 或 Google Play 下载，并用邮箱或手机号登录。
2. 2创建你的第一张名片：使用模板创建。AI 会自动补全你的信息，你也可以手动填写。
3. 3添加到 Apple Wallet／Google Wallet（iOS／Android），即可在锁屏界面一键取用。
4. 4分享你的名片：通过二维码、链接和社交媒体分享。对方无需安装应用。

关于电子名片的一切，都在 ConnectMachine 应用的名片页面里。创建名片、为不同受众定制名片、编辑信息、设置品牌形象以及分享，全都在同一个地方完成。

你的第一张名片会在引导设置过程中创建。之后你可以随时为不同场景添加更多名片。

1. 1打开名片页面：在 ConnectMachine 应用中打开。
2. 2点击“创建名片”，开始新建一张名片。你可以为不同场景创建多张名片。
3. 3填写你的信息：姓名、职位、公司、电话、邮箱、网站和社交主页链接。
4. 4选择名片主题，让它契合你的品牌或个人风格。
5. 5预览并保存。你的名片已经可以分享了。

一张名片足以应付日常使用，但大多数职场人都会从多张名片中受益。每张名片可以向不同的受众展示不同的信息。

• 分享合适的信息：投资路演用的名片不应该暴露你的私人号码。
• 保持品牌一致：各张名片使用同样的 logo、配色和公司名称，只改变展示的字段。
• 改一次，处处同步：编辑名片上已分享的信息后，此前所有分享出去的名片都会同步更新。

你可以在名片上添加自己的日程，展示空闲时间，方便联系人直接和你约会议。

1. 1打开名片页面，选择要添加日程的那张名片。
2. 2点击“编辑”，打开编辑界面来添加日程
3. 3点击“日程”字段，输入公开日程的 URL。
4. 4点击“保存”按钮，保存所做的修改。

名片品牌形象决定了你的电子名片的外观和气质。在名片页面里，你可以定制视觉元素，让名片与你的个人形象或公司形象保持一致。

1. 1打开名片页面，选择要设置品牌形象的那张名片。
2. 2点击“编辑”，打开该名片的品牌或设计选项。
3. 3更新头像、封面图、logo 或配色主题，使用编辑器中提供的选项进行修改。
4. 4预览名片，看看品牌形象在实时视图中的效果，以及这张名片在 CM 页面上的样子。
5. 5保存修改。更新会同步到你的名片链接、二维码和 Wallet 卡券上。

• 头像：使用高分辨率的 PNG、JPG 或 SVG。（建议 1:1 比例）
• 横幅图：选择一张宽幅图片，确保在手机和电脑上裁切后都好看。（建议 16:9 比例）
• Logo：使用高分辨率的 PNG、JPG 或 SVG，最好无背景或透明背景。
• 品牌色：挑选一个对比度足够的品牌色，让按钮和链接清晰可见。
• 一致性：在团队层面统一设置品牌形象，新成员加入后会自动继承。

ConnectMachine 提供了多种分享方式。挑一个适合当下场合的即可。收件人无需下载应用就能查看并保存你的信息。

1. 1打开名片，选择你想分享的那一张。
2. 2点击“分享”，选择二维码、链接、社交媒体、邮件、Apple Wallet 或 Google Wallet。
3. 3确认选中了正确的名片，如果你有多张名片的话。
4. 4让对方保存。他们只需一次点击，就能把你的信息添加到通讯录。

让你的名片始终触手可及。把 ConnectMachine 小组件添加到主屏幕，无需打开应用就能立刻分享你的信息。

1. 1在设备主屏幕上，打开小组件界面，添加 ConnectMachine 小组件。
2. 2在应用中打开任意一张名片，进入“分享你的名片”界面。
3. 3点击“把名片添加到主屏小组件”，把这张名片添加到主屏幕。
4. 4现在名片已经出现在小组件中，可以随时快速分享，直接从主屏幕操作即可。

把不常用的名片归档，让名片列表保持整洁；不再需要时也可以彻底删除。

删除名片 - 把一张名片从列表中永久移除。

1. 1打开该名片，进入“编辑名片”界面。
2. 2点击“删除名片”并确认。

归档名片 - 把一张名片从列表中临时归档。

1. 1打开该名片，进入“编辑名片”界面。
2. 2点击“归档名片”。名片会移入归档列表，你可以随时取消归档。
3. 3要查看已归档的名片，滚动到名片列表底部，点击“已归档名片”按钮。这里会显示你所有已归档的名片。
4. 4要恢复一张名片，从归档列表中打开它，点击“取消归档”，即可移回主列表。

收到一张纸质名片？对准相机，ConnectMachine 的 AI 会替你识别。姓名、职位、电话和邮箱都会被提取出来，保存为一条整洁的联系人记录。

1. 1打开扫描器：从底部导航栏进入，或在联系人页面点击 + 按钮手动添加联系人。
2. 2把相机对准名片并拍照。
3. 3核对提取出的字段，修正 AI 遗漏或识别有误的内容。
4. 4保存到你的人脉网络。这条联系人可被搜索，并可随时添加备注和跟进。

扫描对方的 LinkedIn 二维码，ConnectMachine 会立即把他们保存为联系人，并附上主页链接和补全的公开资料。

1. 1打开扫描器，把相机对准对方的 LinkedIn 二维码。
2. 2ConnectMachine 会把对方保存为一条新联系人，加入你的人脉网络。
3. 3这条联系人会包含指向其 LinkedIn 主页的链接，点击即可直接在 LinkedIn 中打开对方的主页。
4. 4ConnectMachine 会自动用公开可获取的数据补全这条联系人，所有信息都与 LinkedIn 主页一起存放在联系人里。

直接在 WhatsApp 里使用 ConnectMachine 添加联系人，无需打开应用。发一张名片、纸条或任意随手拍的照片，AI 会提取其中的信息并保存到你的 ConnectMachine 账号。

1. 1打开 WhatsApp，用这个号码与 ConnectMachine 开始对话：+1 (555) 748-0374。
2. 2发送一张照片：名片、纸条、活动胸牌，或任何带有联系方式的图片。
3. 3交给 AI 处理这张图片。ConnectMachine 会读取图中内容，并在应用里创建或更新对应的联系人。
4. 4打开 ConnectMachine 应用，在人脉网络中核对这条新联系人。

无论你的联系人现在存在哪里，只需点击几下就能导入 ConnectMachine。

如何从手机、Google 或文件导入联系人？

在联系人页面打开 ⋮（三点）菜单，选择“导入联系人”。你可以从以下来源导入：

• 手机通讯录，也就是设备自带的通讯录
• Google 账号，也就是你的 Gmail 联系人
• CSV／VCF 文件，你上传的联系人文件

导入时会带入哪些联系人字段？

ConnectMachine 会原样导入联系人的全部内容。如果导入的联系人包含 ConnectMachine 标准联系人表单之外的字段，这些额外字段也会被保留并显示在联系人上，你可以编辑或删除它们。

导入联系人时如何映射 CSV 的列？

导入 CSV 文件时，ConnectMachine 会显示一个字段映射界面，让你把文件中的列与对应的 ConnectMachine 字段一一匹配，确保所有信息都归位正确。

在同一个地方见了好几个人？ConnectMachine 会帮你把他们归在一起。当你在同一地点扫描超过两位联系人时，应用会自动弹出活动面板，方便你把他们分到一组。

1. 1照常扫描联系人。在同一地点扫描超过两次后，活动面板会自动出现。
2. 2添加一个活动（例如大会、聚会或饭局）。
3. 3你扫描的联系人会归到该活动下。
4. 4之后只要打开这个活动，就能快速找到在那里见过的所有人。

联系人进入你的人脉网络后，联系人详情页面提供了多种保持联络的方式。

什么是 NetSend 私密消息？

通过 ConnectMachine NetSend 给其他 ConnectMachine 用户发送文字消息。

1. 1打开某位联系人的详情。如果出现聊天图标，说明该联系人也在使用 ConnectMachine，可以使用 NetSend。
2. 2点击聊天图标，发送你的消息。
3. 3对方会在一个静默界面上看到你的消息。他们读完并退出聊天后，消息会自动删除。

把任意联系人以 vCard（VCF）文件的形式分享出去。

1. 1打开该联系人的详情，点击 ⋮（三点）菜单。
2. 2选择“分享联系人”。系统会打开手机自带的分享界面。
3. 3发送这个 vCard，可通过设备上任意应用或渠道发送。

直接从联系人详情页面联络对方。

1. 1打开该联系人的详情，点击 ⋮（三点）菜单。
2. 2选择通过短信或邮件跟进。ConnectMachine 会给出一条现成的模板消息。
3. 3按需修改模板后发送。只有当该联系人保存了手机号或邮箱时才可使用。

在联系人中向 Concierge 提问

一键唤起 ConnectMachine 的 AI 助理，并用现成的模板快速开始。

• 安排会议：与某位联系人约一次会议
• 引荐：起草一段介绍
• 分享联系人：把某位联系人的信息分享出去
• 随便问：发起一个开放式的请求

会议转录

把会议内容记录成转录笔记，并直接关联到对应的联系人。每位联系人的详情页面都有一个“转录”按钮。

1. 1打开该联系人的详情，点击“转录”。
2. 2如果还没有关联录音，ConnectMachine 会开始一段新录音并把它关联到这位联系人。
3. 3如果已经关联了录音，点击该按钮则会直接打开它。
4. 4无论哪种情况，你都会进入“笔记”页面，录音及其转录文本都保存在那里。

有时候，一段简短的语音备忘是记住一次谈话最省事的方式。保存联系人时，你可以附上一条语音笔记，帮你记起对方是谁、你们聊了什么。

1. 1保存联系人时，点击“添加语音笔记”。
2. 2录下你的笔记，任何有助于你记起这个人或这次谈话的内容都可以。
3. 3保存。语音笔记会附在联系人上，你随时打开都能听到。

快速找到人脉网络中的任何人——无论你记得的是姓名、公司，还是只记得在哪里见过。

如何向 AI 提问或搜索联系人？

在联系人页面顶部，有一个“问 AI 或搜索”栏。

• 点击该栏即可看到 AI 推荐的模板。选中一个后，会进入“提问”页面，模板已经准备好可以直接使用。
• 想搜索的话，直接输入即可。ConnectMachine 会搜索联系人的每一个字段：姓名、职位、公司、备注等等，因此你可以凭任何细节找到任何人。

如何给联系人列表排序？

点击“排序”，可按以下方式排列联系人列表：

• 按字母顺序，按姓名从 A 到 Z 排列
• 最近添加，最新的联系人排在前面
• 最近修改，最近更新过的排在前面

如何按行业或地区筛选联系人？

点击“筛选”，可按以下条件缩小列表范围：

• 行业
• 地区

ConnectMachine 会自动让你的列表远离重复项。它会检查重复的联系人，并每 24 小时重新检查一次，因此新出现的重复项也会被逐步发现。

1. 1发现可能重复的联系人时，联系人列表顶部会出现一条建议。
2. 2打开它，查看系统判定为重复的联系人。
3. 3合并它们，一次性全部合并，或逐条合并。
4. 4忽略它们，一次性全部忽略，或逐条忽略。

人脉圈可以把联系人整理成互相独立的分组，每个人脉圈都有自己专属的名片。下面介绍如何查看、排序和管理它们。

如何打开我的人脉圈？

以下两种方式都能打开人脉圈，结果是一样的：

• 点击联系人页面顶部的 ‹ 联系人 按钮，或者
• 长按某个人脉圈标签。
• 会出现两个选项：“重排人脉圈”，把人脉圈标签调整成你想要的顺序；“管理人脉圈”，打开人脉圈列表，其中每个人脉圈都会显示包含多少位联系人。

在人脉圈列表里可以做什么？

• 新建人脉圈：点击“添加”按钮。
• 长按某个人脉圈：可看到“重命名”“导出联系人”（仅当该人脉圈中有联系人时显示）和“删除人脉圈”。
• 在人脉圈上向右滑动：快速使用“导出联系人”（前提是该人脉圈中有联系人）。
• 在人脉圈上向左滑动：快速使用“删除”和“重命名”。

如何从人脉圈中导出联系人？

导出某个人脉圈的联系人时，该人脉圈中的所有联系人会以邮件形式发送到你账号绑定的邮箱地址。

如何把联系人移到其他人脉圈？

• 单个联系人（滑动）：在联系人上向右滑动，点击“更改人脉圈”。
• 单个联系人（详情页）：打开该联系人，在详情页里更新它所属的人脉圈。
• 批量更新：长按某个人脉圈，选中多位联系人，一次点击即可全部更新。

把 ConnectMachine 中的所有联系人导出为一个 CSV 文件。该文件会发送到你账号注册时使用的邮箱，因此你可以在手机、电脑上打开，或导入其他应用。

1. 1在底部菜单栏中，点击三点图标。
2. 2从菜单进入“设置”。
3. 3点击“导出联系人”开始导出。
4. 4导出完成后，查看你注册的邮箱，CSV 文件就在那里。

• CSV 格式：文件以标准格式保存你的联系人信息，可以用表格软件或 CRM 工具打开。
• 仅发送到注册邮箱：出于安全考虑，ConnectMachine 只会把导出文件发送到与你账号绑定的邮箱地址。
• 完整导出：保存在 ConnectMachine 中的所有联系人都会包含在文件里。

它是懂你人脉的专属 AI 助理。用日常语言提问，回忆你在哪里见过谁，并直接触发安排会议、分享等操作，不用手动翻找联系人列表。

如何开始使用 AI Concierge？

打开“向 Concierge 提问”，从现成的模板开始，或者直接用日常语言输入你的需求：

• 安排会议：与某位联系人约一次会议
• 引荐：起草一段介绍
• 分享联系人：把某位联系人的信息分享出去
• 随便问：发起一个开放式的请求

AI Concierge 如何处理会议和日历？

请先连接你的日历账号。目前支持 Google Calendar 和 Outlook。连接完成后，AI Concierge 就可以：

• 预约一场会议
• 查看你已安排的会议
• 修改某场会议
• 接受或谢绝会议邀请，并回复出席确认

如何用 AI Concierge 起草引荐信？

把任意两个人互相引荐。AI Concierge 会起草一封引荐邮件，你可以修改后发送。

AI Concierge 如何管理联系人、名片和人脉圈？

• 创建新联系人，以及更新已有联系人
• 创建名片或人脉圈，并对它们进行更新
• 把某位联系人分享给别人

如何用 AI Concierge 设置提醒？

• 为任意日期和时间设置提醒，并指定标题。
• 在 iOS 上，提醒会添加到“提醒事项”应用；在 Android 上，则会添加到 Google Calendar。

如何用 AI Concierge 探索我的人脉网络？

• 按行业、职务、地区、技能、备注等条件搜索联系人
• 按行业拆分统计你的联系人
• 按见面地点找人，例如某场具体的活动
• 用日常语言询问任何一位联系人的情况

录下你的会议，把整理工作交给 ConnectMachine。停止录音后，AI Notetaker 会处理音频，生成一份清晰的摘要和完整的转录文本，随时可以分享。

如何录制并处理一场会议？

1. 1会议开始时开始录音。
2. 2会议结束后，停止录音。
3. 3AI Notetaker 会处理这段音频，生成摘要和转录文本。

如何分享 AI Notetaker 生成的笔记？

处理完成后，你可以：

• 复制摘要或转录文本，发送给任何人；或者
• 直接分享笔记的链接。

AI Notetaker 的发言人识别是怎么工作的？

• 在转录文本中，你可以选中或取消选中发言人。
• 当你选中一位已经在你人脉网络中的发言人时，AI Notetaker 会把他与对应的联系人关联起来，让会议笔记始终对应到正确的人。

管理员品牌管控让团队管理员为每位成员的电子名片应用统一的视觉风格。名片不再使用 ConnectMachine 的默认样式，而是在名片本身以及分享出去的名片链接上展示贵公司的 logo、横幅图和品牌色。

团队管理员可以定制哪些内容？

品牌管控涵盖名片和分享出去的资料页上呈现的视觉形象。

如何设置团队品牌形象？

在管理后台配置一次即可，更新会推送给整个团队。

1. 1在 ConnectMachine 中打开团队管理员设置。
2. 2在团队工作区下进入“品牌管控”。
3. 3上传公司 logo 和横幅图或封面图。
4. 4设置品牌色并填写公司信息。
5. 5保存并预览一张成员名片，确认最终效果。

团队品牌形象有哪些实用建议？

• Logo：使用高分辨率的 PNG、JPG、GIF、WEBP 或 SVG，最好无背景或透明背景。
• 封面图（横幅）：选择一张宽幅图片，确保在手机和电脑上裁切后都好看。（建议 16:9 比例）
• 一致性：在团队层面统一设置品牌形象，新成员加入后会自动继承。
• 可修改性：团队成员可以在自己的名片上自定义主题色、封面图、头像和 logo

自定义域名配置让你把公开资料页和分享出去的名片链接托管在自己拥有的域名上，例如 card.yourcompany.com。访客在地址栏看到的是你的品牌，而不是默认的 ConnectMachine 链接。

自定义域名能带来什么？

自定义域名让你的名片链接更专业，也完全契合你的品牌。

如何设置自定义域名？

添加好 DNS 记录后，大多数配置几分钟内就能完成。

1. 1在 ConnectMachine 中打开域名设置。
2. 2输入你的域名，例如 card.yourcompany.com。
3. 3复制设置流程中显示的 DNS 记录。
4. 4在你的 DNS 服务商或注册商处添加这些记录。
5. 5等 ConnectMachine 确认域名和 SSL 均已生效后，完成验证并正式启用。

如何分享使用自定义域名的名片？

在 ConnectMachine 中设置好自定义域名后，你的名片会有一个可直接分享的专属链接。一个常见错误是只分享域名主地址（例如 https://connect.yourdomain.com）。主地址本身不包含名片的唯一令牌，因此打不开任何名片，还会提示“分享链接无效”。

1. 1打开 ConnectMachine 应用。
2. 2进入“分享你的名片”页面。
3. 3复制那里显示的名片链接。
4. 4这就是可以直接分享的链接。

• 错误（只有主地址）： https://connect.yourdomain.com
• 正确（带名片令牌）： https://connect.yourdomain.com/abc123

如何为自定义域名配置 DNS？

ConnectMachine 会在设置过程中给出准确的记录值。大多数配置使用指向我们服务器的 CNAME 或 A 记录。

自定义域名有哪些实用建议？

• 子域名：如果你的主域名已经用于其他网站，请使用 card. 或 me. 这样的子域名。
• 生效时间：DNS 变更最长可能需要 48 小时才能全网生效，不过很多服务商几分钟内就会更新。
• SSL：请等验证完成后，再对外公开新的 URL。
• 团队推广：验证通过后，分享出去的名片链接会自动使用你的自定义域名。

订阅联系人事件后，只要有事件触发，ConnectMachine 就会向你的 HTTPS 端点发送一个 JSON POST 请求。投递是异步的，遇到临时性故障会自动重试。

支持哪些 webhook 事件？

三种事件类型覆盖了联系人的完整生命周期。

如何创建一个 webhook？

1. 1在 ConnectMachine 中打开 webhook 设置。
2. 2把你的 HTTPS 端点填为目标 URL。
3. 3选择要订阅的事件。
4. 4保存，然后用应用内的测试工具发送一个测试事件。
5. 5查看投递日志，确认状态和耗时。

如何发送一个测试 webhook 事件？

在 webhook 设置中发送一个示例 contacts.* 投递，验证你的端点能接收该负载并返回 2xx。你的 URL 必须是 HTTPS、可公网访问，并在 10 秒内响应。

webhook 投递是怎么工作的？

每次投递都是一个带有下列请求头的 JSON POST。临时性失败会自动重试，日志中会显示结果。

1. 1成功 — 任何 2xx 响应都会把该次投递标记为已送达。
2. 2重试 — 网络错误、超时以及 408 / 425 / 429 / 5xx 会被重试。
3. 3失败 — 其余大多数 3xx / 4xx 响应会被视为永久性失败。

• 超时：10 秒。
• 重试次数：最多 3 次，间隔 6 分钟（总共 4 次尝试）。
• 日志：包含 status、status_code、耗时，以及最多 4096 字节的响应体。

webhook 负载是什么格式？

创建和更新事件共用同一个信封结构，其中包裹着一个或多个联系人对象。删除事件只携带 ID。

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "source": "contact_import",
  "source_id": "import_id",
  "batch": { "index": 1, "count": 100, "max_size": 100 },
  "data": {
    "event_type": "contacts.created",
    "contacts": []
  }
}

下面是一个完整的 contacts.created 投递示例，旁边附有联系人字段说明。

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "source": "contact_import",
  "source_id": "import_id",
  "batch": { "index": 1, "count": 100, "max_size": 100 },
  "data": {
    "event_type": "contacts.created",
    "contacts": [
      {
        "id": "contact_id",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Example Corp",
        "job_title": "Product Manager",
        "label": "Work",
        "notes": "Met at event",
        "primary_email": "john.doe@example.com",
        "primary_phone": "+15550101010",
        "emails": [{ "label": "Work", "value": "john.doe@example.com" }],
        "phones": [{ "label": "Mobile", "value": "+15550101010" }],
        "websites": [{ "label": "Company", "value": "https://example.com" }],
        "socials": [
          { "linkedin_url": "https://linkedin.com/in/john-doe" },
          { "github_url": "https://github.com/john-doe" }
        ],
        "custom": [{ "label": "CRM Owner", "value": "Sales" }],
        "address": {
          "formatted": "123 Market Street, San Francisco, CA, USA, 94105",
          "raw": {}
        },
        "where_we_met": {
          "formatted": "Moscone Center, San Francisco, CA, USA",
          "raw": {}
        },
        "tags": [{ "name": "Conference", "type": "event" }],
        "notetaker_sessions": [
          {
            "session_id": "session_id",
            "title": "Meeting note",
            "summary_url": "https://...",
            "audio_url": "https://...",
            "created_at": "2026-05-15T10:00:00Z",
            "updated_at": "2026-05-15T10:05:00Z"
          }
        ],
        "created_at": "2026-05-15T10:00:00Z",
        "updated_at": "2026-05-15T10:05:00Z"
      }
    ]
  }
}

信封结构相同，只是把 contacts 换成了 contact_ids。

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "source": "manual",
  "source_id": "source_id",
  "data": {
    "event_type": "contacts.deleted",
    "contact_ids": ["contact_id"]
  }
}

webhook 有哪些最佳实践和排查建议？

• 尽快返回 2xx：先确认收到，再把耗时的处理放到后台队列。
• 保证幂等：事件可能被重复投递，请以 X-ConnectMachine-Delivery-ID 作为去重依据。
• 容忍可选字段缺失：并非每位联系人都拥有全部字段。
• 记录 event_type 和 delivery_id，便于追溯。
• 让响应体保持精简：日志中的响应体会被截断到 4096 字节。

在 Zapier 中自动化联系人流程，把 ConnectMachine 的事件发送到 Salesforce、HubSpot、Zoho、Pipedrive，或任何其他 Zapier 支持的 CRM。

本指南能帮你搭建什么

一条 Zapier 自动化流程：ConnectMachine 把联系人事件发送到 Zapier 的 webhook，Zapier 读取事件负载，然后你指定的 CRM 自动创建、更新或处理这位联系人。

开始之前

• 一个已订阅、且可使用 webhook 集成的 ConnectMachine 账号。
• 一个 Zapier 账号。
• 你要更新的那个 CRM 的访问权限，比如 Salesforce、HubSpot、Zoho 或 Pipedrive。
• 明确该由哪个事件触发这条流程：创建联系人、更新联系人，还是删除联系人。

端到端流程

1. 1在 Zapier 中新建一个 Zap。
2. 2触发器选择 Webhooks by Zapier，事件选择 Catch Hook。
3. 3复制 Zapier 提供的 webhook URL。
4. 4把该 URL 粘贴到 ConnectMachine 的“设置 > Webhook 集成”中。
5. 5启用你希望 Zapier 接收的一个或多个 ConnectMachine 事件。
6. 6从 ConnectMachine 触发一个测试事件，确认 Zapier 能收到。
7. 7可选：添加一个 Zapier Filter，让该 Zap 只对某一种事件类型继续执行。
8. 8选择 CRM 动作，从 webhook 负载中映射字段，测试该动作，然后发布这个 Zap。

第 1 步：在 ConnectMachine 中打开 Webhook 集成

在 ConnectMachine 应用中打开“设置”，在“集成”下点击“Webhook 集成”。

第 2 步：在 Zapier 中创建 Webhook 触发器

在 Zapier 中新建一个 Zap。触发器应用选择 Webhooks by Zapier，触发事件选择 Catch Hook。这样 Zapier 就会生成一个专属 URL，用来接收来自 ConnectMachine 的事件。

第 3 步：复制 Zapier 的 Webhook URL

配置好 Catch Hook 触发器后，Zapier 会显示一个 webhook URL。复制这个 URL。请把它当作私密端点对待，因为任何拿到该 URL 的人都能向这个 Zap 发送数据。

第 4 步：在 ConnectMachine 中填入端点 URL

把 Zapier 的 webhook URL 粘贴到 ConnectMachine 的“端点 URL”字段中。打开“Webhook 集成”开关，然后启用你想发送的事件。

• 创建联系人：新增联系人时发送 contacts.created。
• 更新联系人：联系人信息变化时发送 contacts.updated。
• 删除联系人：联系人被移除时发送 contacts.deleted。

第 5 步：向 Zapier 发送一个测试事件

保存 URL 并启用某个事件后，在 ConnectMachine 中创建、更新或删除一位联系人，以产生一个 webhook 事件。回到 Zapier，使用 Test trigger 或 Find new records。选中 Zapier 找到的那条请求，然后继续。

第 6 步：把子键设置为 data

在 Catch Hook 配置中，把 Pick off a Child Key 设置为 data。这会让 Zapier 使用事件主体，也就是 ConnectMachine 发送 event_type、contacts 和 contact_ids 的地方。

第 7 步：按事件类型过滤

如果同一个 Zapier hook 会收到多种事件类型，请在 CRM 动作之前加入 Filter by Zapier。把过滤条件配置为 Event Type 完全匹配该 Zap 应处理的那个事件。

• 对于创建流程，过滤条件设为 Event Type 完全匹配 contacts.created。
• 对于更新流程，过滤条件设为 Event Type 完全匹配 contacts.updated。
• 对于删除流程，过滤条件设为 Event Type 完全匹配 contacts.deleted。

第 8 步：选择你的 CRM 动作

把你要更新的 CRM 添加为 Zap 的下一步。示例截图使用 Salesforce，但同样的模式适用于任何 Zapier 支持的 CRM。

选择与你的流程相匹配的 CRM 动作。例如，对于 contacts.created 的 Zap，就选择 创建联系人。当 Zapier 要求授权时，连接你的 CRM 账号。

第 9 步：把 ConnectMachine 字段映射到 CRM 字段

在 CRM 动作的设置中，用 Zapier 的字段选择器把 webhook 负载里的值映射到 CRM 字段。对于普通的创建／更新事件，联系人字段位于 Contacts [0] 之下。

• 把 First Name 映射到 Contacts [0] > First Name。
• 把 Last Name 映射到 Contacts [0] > Last Name。
• 把 Email 映射到 Contacts [0] > Primary Email，或映射到 Contacts [0] > Emails [0] > Value。
• 把 Phone 映射到 Contacts [0] > Primary Phone，或映射到 Contacts [0] > Phones [0] > Value。
• 社交主页 URL 可以直接按键名映射，例如 linkedin_url 或 github_url。

第 10 步：测试并发布

用 Zapier 的 Test 步骤把示例联系人发送到你的 CRM。确认 CRM 中的记录无误后，发布这个 Zap。

在 ConnectMachine 中监控投递情况

ConnectMachine 会展示最近的 webhook 投递记录，包括状态码、尝试次数、请求负载和响应体。返回 200 表示 Zapier 已接收该事件。投递失败时应查看响应体排查原因，修复端点问题后再重试。

负载参考

ConnectMachine 会向 Zapier 的 URL 发送 JSON。事件名称位于 data.event_type 中。创建和更新事件包含 data.contacts，删除事件包含 data.contact_ids。

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "data": {
    "event_type": "contacts.created",
    "contacts": [
      {
        "id": "uuid-1234",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Acme Corp",
        "primary_email": "jondoe@mail.com",
        "primary_phone": "+14155550123",
        "emails": [{ "label": "Work", "value": "johndoe@example.com" }],
        "phones": [{ "label": "Mobile", "value": "+14155550123" }],
        "socials": [
          { "github_url": "https://github.com/johndoe" },
          { "linkedin_url": "https://linkedin.com/in/johndoe" }
        ],
        "created_at": "2026-05-15T10:00:00Z",
        "updated_at": "2026-05-15T10:05:00Z"
      }
    ]
  }
}

删除事件采用这样的结构：

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "data": {
    "event_type": "contacts.deleted",
    "contact_ids": ["contact_id1", "contact_id2"]
  }
}

推荐的 Zap 模式

问题排查

• Zapier 找不到测试数据：确认 ConnectMachine 中的端点 URL 与 Zapier 的 hook URL 完全一致、集成已开启，且至少启用了一个事件。然后再创建、更新或删除一位联系人。
• 在 Zapier 中很难映射字段：把 Catch Hook 的子键设为 data，然后重新测试触发器。
• 错误的事件进入了 CRM 动作：添加一个 Filter by Zapier 步骤，并让 event_type 完全匹配。
• CRM 中只出现了一位导入的联系人：导入事件可能包含多位联系人；如果想处理全部联系人，请使用 Looping by Zapier 或 CRM 的批量动作。
• Zapier 收到了事件但 CRM 动作失败：查看该 CRM 动作的测试结果，以及 ConnectMachine“最近事件”中的响应体。
• 社交主页 URL 难以映射：请使用平台专属的键名，例如 linkedin_url、github_url、twitter_url、facebook_url、youtube_url 或 instagram_url。

安全与维护

• 妥善保管 Zapier 的 webhook URL，不要外泄。
• 只使用 HTTPS 的 webhook URL。
• 若希望某个 Zap 不再接收事件，请在 ConnectMachine 中停用对应事件。
• 如果更换了 Zapier 的 hook URL，请同步更新 ConnectMachine 中的端点 URL。
• 发布后查看“最近事件”，确认线上事件确实成功送达 Zapier。
• 在集成的 CRM 或工作流中确认数据显示正确。

ConnectMachine 提供一个远程 MCP 服务器，因此任何支持 Model Context Protocol 的工具都能通过普通对话读取和更新你的联系人、活动、人脉圈和电子名片。无需安装任何东西：你的工具用你的个人密钥通过 HTTPS 连接即可。

本指南能帮你搭建什么

在你的 AI 工具和 ConnectMachine 账号之间建立一条可用的连接，这样你就能让它查找某位联系人、补上你们相识的活动，或更新一张电子名片，而不必离开你正在使用的工具。

开始之前

• 一个 ConnectMachine 账号。
• 一款支持远程 MCP 服务器的 AI 工具，例如 Claude、Claude Code、Cursor、VS Code、Zed、Windsurf 或 Cody。
• 你的个人 MCP 密钥，可在下一步的连接页面获取。

端到端流程

1. 1打开 MCP 连接页面，用你的 ConnectMachine 账号邮箱或 Google 登录。
2. 2复制你的 MCP 密钥。
3. 3粘贴适用于你所用工具的配置，并把 YOUR_MCP_KEY 替换成你的密钥。
4. 4重启该工具，确认 ConnectMachine 出现在它的 MCP 服务器列表中。
5. 5向助理提一个关于你人脉的问题，验证连接是否正常。

第 1 步：获取你的 MCP 密钥

该密钥是与你 ConnectMachine 账号绑定的个人 bearer 令牌。打开 licenses.connectmachine.ai/mcp/auth，用账号邮箱（一次性验证码）或 Google 登录。页面会显示你的密钥，并附上适用于主流工具的现成配置片段。请务必保密：任何持有它的一方都能以你的身份操作账号。

第 2 步：连接 Claude

在网页版和桌面版 Claude 中，打开设置，然后进入连接器，选择添加自定义连接器，粘贴服务器 URL https://mcp.connectmachine.ai/mcp。无需任何文件：Claude 会替你完成登录流程。对于 Claude Code，请在项目根目录创建 .mcp.json，填入下面的片段，然后重启 Claude Code。

{
  "mcpServers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_KEY" }
    }
  }
}

第 3 步：连接 Cursor

Cursor 会从 ~/.cursor/mcp.json 读取适用于所有项目的 MCP 服务器，也会从单个项目内的 .cursor/mcp.json 读取。添加下面的片段，然后打开设置，确认 ConnectMachine 已列出并处于启用状态。

{
  "mcpServers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_KEY" }
    }
  }
}

第 4 步：连接 VS Code

VS Code 使用 servers 对象而不是 mcpServers，并且每一项都要声明自己的传输类型。把下面的片段放进 .vscode/mcp.json，然后从 Copilot Chat 的 MCP 面板启动该服务器。

{
  "servers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_KEY" }
    }
  }
}

第 5 步：连接 Zed

Zed 把 MCP 服务器称作 context servers，并且在 settings.json 中直接支持远程服务器。如果不配置 Authorization 请求头，Zed 会在首次连接时走标准的 MCP 登录流程，因此只填 URL 就够了。

{
  "context_servers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp"
    }
  }
}

你可以问些什么

该服务器提供 40 个功能明确的工具，覆盖联系人、活动、人脉圈、电子名片、导入导出以及你的个人资料。助理会为每个请求自动挑选合适的工具，你完全不用自己指定工具名。

• 找出我去年在 Web Summit 上认识的联系人。
• 列出我人脉里在金融科技行业工作的创始人。
• 给 Priya 添加一个电话号码，并打上我们相识的那场活动的标签。
• 更新我销售名片上的职位。

完整的 MCP 参考文档，包括每个工具领域以及适用的 Premium 规则，都在 MCP 服务器指南中。

无需复制 webhook URL，就能搭建即时、双向的联系人流程。连接一次，选好触发器或动作，映射字段，然后发布你的 Zap。

端到端流程

1. 1在 Zapier 中选择 ConnectMachine，用 Google 或邮箱验证码登录一次。
2. 2在授权页面上确认并批准所列的权限。
3. 3选择一个触发器（New、Updated 或 删除联系人）或一个动作（Create 或 更新联系人）。
4. 4测试该步骤，让 Zapier 拉取一条真实样本数据，这样你就能看到负载中的字段。
5. 5映射你需要的字段，然后发布这个 Zap。

触发器与动作

该集成包含五个可见的操作。

• 新增联系人 触发器 — 在 contacts.created 时运行。
• 更新联系人 触发器 — 在 contacts.updated 时运行。
• 删除联系人 触发器 — 在 contacts.deleted 时运行，并附带删除前抓取的联系人快照。
• 创建联系人 动作 — 创建个人联系人或企业联系人。
• 更新联系人 动作 — 更新一位已有联系人，可从下拉列表中选择，也可映射一个自定义 ID。

连接你的账号

在 Zapier 中选择 ConnectMachine，点击 Sign in。使用 Google 或邮箱验证码批准访问。只有已完成引导设置的现有 ConnectMachine 账号才能连接。如果授权被撤销，或刷新令牌的安全检查关闭了连接，请在 Zapier 中重新连接。

创建联系人 的字段

先选择个人或企业，然后映射名字、姓氏、公司、职位、备注、可选的人脉圈、主邮箱、主电话和网站。

• 个人联系人必须填写名字。
• 企业联系人必须填写公司。
• 邮箱和网站的取值会经过校验。
• 如果人脉圈留空，ConnectMachine 会使用你的默认人脉圈。

更新联系人 的字段

联系人 ID 为必填。可以从下拉列表中选择一位最近的联系人，或选择 Custom 以映射来自前一个 Zap 步骤的 ID。只映射你想修改的字段即可。

• 在 v1 中，留空或省略的值不会清除已有数据。
• 主邮箱、主电话和网站会更新当前的主值，若不存在则新建一个。
• 所选的联系人和人脉圈必须属于已连接的那个账号。

避免 Zap 递归触发

由 ConnectMachine 动作产生的变更同样会触发常规的 新增联系人 或 更新联系人 触发器。它们的输出中会包含 source=zapier，以及对应连接授权的 source_id。

已删除的联系人

删除单条联系人、批量删除、全部删除或合并联系人，都可能触发 删除联系人 触发器。每删除一位联系人，Zapier 就会收到一条数据，其中包含 deleted_at 以及删除前的各个字段。而较早的手动 webhook 集成在删除事件中仍然只返回 ID。

隐私与权限

Zapier 会存储你这条连接的 OAuth 凭据。ConnectMachine 只存储访问令牌的标识符和经过哈希处理的刷新令牌。授权页面绝不会把这两种令牌存入浏览器存储。

• user:read 用于为该连接添加标识。
• contacts:read 支撑触发器、样本数据和下拉列表。
• contacts:write 允许执行 创建联系人 和 更新联系人。
• webhooks:write 让 Zapier 只能管理它自己创建的触发器订阅。

开发者参考

OAuth 使用带 S256 PKCE 的授权码流程，并支持自动刷新。原生订阅使用 POST /api/v1/zapier/subscriptions 和 DELETE /api/v1/zapier/subscriptions/:id。触发器样本使用 GET /api/v1/zapier/trigger-samples。动作使用 POST /api/v1/zapier/contacts 和 PATCH /api/v1/zapier/contacts/:id。

问题排查

出现 Premium 相关提示，说明该账号已不再拥有符合条件的套餐。出现权限相关提示，说明该 Zap 需要重新连接并批准所申请的权限范围。如果 Zapier 返回 410 Gone 后触发器停止工作，请重新打开这个 Zap，让 Zapier 创建一个新的订阅。若反复出现认证错误，请在 Zapier 中移除该连接后重新连接。

把 ConnectMachine 推荐给朋友和人脉，即可获得奖励，并延长自己的订阅时长。分享你的专属链接，还能追踪有多少人通过它注册或订阅。

1. 1在底部菜单栏中，点击三点图标。
2. 2从菜单进入“设置”。
3. 3点击“邀请好友”，打开推荐相关的选项。
4. 4复制你的推荐链接手动分享，或直接通过社交媒体、即时通讯、邮件等应用分享。
5. 5点击“查看推荐记录”，看看有多少人用你的链接注册，又有多少人购买了订阅。