在 Coexistence 号码上将 WhatsApp 连接到 Activepieces

如何将 Coexistence 号码连接到 Activepieces？

在 Activepieces 中创建 WhatsApp Business 连接，需要两个值：访问令牌和 WhatsApp Business Account id。EasyCoexistence 控制台会显示该连接的这两项，助手也可以通过 get_api_credentials 获取。该 piece 的说明会谈到创建 Meta 应用和系统用户，因为它假定您两者都没有。这里号码已经连接好，直接粘贴这些值即可。

然后创建一个以 New Incoming Message 触发器开头的流程，在触发器上设置一个您自选的验证令牌，并发布该流程。把触发器的 Webhook URL 复制到 EasyCoexistence 中该号码的 Webhook 目的地，并填入相同的验证令牌。Meta 发出验证请求，触发器作出响应，此后发往该号码的每条消息都会启动一次运行。

为什么应用密钥必须留空？

因为为这些投递签名的密钥不属于您，无法粘贴。Meta 用拥有该订阅的应用的应用密钥为每个 Webhook 签名，而通过 EasyCoexistence 连接的号码，其应用就是 EasyCoexistence 应用，它的密钥从不对外共享。

该 piece 把这个字段视为可选。留空时，触发器会照常接受投递。若填入其他应用的应用密钥，每次投递都无法通过 X-Hub-Signature-256 校验并被静默忽略，看起来就像消息根本没有到达。

真正把陌生人挡在握手之外的是验证令牌。请选择一个足够长的随机值，并保持触发器 URL 私密，因为它就是启动您流程的地址。

消息到达后，流程能做什么？

触发器交给流程的是一条扁平化的消息：发送者、资料名称、消息 id、类型、文本、媒体 id（如有）、按钮和列表回复，以及接收消息的号码 id。此后它就是一个普通的 Activepieces 流程，可以接入其他 piece，例如 CRM、表格或 AI 步骤。

回复使用同一个 piece。Send Message 发送自由文本，只有在客户最后一条消息后的 24 小时内才能送达。Send Template Message 发送已批准的消息模板，超过该时间窗口后只有它能送达。交互式按钮、列表、媒体、位置和表情回应都是各自独立的操作。

Activepieces 自己的说明指出，Meta 每个应用只接受一个 Webhook URL。按号码设置目的地后，限制变为每个号码一个 URL，所以需要处理多种事件类型的流程，应在同一个流程内部分支。

在手机上输入的回复会到达流程吗？

它们会到达 Webhook，但不会触发这个触发器。在 Coexistence 号码上，Meta 会把在 WhatsApp Business 应用中输入的每条回复的回显，以 smb_message_echoes 字段发送到同一个目的地。该 piece 的 New Incoming Message 触发器只读取 messages 字段，其余一律丢弃。

如果流程需要手机上的回复，请改用 Activepieces 通用的 Webhook piece 来启动，它接受任何 HTTP 方法，并在其同步 URL 上用 Return Response 步骤响应验证用的 GET 请求。随后由您自行解析原始负载，两个字段都包含在内。

对大多数流程来说，该 piece 的触发器更简单：它只响应客户，而团队的回复仍可在手机上的应用中查看。

常见错误

• 把应用密钥粘贴进 WhatsApp 连接。投递使用的是 EasyCoexistence 应用的密钥签名，因此每一条都会被忽略。
• 在发布流程之前就设置目的地。Meta 会立即验证，而未发布的流程无法响应。
• 以为 New Incoming Message 触发器能看到在手机上输入的回复。它只读取 messages 字段，不读取 smb_message_echoes。

常见问题

继续阅读