SuperAPI AI 工具集

crm-integrations

营销与增长

查看项目

更新于 10-16 09:29

技能介绍

用途:把获客表单连接到 CRM 与自动化工具(Webhook、Zapier、Make、HubSpot、Pipedrive),确保线索不因集成失败而丢失。

主要能力与规则:始终保留备份,CRM 失败时数据另存(如 Google Sheets);异步处理,不用 CRM 集成阻塞表单提交;失败的发送进入队列并按指数退避重试;记录所有集成尝试,便于调试与合规;发送前用 Zod 校验数据格式符合 CRM 要求;发送 PII 给第三方前检查 GDPR 同意;4xx 客户端错误不重试,5xx 与超时错误可重试;对 IP 等敏感数据做哈希;始终记录 UTM 参数与 referrer 用于归因;设置合理超时(如 10 秒)防止请求挂起。

集成流程:表单 → 校验 → 保存到 Sheets → 异步排队 CRM → 感谢页 → 后台带重试地调用 CRM。

关键环境变量:HUBSPOT_ACCESS_TOKEN(HubSpot API 认证,如 pat-xxx)、PIPEDRIVE_API_TOKEN(Pipedrive API 认证,如 xxx)、ZAPIER_WEBHOOK_URL(Zapier webhook,如 https://hooks.zapier.com/...)、CRM_WEBHOOK_URL(通用 CRM 端点)。

错误处理:2xx 成功不重试;4xx 记录并跳过,不重试;5xx 带退避重试;超时按网络问题重试。

适用场景:线索生成站点接入 CRM、线索表单与自动化平台对接、需要容错与合规审计的线索管道。

限制与禁止:不得阻塞表单响应等待 CRM;不得无备份存储;不得在客户端代码暴露 API 令牌;不得未经用户同意发送 PII;不得对瞬时失败无重试逻辑;不得忽略失败集成而不记录;Webhook 必须用 POST;API 令牌不得存入版本控制。

补充:资料还列出 Webhook 实现、HubSpot 联系人创建、Pipedrive 人员与交易创建、Zapier/Make 与表单处理器、失败队列等参考主题,具体代码与示例需查阅原技能文档。