在 Coexistence 号码上将 WhatsApp 连接到 Pipedrive

一条 WhatsApp 消息如何到达 Pipedrive 联系人？

Meta 会把号码上的每条消息发送到您为它设置的 Webhook 目标地址，这里是 n8n 的 Webhook 节点。工作流用发送者的号码搜索 Pipedrive 联系人；Pipedrive 的联系人搜索涵盖电话字段，并支持精确匹配参数。找到联系人时，工作流直接使用其 id。没有找到时，工作流会用 WhatsApp 资料名称和号码创建联系人，再创建一条与其关联的线索，这样陌生人发来的第一条消息会出现在 Leads Inbox 中，等待同事跟进评估。

消息本身会成为一条备注。Pipedrive 备注只需要内容（支持 HTML），以及联系人、交易、组织或线索 id 中的至少一个。如果有进行中的交易，就挂在该交易上，否则挂在联系人上。

为什么搜索步骤最先触及限制？

因为 Pipedrive 为搜索单独设置了小得多的配额。一般 API 调用按用户在滚动的两秒窗口内限流：使用 API 令牌的 Lite 套餐为 20 个请求，Ultimate 套餐最高为 120 个。而 Search API 在所有套餐上都限制为每两秒 10 个请求。

号码平时很安静时不会察觉。但如果号码向几百位客户发送了模板，一分钟内收到 50 条回复，就会触发限制，因为每条回复都从一次搜索开始。此时工作流会收到 429 响应，如果没有重试，备注就会丢失。

有两个办法。一是在 Pipedrive 搜索节点上开启重试并设置等待；二是把电话号码到联系人 id 的映射缓存在 n8n 的工作流静态数据或一张小表中，这样客户连续发来六条消息，只需搜索一次，而不是六次。

在手机上输入的回复也能被记录吗？

可以。Coexistence 让 WhatsApp Business 应用继续在同一号码上使用，团队成员从应用中回复时，Meta 会在 smb_message_echoes 字段下，把这条发出消息的回显发送到同一个 Webhook 目标地址。

为这些回显增加一个分支，把它们记录为标记为外发的备注；如果您的团队按活动数量统计，也可以记录为已完成的活动。销售打开交易时，就能按顺序看到客户问了什么、店里答了什么。

对于工作流自己发送的消息，例如交易进入新阶段时发送的模板，请在发送的那一刻记录备注。工作流已经有文本和交易 id，没有理由再等待 Webhook。

电话号码应该如何标准化？

只保留带国家代码的数字，不含其他字符，因为 Meta 发送的就是这种格式。发送者会以 14155550188 的形式到达，而人工录入 Pipedrive 的联系人可能写成 +1 (415) 555-0188。

工作流创建联系人时，请以纯数字形式保存号码，这样它自己的记录始终可以匹配。对于人工创建的联系人，在 n8n 中做一次性清理，把现有电话值改写成同样的格式，第一周就能回本。否则，精确匹配搜索会漏掉团队手动录入的联系人，工作流会为每个人再创建一个重复项。

如果团队喜欢原来的显示格式，可以把它保存在第二个电话条目中。Pipedrive 联系人可以有多个电话。

常见错误

• 每条消息都搜索一次且不做缓存。集中的回复会触及 Search API 每两秒 10 个请求的限制，备注随之丢失。
• 为每条消息创建线索，而不是为每位新联系人创建。Leads Inbox 会被同一位客户的重复线索塞满。
• 有交易进行中时只把备注挂在联系人上。负责该交易的销售永远看不到这段对话。

常见问题

继续阅读