sales-integration

连接销售工具

帮助用户设计和实现销售工具之间的集成——从选择合适的集成方式，到设计触发器和操作、映射字段以及处理错误。本技能涵盖 Webhook、Zapier/Make、原生集成和自定义 API 流水线。

步骤 1 — 收集背景信息

如果 references/learnings.md 存在，请先阅读，了解积累的经验。

询问用户：

1. 要连接哪些工具？

   • 源工具（事件发生的位置）：Mailshake、Apollo、Salesloft、Smartlead、Lemlist、Yesware、Groove.cm、Mixmax、Reply.io、Woodpecker、Hunter.io、Seismic、Tomba、Prospeo、Seamless.AI、SafetyMails、Closum、Omnisend、Mailchimp、SendGrid、Postmark、Customer.io、Mailgun、Klaviyo、ActiveCampaign、Outscraper、Enrich.so、Minelead、Lobstr.io、GetProspect、Skrapp、OpenWeb Ninja、Anymail Finder、ZeroBounce、Snov.io、LeadMagic、ZoomInfo、Clearbit、RB2B、6sense、Brevo、Braze、Iterable、GetResponse、SendPulse、Clay、HubSpot、Salesforce、Qwilr、RudderStack、Boomi、Workato、Celigo、SnapLogic、Jitterbit、Tray、Informatica、TIBCO、其他
   • 目标工具（要执行操作的位置）：Salesforce、HubSpot、Slack、Pipedrive、其他
   • 这是单向集成还是双向集成？

2. 什么事件应触发集成？

   • A) 收到邮件回复
   • B) 捕获新潜在客户
   • C) 已预约会议
   • D) 商机阶段发生变化
   • E) 创建/更新联系人
   • F) 序列/节奏执行完毕
   • G) 提交表单
   • H) 自定义事件——请描述

3. 触发后应执行什么操作？

   • A) 创建记录（联系人、任务、商机、活动）
   • B) 更新记录（字段变更、阶段变更、负责人变更）
   • C) 发送通知（Slack、电子邮件、短信）
   • D) 加入序列/节奏
   • E) 多项操作——请描述

4. 你对技术的熟悉程度如何？

   • A) 无代码——仅使用 Zapier、Make、原生集成
   • B) 低代码——能进行基本的 API 调用，可以参照文档操作
   • C) 编码——能通过 API 和 Webhook 构建自定义集成

5. 你当前使用哪些技术工具？（列出正在使用的所有销售/营销/CRM 工具）

如果用户的请求已提供大部分背景信息，请直接进入相关步骤。 基于合理假设（明确说明这些假设），先给出尽力而为的答复，然后只在结尾询问 1–2 个最关键的澄清问题——不要因为背景信息不完整而推迟答复。

步骤 2 — 集成架构

根据复杂程度和技术要求，选择合适的集成方式。

决策矩阵

方式	最适合	技术水平	成本	可靠性
原生集成	CRM 同步、内置连接器	无需技术能力	免费（已包含）	高
Zapier / Make	多步骤工作流、无代码	低	$20-100/mo	高
Webhook + 处理程序	实时事件、自定义逻辑	中	免费至低	中高
自定义 API 流水线	复杂转换、高流量	高	不定	取决于实现

原生集成——始终优先检查

在构建任何自定义方案之前，先检查是否存在原生集成：

如需查看所有受支持工具之间 240 多种原生集成的完整查询表，请参阅 references/integrations.md。

规则：如果原生集成能满足你的使用需求，就使用它。原生集成会自动处理身份验证、重试和错误处理。只有在原生集成不支持特定触发器或操作时，才采用自定义方案。

步骤 3 — 常见集成模式

线索／回复 → CRM 记录 + 通知

触发条件：在 Mailshake/Apollo/Salesloft 中收到回复 操作：

1. 在 CRM 中创建或更新联系人
2. 在联系人记录中创建活动／任务
3. 向销售代表发送 Slack 通知

实现选项：

• Zapier：触发器 = Mailshake“Reply Received” → 操作 = Salesforce“Create Task” + Slack“Send Message”
• Webhook：Mailshake 推送事件（Reply）→ 你的端点 → Salesforce API + Slack API
• 原生集成：Mailshake-Salesforce 集成（自动将回复同步为活动）

会议已预约 → CRM + 退出序列

触发条件：已预约会议（Calendly、Chili Piper 或 CRM 日程安排工具） 操作：

1. 在 CRM 中更新联系人状态／阶段
2. 将联系人从活动序列／跟进节奏中移除
3. 创建交易／销售机会
4. 通知 AE

CRM 状态变更 → 加入序列

触发条件：CRM 中的线索状态变更为“MQL” 操作：

