要在启用自动化之前测试Papo webhook (https://papo.global/) 的连接，您可以使用Webhook.site等外部工具来验证目标URL、检查JSON payload格式并修正发送错误，而不会影响真实联系人。此过程适用于账户原生webhook以及自动化Flows中的“发送Webhook”操作。
提前验证可避免损坏的集成丢失数据或中断客户旅程。使用临时测试URL，您可以准确检查Papo发送的内容——标头、正文和响应代码——并在指向最终系统之前进行调整。
测试过程摘要
| 步骤 | 操作 | 工具/位置 |
|---|---|---|
| 1. 获取测试URL | 访问Webhook.site并复制生成的URL。 | Webhook.site |
| 2. 使用测试URL在Papo中配置webhook | 在webhook的目标字段中输入URL（在集成部分或Flow操作中）。 | Papo面板 |
| 3. 触发webhook | 对于账户webhook，向连接的收件箱发送WhatsApp消息。对于Flows中的webhook，在流程中注册测试联系人。 | 收件箱或Flow |
| 4. 分析收到的payload | 在Webhook.site面板中，查看到达的请求：方法、标头和正文JSON。 | Webhook.site |
| 5. 修正并替换为生产URL | 如果payload正确，将测试URL替换为系统的真实URL并激活自动化。 | Papo面板 |
如何测试账户webhook（集成）
Papo的原生webhook在收件箱收到每条新消息时触发。要无风险地验证它们：
- 在Papo面板中，访问设置 > 集成 > Webhooks并创建一个新的webhook。
- 定义触发器——例如所有消息——并在URL字段中，粘贴Webhook.site的临时地址。
- 保存webhook。
- 向监控的收件箱发送一条测试消息（通过WhatsApp或其他连接的渠道）。
- 在Webhook.site中，刷新面板并找到新到达的请求。验证JSON正文：它应包含发件人号码、消息内容和对话ID等数据。
- 如果JSON为空或格式错误，请检查所选的触发器，并确认消息确实已被收件箱接收。
- 验证后，编辑webhook并将URL替换为目标系统的URL。
如何在自动化Flows中测试“发送Webhook”操作
在Flows编辑器中，发送Webhook操作允许在旅程的特定步骤触发数据。测试通过临时激活的流程和一个控制联系人进行：
- 构建Flow并在所需位置添加发送Webhook节点。
- 在节点配置面板中，用Webhook.site的地址填写URL，选择POST方法，并使用Papo变量（如
{{contact.name}}和{{contact.phone}}）构建JSON正文。 - 激活Flow。
- 在CRM中，手动在该流程中注册一个测试联系人（遵循测试自动化Flows的相同步骤）。
- 跟踪Flow的执行历史，同时观察Webhook.site。
- 收到的请求应显示JSON，其中包含测试联系人的真实值，替换变量。否则，检查正文（使用
"nome": "{{contact.name}}"并确保联系人已填写字段）。 - 如果请求返回4xx或5xx错误，请检查方法是否正确（通常为POST）以及是否包含了
Content-Type: application/json标头。 - 验证后，停用Flow，将目标URL替换为生产URL，然后再次激活。
此过程适用于谁
- 管理员和系统分析师，需要在发布集成之前确保其完整性。
- 为CRM、电子表格或自动化工具构建带webhook的Flows的团队，希望在不影响真实潜在客户的情况下调试payload。
- 任何自定义账户webhook的用户，希望确认事件是否正确发送。
常见问题
我可以在不发送真实消息的情况下测试webhook吗？
对于账户webhook，不可能，因为它们由传入消息触发。使用测试WhatsApp号码（自己的或同事的）来生成事件。对于Flows，手动注册控制联系人允许测试，而无需潜在客户是真实客户。
Webhook.site是免费的吗？我应该在生产中使用它吗？
是的，Webhook.site生成临时公共URL并实时显示流量，非常适合调试。切勿在生产中使用这些URL——测试后，替换为目标系统的URL。
webhook触发了但payload为空。应该检查什么？
对于账户webhook，检查触发器（是否捕获了正确的消息类型）和收件箱权限。对于Flow操作，检查正文中的变量——像{{contact.name}}这样的字段只有在联系人注册了姓名字段时才会被填充。使用具有完整数据的联系人进行测试。
如何修正401（未授权）或403（禁止）错误？
这些错误表示目标系统拒绝了请求。根据外部工具的文档，在webhook配置的Headers字段中添加认证标头（例如Authorization: Bearer your-token）。
我可以以相同方式测试Kanban的webhook吗？
是的。在Kanban模块中配置的webhook可以使用Webhook.site的临时URL进行测试——只需将卡片从一列移动到另一列（触发事件的操作），并在测试面板中检查payload。
我需要保持Flow激活才能测试webhook吗？
是的。只有状态为激活的Flows才会处理webhook节点。激活流程，进行测试，然后根据需要停用。
另请参阅
使用第一个免费用户，您已经可以创建webhook并测试集成，无需承诺。