WhatsApp 触发器
使用WhatsApp 触发器节点响应WhatsApp中的事件并将WhatsApp与其他应用程序集成。n8n内置支持广泛的WhatsApp事件,包括账户、消息和电话号码事件。
在此页面上,您将找到WhatsApp 触发器节点可以响应的事件列表以及更多资源的链接。
提示
Credentials 凭证
您可以在WhatsApp Business Cloud 凭据文档找到此节点的身份验证信息。
提示
Examples and templates 示例和模板
有关帮助您入门的使用示例和模板,请参阅 n8n 的 WhatsApp 集成 页面。
活动
- Account Review Update 账户审核更新
- Account Update 账户更新
- Business Capability Update 业务能力更新
- Message Template Quality Update 消息模板质量更新
- Message Template Status Update 消息模板状态更新
- Messages 消息
- Phone Number Name Update 电话号码名称更新
- Phone Number Quality Update 电话号码质量更新
- Security 安全
- Template Category Update 模板类别更新
相关资源
n8n 为 WhatsApp 提供应用程序节点。您可以在WhatsApp Business Cloud 节点文档找到节点文档。
在n8n的网站上查看示例工作流程和相关内容{:target=_blank .external-link}。
有关API的详细信息,请参考WhatsApp的文档{:target=_blank .external-link}。
常见问题
以下是WhatsApp 触发器节点的一些常见错误和问题以及解决或故障排除的步骤。
工作流程仅适用于测试或生产
WhatsApp 只允许您为每个应用程序注册一个 Webhook。这意味着每次您从使用测试 URL 切换到使用生产 URL(反之亦然)时,WhatsApp 都会覆盖注册的 Webhook URL。
如果您尝试测试一个在生产中也处于活跃状态的工作流程,您可能会遇到此问题。WhatsApp只会向两个webhook URL中的一个发送事件,因此另一个永远不会收到事件通知。
要解决此问题,您可以在测试时禁用您的工作流程:
警告
Halts production traffic 停止生产流量
此解决方法会暂时禁用您的生产工作流程进行测试。停用后,您的工作流程将不再接收生产流量。
- 转到您的工作流程页面。
- 切换顶部面板中的Active 活跃开关以临时禁用工作流程。
- 使用测试webhook URL测试您的工作流程。
- 完成测试后,切换Inactive 非活跃切换以重新启用工作流程。生产webhook URL应该恢复工作。
收到 WhatsApp 消息时工作流未运行
Meta 只会向已订阅 WhatsApp Business Account(WABA)的应用发送该账户的 WhatsApp webhook。发布包含 WhatsApp Trigger 节点的工作流时,n8n 会在 Meta 应用中注册 webhook URL,但不会将应用订阅到 WABA。
如果应用未订阅 WABA,发送到 WhatsApp 号码的消息将永远无法到达 n8n。工作流不会启动,n8n 也不会显示失败的执行记录。从 Meta App Dashboard 发送的测试事件仍可能到达 n8n,因此测试通过并不能排除此问题。
检查并修复订阅:
- 在 Meta for Developers Apps dashboard 中选择您的应用,然后转到 WhatsApp > API Setup。复制 WhatsApp Business Account ID。请勿使用 Phone number ID。
- 获取与 n8n WhatsApp Trigger 凭据相同 Meta 应用的 access token。第 4 步的请求会订阅该 token 所属的应用。token 需要
whatsapp_business_management权限。例如,在 Meta 的 Graph API Explorer 中,在 Meta App 下选择应用,添加该权限并生成 token。 -
列出已订阅 WABA 的应用:
bash curl -X GET 'https://graph.facebook.com/<api-version>/<business-account-id>/subscribed_apps' \ -H 'Authorization: Bearer <access-token>'每个已订阅的应用都会显示在
data数组中,应用 ID 位于whatsapp_business_api_data.id。应用 ID 就是 n8n 凭据中的 Client ID 客户端 ID。如果响应为{"data": []},或其中没有 ID 与您的应用相匹配,则应用尚未订阅。如果应用条目还包含
override_callback_uri,Meta 会将此 WABA 的消息 webhook 发送到该 URL,而不是应用的 webhook URL。Business phone number 上设置的 override 优先级高于二者。请检查 URL 是否符合预期。 4. 只有当应用尚未订阅,或其条目包含您想移除的override_callback_uri时,才发送此请求。不带 body 的POST会订阅应用,并移除其订阅上的所有override_callback_uri。如果应用已经订阅且您想保留 override,请跳过此步骤。该请求不需要 body:bash curl -X POST 'https://graph.facebook.com/<api-version>/<business-account-id>/subscribed_apps' \ -H 'Authorization: Bearer <access-token>'成功的请求会返回
{"success": true}。 5. 如果在第 4 步发送了请求,请再次运行第 3 步的请求。确认应用 ID 位于列表中,且其条目不包含override_callback_uri。如果消息仍发送到错误 URL,请检查 business phone number 上的 override。 6. 向您的 WhatsApp 号码发送消息,以测试已发布的工作流。
警告
Don't delete the subscription to fix a webhook conflict 不要通过删除订阅来修复 webhook 冲突
already has a webhook subscription 错误指的是应用的 webhook URL,而不是 WABA 订阅。请勿向 subscribed_apps 发送 DELETE 请求来清除错误。该请求会取消应用对 WABA 的订阅,Meta 也会停止发送该账户的 webhook。
更多信息请参阅 Meta 的 Subscribed Apps API 参考和 Webhook overrides。