1. 将联系人加入外呼序列（Apollo、Salesloft、Mailshake）
2. 根据路由规则分配给相应的销售代表

实现选项：

• Zapier/Make（无代码）：HubSpot“Lifecycle Stage Change”触发器 → Apollo“Add Contact to Sequence”操作。设置最简单，可自动处理身份验证。
• CRM webhook + 自定义 API（低代码）：HubSpot 工作流触发 webhook → 你的端点调用 Apollo POST /contacts/add_to_emailer_campaign。可更灵活地控制字段映射、错误处理和条件逻辑。
• CRM 原生工作流（若支持）：部分 CRM 与客户互动工具的集成原生支持加入序列触发器；构建自定义方案前，请先检查 Settings > Integrations。

序列加入的错误处理：

• 联系人重复：创建联系人前，检查客户互动工具中是否已存在该联系人；使用“查找或创建”逻辑
• 已加入序列：如果联系人正处于其他序列中，API 可能会拒绝加入请求；请妥善处理（记录日志、跳过或排入队列稍后处理）
• 序列容量／加入上限：序列可能设有最大加入人数或每日添加上限。监控 API 响应中的上限错误，并为超出上限的请求设置重试队列。
• 重新资格认定：如果之前被取消资格的线索再次达到 MQL 标准，请决定是重新加入序列还是跳过（避免向同一联系人重复发送消息）

交易阶段变更 → 利益相关方通知

触发条件：CRM 中的交易进入“Proposal Sent”或“Negotiation”阶段 操作：

1. 在 Slack 中通知相关利益相关方
2. 为销售代表创建跟进任务
3. 在 Qwilr 中触发方案创建（参见 /sales-qwilr-automation）

多工具活动同步

触发条件：在客户互动工具中记录任何活动（发送邮件、拨打电话、举行会议） 操作：将活动同步到 CRM，作为已完成的任务／活动

关键注意事项：

• 确定同步方向（单向或双向）
• 在工具之间映射字段（Salesloft“Call” → Salesforce“Task”，类型为“Call”）
• 处理重复项（创建前检查该活动是否已存在）

第 4 步 — 平台 webhook 参考

有关特定平台的 webhook 配置、API 集成和原生连接器详情，请参阅 references/platforms.md。

第 5 步 — 数据同步最佳实践

确定事实来源

在构建任何双向同步之前，请先确定每个字段由哪个工具作为事实来源：

数据类型	典型事实来源	原因
联系人信息（姓名、邮箱、电话）	CRM（Salesforce/HubSpot）	CRM 是规范记录
活动数据（邮件、电话）	客户互动工具（Apollo/Salesloft/Mailshake）	活动始于客户互动工具
交易／销售机会	CRM	营收数据存储在 CRM 中
线索评分	MAP 或 CRM	评分逻辑在 MAP/CRM 中运行
序列状态	客户互动工具	序列状态由客户互动工具管理

冲突解决

• 以后写入为准：简单但有风险——后续更新会覆盖较早的更新
• 以事实来源为准：指定的数据源始终覆盖目标端
• 字段级规则：每个字段采用不同规则（例如，电话号码以 CRM 为准，邮件状态以互动工具为准）
• 人工审核：标记冲突，交由人工审核（对关键字段来说最安全）

去重

• 匹配键：电子邮件地址（主要），公司域名 + 名称（次要）
• 何时去重：创建记录前、同步期间，以及定期维护时
• 工具：CRM 原生去重功能（Salesforce Duplicate Rules、HubSpot 去重工具），或第三方工具（Dedupely、RingLead）

错误处理

• 重试逻辑：为失败的 API 调用实现指数退避（1 秒、2 秒、4 秒、8 秒）
• 死信队列：存储失败事件，供人工审核和重放
• 告警：同步错误超过阈值时发送 Slack/电子邮件通知
• 监控：每周跟踪同步成功率、延迟和错误类型

注意事项

• 先检查原生集成。 不要为工具本身已支持的功能构建 Zapier 工作流。原生集成更可靠，能更好地处理边缘情况，而且不产生额外费用。自定义集成前，先检查两款工具中的 Settings > Integrations。

• 遵守 API 速率限制。 每款工具都有速率限制——Mailshake（100 次/分钟）、Apollo（付费方案约 200 次/分钟）、Salesforce（因情况而异）、HubSpot（Free/Starter 每 10 秒 100 次请求，Pro/Enterprise 每 10 秒 190 次请求；市场 OAuth 应用每个已安装账户每 10 秒 110 次请求；此外还有每日上限：Free/Starter 250K、Pro 625K、Enterprise 1M）。忽视速率限制的高容量同步会受到限流或被阻止。务必实现批处理和退避。

