账户与集成
连接外部系统或助手
创建限定权限的 Pro 或 Agency 密钥，发布最新内容或连接助手。
开始前的准备
Webhook 从 WhatsApp 服务接收新消息通知。服务器配置由集成运营人员负责，控制面板用户无需更改服务器设置。MCP 允许助手请求账户工具。
操作步骤
- 需要处理收到的消息时，打开“设置”，找到“Webhook URL（用于 WhatsApp 服务器）”。
- 选择“复制”，获取你的账户部署所使用的准确地址。
- 请运营人员使用该地址，为目标设备配置收到的事件。
- 运营人员确认准备就绪后，安排从你自己的号码发来一条测试消息。
- 检查预期结果，例如匹配的自动回复，或启用“日志”后新记录的群组消息。
- 连接助手时，通过 MCP 客户端打开的授权页面登录。
- 批准访问前，核对应用名称和账户。
- 如需集成外部发送，请打开设置 → 外部集成。为一个已连接的账号和明确选择的群组创建具名密钥。请立即保存密钥，它只显示一次。复制 API 基础 URL。
- 示例：配置 Abacus.AI，使其在 America/Sao_Paulo 时区每天八个发布时间点分别生成最新内容。使用新的 Idempotency-Key 将每次发布提交到三个允许的群组。仅在重试完全相同的请求时复用该键。
- 省略 scheduled_at 可立即加入队列，也可使用带 -03:00 或 Z (UTC) 的绝对时间戳，最多提前 30 天。处理器每分钟检查一次；scheduled_at 是最早可处理时间，不保证精确到秒的送达。
- 重试前请检查任务状态和各群组的结果。只能取消尚未发出的发送。在设置中撤销泄露的密钥，然后创建并保存替代密钥；旧任务不会因新密钥而恢复。
操作示例
以下请求使用占位符；发送前请替换 ID 并选择未来日期。这些请求会发布真实消息。 curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'
如何确认操作成功
任务被接受和各群组的已接受结果仅确认网关已接受，不确认已送达或已读。如果访问权限、密钥、账号或群组权限发生变化，计划任务可能会被阻止。
注意事项
- 助手可以读取公开提供的记录，并在明确请求时发送文本。请求发送前，请阅读助手工具指南。
- MCP 不提供的编辑操作请在控制面板完成。
- Pro 和 Agency 月付或年付套餐均包含 API 访问权限。Starter 需要升级。密钥仅允许使用选定的账号和群组；替换 WhatsApp 账号会阻止发送。切勿分享服务器凭据。
- 文本最多支持 4,096 个字符；图片说明最多 1,024 个字符。通过 multipart 字段 payload 和 image 上传不超过 5 MiB 的 JPEG、PNG 或 WebP。不接受远程图片 URL。
- 新任务返回 HTTP 202。使用相同 Idempotency-Key 重试相同请求时，返回原任务及 HTTP 200；同一个键配合不同内容会返回 409。发出请求后超时可能导致结果未确认；请勿自动使用另一个键重新提交。
常见问题
- 看到的情况
- 测试后没有回复或新记录。
- 处理方法
- 检查设备连接，以及相关规则或“日志”设置，再请运营人员检查收到事件的配置。
- 预期结果
- 配置正确的功能能够处理新的匹配事件。
- 看到的情况
- 助手无法授权，或显示另一个账户。
- 处理方法
- 返回登录并选择目标账户；反复授权出错时，请告知运营人员。
- 预期结果
- 授权页面及返回的记录属于目标账户。
获取更多帮助
向运营人员提供功能名称和可见错误。不要在与助手的对话中提供服务器凭据。