WhatsApp Webhook：将群组命令与 CRM、ERP 或 API 集成
在 9bot 中，集成是由内向外进行的：当有人在群组中使用 /quote 或 /order 等命令时，9bot 会向您的 CRM、ERP 或 API 地址发起出站 HTTP 调用（GET、POST 或 PUT）。9bot 不提供接收其他系统 Webhook 的 URL。这与 Meta Cloud API 的 Webhook 不同，后者是把消息事件推送到您的服务器。
出站调用GET、POST 与 PUT群组命令
阅读时间：6 分钟
实际效果
什么是 WhatsApp Webhook
直接回答：Webhook 是在事件发生时自动发起的 HTTP 调用。WhatsApp 有两种模式：Meta Cloud API 的入站 Webhook，用于通知您的服务器收到了消息；以及由命令触发的出站调用，这是 9bot 在群组中采用的模式。
| 方面 | Cloud API Webhook（Meta） | 9bot 中的 API 命令 |
|---|---|---|
| 方向 | 入站：Meta 调用您的服务器 | 出站：9bot 调用您的系统 |
| 触发 | 账户消息事件 | 在群组中发送的命令 |
| 方法 | 向您的端点发送 POST | GET、POST 或 PUT |
| 服务商的接收 URL | 在 Meta 注册您的 URL | 9bot 没有入站 URL |
使用场景：CRM、订单、工单与自动化
| 命令 | 方法 | 系统 | 结果 |
|---|---|---|---|
| /quote | POST | CRM | 根据客户需求创建线索 |
| /order 1234 | GET | ERP 或电商 | 查询订单状态 |
| /ticket | POST | 客服系统 | 创建支持工单 |
| /stock 产品 | GET | ERP | 查询库存 |
| /update 1234 | PUT | CRM | 更新商机阶段 |
| /report | POST | n8n 或 Make | 触发自动化场景 |
n8n、Make 等平台通常为每个场景提供一个入站 URL。此时 9bot 命令调用该 URL，再由平台把数据分发到其他系统。
如果群里也接收经销商订单，请了解如何用命令和系统记录来整理 WhatsApp 订货。
Payload 示例
以下示例仅作说明，字段和地址取决于您的 API 约定。
POST https://api.yourcompany.com/leads
Content-Type: application/json
{
"command": "/quote",
"group": "Wholesale Customers",
"text": "20 boxes of product X"
}查询状态时，通常在 URL 中带上订单号发起 GET 即可。更新已有记录时请使用 PUT。
出站 Webhook 的安全最佳实践
- 始终使用 HTTPS：不要把命令指向没有 TLS 的地址。
- 专用端点：为 9bot 单独创建路由，并在 CRM 或 ERP 中授予最小权限。
- 在 API 中校验：把收到的文本视为不可信输入，校验格式和长度。
- 使用权限：敏感命令仅限管理员和指定群组使用。
- 幂等与日志：避免重复记录，并在您的系统中保留审计轨迹。
延伸阅读
常见问题
9bot 能接收其他系统的 Webhook 吗？
不能。9bot 不提供入站 URL，只会在群组中使用命令时发起 GET、POST 或 PUT 出站调用。
这与官方 API 的 Webhook 有何不同？
Meta Cloud API 的 Webhook 把消息事件推送到您的服务器；在 9bot 中，是群组命令触发对您系统的调用。
与 CRM 集成需要写代码吗？
只需要一个 API 地址，或 n8n、Make 等工具提供的入站 URL。命令在后台中配置，无需代码。
支持哪些 HTTP 方法？
GET、POST 和 PUT。
费用是多少？
API 命令包含在 9bot 套餐中：前 3 个月每月 35 美元，之后每月 70 美元，提供 7 天试用，可用优惠码 FIRST9。