• 双向同步前先定义事实来源。 缺少明确字段级归属的双向同步会造成数据来回更新（A 更新 B，B 更新 A，形成循环）。对于每个双向同步的字段，都要记录发生冲突时以哪款工具为准。

• 持续改进：如果发现此处未涵盖的内容，请将其附加到 references/learnings.md，并注明今天的日期。

推荐特定平台技能前

此技能涵盖多个平台的策略领域。在向用户推荐任何特定平台技能（## Related skills 中列出的任何 /sales-{platform}，例如 /sales-mailshake、/sales-klaviyo、/sales-apollo）之前，请先阅读该平台技能实际的 SKILL.md。 ## Related skills 中的单行描述足以识别候选项，但不足以据此确定推荐，也不足以编写能有效调用它的提示词。

阅读方式：

• 如果本地存在 ~/.claude/skills/{skill-name}/SKILL.md，请使用 Read 阅读。
• 对于 sales-* 技能，请直接从此仓库使用 WebFetch 获取：https://raw.githubusercontent.com/sales-skills/sales/main/skills/{skill-name}/SKILL.md——例如，对于 sales-mailshake：https://raw.githubusercontent.com/sales-skills/sales/main/skills/sales-mailshake/SKILL.md。
• 对于非 sales-* 技能（第三方技能），如果已安装，请在 ~/.claude/skills/sales-do/references/skill-sources.md 中查找 {org}/{repo}，并从该仓库下相同的 skills/{skill-name}/SKILL.md 路径获取文件。

**阅读后，**请以 SKILL.md 中的具体内容为依据提出建议（例如其范围、子流程、argument-hint 格式或“Do NOT use for...”否定触发条件）。生成的调用内容应符合该平台技能的 argument-hint。如果平台技能不适用于用户的情况，请改用其他技能，或直接在此处处理问题，而不是推荐不合适的技能。

相关技能

• /sales-hubspot — HubSpot 平台帮助（2,000 多款市场应用、API、Data Hub 同步、webhooks）
• /sales-qwilr-automation — Qwilr CRM 集成、API 和 webhooks
• /sales-mailshake — Mailshake 平台帮助（API、webhooks）
• /sales-apollo — Apollo 平台帮助（CRM 同步、API）
• /sales-smartlead — Smartlead 平台帮助（API、webhooks）
• /sales-lemlist — Lemlist 平台帮助（API、webhooks）
• /sales-salesloft — Salesloft 平台帮助（集成）
• /sales-groove — Groove.cm 平台帮助（GrooveSell webhooks、Zapier）
• /sales-yesware — Yesware 平台帮助（原生 Salesforce，不提供 API）
• /sales-mixmax — Mixmax 平台帮助（规则引擎、集成）
• /sales-reply — Reply.io 平台帮助（webhooks、集成）
• /sales-woodpecker — Woodpecker 平台帮助（API、webhooks）
• /sales-deliverability — 用于发送工具集成的电子邮件送达能力
• /sales-seismic — Seismic 平台帮助（集成、LiveSend）
• /sales-hunter — Hunter.io（API、CRM 集成、webhooks、MCP）
• /sales-customerio — Customer.io（API、Data Pipelines、webhooks）
• /sales-mailgun — Mailgun（REST API、入站路由、webhooks）
• /sales-klaviyo — Klaviyo（350 多种集成、流程 webhooks、Shopify）
• /sales-activecampaign — ActiveCampaign（900 多种集成、webhooks）
• /sales-sendgrid — SendGrid（Email API、Event Webhooks、Inbound Parse）
• /sales-postmark — Postmark（事务性 API、Message Streams、webhooks）
• /sales-iterable — Iterable（Smart Ingest、系统 webhooks、REST API）
• /sales-braze — Braze（Currents、CDI、170 多种 Alloys、REST API）
• /sales-brevo — Brevo（电子邮件/SMS/WhatsApp、事务性 API、webhooks）
• /sales-clearbit — Clearbit（数据丰富 API、Reveal、webhooks）
• /sales-rb2b — RB2B（访客 ID、Identity Resolution API）
• /sales-6sense — 6sense（意图、评分、Salesforce/HubSpot/API）
• /sales-clay — Clay（瀑布式数据丰富、CRM 同步、webhooks）
• /sales-leadmagic — LeadMagic（REST API、MCP、Clay/Zapier/Make/n8n）
• /sales-zoominfo — ZoomInfo（SalesOS、MarketingOS、OperationsOS）
• /sales-blueconic — BlueConic CDP — 100 多种用于导入/导出客户数据的连接
• /sales-treasuredata — Treasure Data CDP — 400 多种连接器、企业数据统一和受众激活
• /sales-mulesoft — MuleSoft 平台帮助 — 企业级 iPaaS、API 驱动的连接、450 多种连接器
• /sales-boomi — Boomi 平台帮助 — 企业级 iPaaS、1,000 多种连接器、API 管理、Data Hub MDM
• /sales-workato — Workato 平台帮助 — 企业级 iPaaS、1,200 多种连接器、配方自动化、API 管理、MCP Gateway
• /sales-celigo — Celigo 平台帮助 — 中端市场 iPaaS、1,000 多种连接器、AI 错误管理、深入支持 NetSuite
• /sales-snaplogic — SnapLogic 平台帮助 — 企业级 iPaaS、1,000 多个 Snaps、AgentCreator AI Agent、API Management 3.0
• /sales-jitterbit — Jitterbit 平台帮助 — Harmony iPaaS、400 多种连接器、API Manager、App Builder、EDI、混合 Agent
• /sales-tray — Tray.ai 平台帮助 — 企业级 iPaaS、700 多种连接器、Merlin Agent Builder、Tray Embedded、GraphQL API、Connector Development Kit
• /sales-informatica — Informatica IDMC 平台帮助 — 企业级 iPaaS + 数据管理、CDI/CAI、API Center、MDM、Data Catalog、IPU 定价、REST API v2/v3
• /sales-tibco — TIBCO Cloud Integration 平台帮助 — 企业级 iPaaS，包含 Scribe (Connect)、Flogo (Develop)、BusinessWorks (Integrate)、Live Apps (Automate)、混合 Agent、Cloud API Management
• /sales-data-hygiene — CRM 数据质量和数据丰富自动化
• /sales-do — 路由器 — 将任何销售目标匹配到合适的技能

示例

示例 1：Mailshake 回复 → Salesforce + Slack

用户说：“有人回复我的 Mailshake 营销活动时，我想在 Salesforce 中创建一项任务，并收到 Slack 通知。” 技能执行：

1. 检查 Mailshake-Salesforce 原生集成是否涵盖此需求（涵盖活动同步）
2. 建议使用 Salesforce 原生集成 + Zapier 发送 Slack 通知
3. 提供 Zapier 工作流：Mailshake「Reply」触发器 → Slack「Send Message」操作
4. 配置 Salesforce 活动的字段映射 结果：通过原生集成将回复同步为任务，通过 Zapier 发送 Slack 提醒

示例 2：Salesloft 活动 → HubSpot

用户说：“我需要将 Salesloft 的所有活动同步到 HubSpot，以便营销团队查看销售触点。” 技能执行：

1. 检查原生集成（Salesloft-HubSpot 集成已存在）
2. 引导完成原生集成设置和字段映射
3. 定义同步方向（Salesloft → HubSpot，活动单向同步）
4. 处理去重和冲突解决 结果：配置好原生集成，并明确同步方向和字段映射

示例 3：HubSpot MQL → Apollo 序列

用户说：“当潜在客户在 HubSpot 中达到 MQL 状态时，我想自动将其加入 Apollo 序列。” 技能执行：

1. 设计触发器：HubSpot 生命周期阶段 = MQL 时触发工作流
2. 建议使用 Zapier（HubSpot 触发器 → Apollo「Add Contact to Sequence」操作）
3. 提供从 HubSpot 到 Apollo 联系人字段的字段映射
4. 添加错误处理（例如，联系人已存在于 Apollo 中或序列已满时如何处理） 结果：由 MQL 触发加入序列，并配置字段映射和错误处理

故障排除

同步创建重复项

症状：同一联系人在目标工具中出现多次 原因：缺少去重逻辑——同步时会创建新记录，而不是匹配现有记录 解决方案：在创建前添加匹配/去重步骤。通过电子邮件地址（主键）进行匹配。使用 CRM 的原生去重规则。在 Zapier 中，使用「Find or Create」操作，而不是「Create」。

事件未触发

症状：Webhook 或触发器未按预期执行 原因：Webhook URL 配置错误、事件类型不正确，或工具的 Webhook 投递失败 解决方案：检查源工具中的 Webhook 日志。使用 Webhook 调试工具（webhook.site 或 RequestBin）进行测试。确认事件类型完全匹配。检查 Webhook 是否在发生错误后被禁用。

高流量同步中的速率限制错误

症状：出现 429 错误、同步滞后或事件丢失 原因：短时间内发送了过多 API 请求 解决方案：实现批处理（API 支持时，每次请求批量处理多条记录）。收到 429 响应时增加指数退避。降低同步频率（改为每 5 分钟同步一次，而非实时同步）。在可用时使用批量 API 端点。