群发
个性化消息，海量触达。
选择已批准的模板，最多可向 10,000 个收件人发送。每个人都有自己的变量，每个结果都按号码返回。
WhatsApp 广播 API每次 API 调用可向多达 10,000 名客户发送单个模板。
一个请求即可将经过批准的模板发送给多达 10,000 人，每人接收个性化详情。您可以安排发送时间、预估费用，然后按收件人查看结果。
更喜欢无代码？通过 Wati 发送 WhatsApp 广播。
- 16,000+190 多个国家/地区的企业的选择
- 4.6/5G2 上的平均评分
- 官方Meta 业务合作伙伴和 WhatsApp BSP
一个请求。多达 10,000 名客户。
每个人都会收到专属的姓名、订单或日期。每个结果都会按编号返回。
- 从模板开始使用经过批准的模板开启对话，无论是单个客户还是每次调用最多 10,000 名客户。
- 在聊天中或通话中继续客户回复后提供文本、媒体和按钮，或在同一对话线程中进行语音通话。
- 由您的团队收尾Webhooks 通知您的代码。团队收件箱通知您的员工。
产品
发送。回复。收到反馈。人工交接。
消息传递
回复内容远不止文字。
在 24 小时窗口内，发送文本、图片、文件、回复按钮和列表选择器，并在您工作时显示正在输入指示器。
订单更新与提醒
适时的更新，准确传达。
当发生更改时，您的商店、预订或计费系统会发送经过批准的模板。客户点击按钮或进行回复。
自动回复和聊天机器人
由您的代码应答。
消息 Webhook 将每条新消息带到您的服务器。使用发送端点进行回复，或在 Pro 和 Business 版本上启动 Wati 聊天机器人。
Webhooks
每次回复，即时到达。
Webhooks 将新消息、已读回执、点击和失败信息实时推送至您的 URL。无需轮询。
团队收件箱
代码发起，人工完成。
回复将落入 Wati 团队收件箱中。通过 API 分配操作人员、设置状态并添加标签，以便合适的人员进行跟进。
联系人和分群
在 Wati 中镜像您的 CRM。
使用自定义属性创建和更新联系人，然后在向其发送消息前预览分群。
InstagramInstagram 评论
构建 Instagram 自动化。
列出您帖子上的评论，公开回复或发送私信。Instagram DMs 同样适用：通过 REST 或 Wati MCP 服务器回复活跃对话。
快速入门
三步上线。
- 连接
连接您的号码
在 Wati 中通过 Meta 的嵌入式注册（Embedded Signup）关联您的 WhatsApp 号码。
- 认证
获取令牌
在 Wati 中创建一个 API 令牌，并仅授予您所需的权限范围。请将其保存在您的服务器上。
- 发送
发起您的第一次调用
通过单个请求发送经过批准的模板。然后添加 webhook 以跟踪送达情况。
您的第一个请求解析
以下是单个请求包含的内容，以及每个部分在消息中的显示位置。
- 收件人
客户的 WhatsApp 号码，带国家/地区代码。
phone_number14155552671 - 使用的消息
Meta 在您的账号中批准的模板名称。
template_nameorder_update - 要填入的内容
模板中空白处的值，每人一个。
custom_paramsname = Mayaorder_id = 10482 - 您的密钥
随每个请求发送的 API 令牌。请将其保存在您的服务器上。
Authorization: Bearer <token> - 您收到的返回结果
200 表示 Wati 已接受该消息，并附带 broadcast_id。送达和已读状态随后通过 webhook 抵达。
200broadcast_id
消息文本和 order_update 仅为示例。具体措辞由您批准的模板决定。
- 目标评论
您要回复的评论。当您列出帖子的评论时，可以获取其 ID。
comment_id在 URL 路径中 - 来自哪个账号
连接到 Wati 的 Instagram 账号。
channel - 发送给谁
编写该评论的人，从该评论中获取。
userIduserName - 要发送的内容
最多 1,000 个字符的纯文本，或带有按钮的模板。
type = texttexttype = template - 您收到的返回结果
ok 设置为 true 的 200 表示私密回复已成功发出。请使用与所有其他调用相同的 Authorization 请求头。
ok: trueresult: success
POST /api/ext/v3/comments/{comment_id}/privateReply。评论和回复文本仅为示例。 查看文档中的请求说明
提供 cURL、Node、Python 和 PHP 示例。所选请求与此页面匹配。
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send" \
-H "Authorization: Bearer $WATI_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"template_name": "order_update",
"broadcast_name": "order_update_api",
"recipients": [
{
"phone_number": "14155552671",
"custom_params": [
{ "name": "name", "value": "Maya" },
{ "name": "order_id", "value": "10482" }
]
}
]
}'200响应示例来自文档示例的形态
{
"success": true,
"broadcast_id": "broadcast_123456",
"recipients": [
{
"local_message_id": "local-msg-123",
"phone_number": "14155552671",
"errors": []
}
]
}工作区区域的服务器 URL
全球
https://mcp.wati.io/mcp欧盟
https://eu-mcp.wati.io/mcp带有 mcpServers 配置的客户端
{
"mcpServers": {
"wati": {
"url": "https://mcp.wati.io/mcp"
}
}
}Claude Code
claude mcp add --transport http wati https://mcp.wati.io/mcp当客户端提示时，使用 OAuth 登录。配置中无需填写 API 密钥。欧盟工作区请使用欧盟 URL。MCP 文档
内置功能
Wati 为您处理好一切，省去您的烦恼。
号码入驻
通过 Meta 的嵌入式注册（Embedded Signup）进行连接。WhatsApp Business 账户将注册到您的企业名下。
模板状态
审批、质量和类别更改将以 Webhook 形式发送，让您在发送失败前即可获知。
Webhook 重试
最多重试 144 次，每 10 分钟一次。如果您的端点持续失败，Wati 将向您发送电子邮件。
速率限制与排队
发送速度过快会收到带有 Retry-After 标头的 429 错误。已接受的消息将在队列中等待。
人工接管
一个团队共享收件箱，用于处理不应仅由代码回复的对话。
限定范围的 API 令牌
v3 支持限定范围的令牌，确保每个集成仅获得所需的访问权限。
定时发送
只需调用一次即可安排稍后发送模板。Wati 将准时发送。
预估成本
在发送任何内容之前预估广播成本。
核心机制
按功能分类的 API 端点。
群发调用包含的内容
| 字段 | 必填 | 说明 |
|---|---|---|
template_name | 是 | 账户中已批准的模板。使用 GET /messageTemplates 列出它们。 |
broadcast_name | 是 | 您为此次发送自定义的标签 |
recipients | 是 | 1 到 10,000 人，每人包含一个 phone_number |
custom_params | 按收件人 | 模板变量的名称和值对 |
local_message_id | 否 | 您自己的 ID，将在每个收件人的结果中返回 |
channel | 否 | 发送号码，按名称或号码。如果留空则使用默认通道。 |
来自 v3 发送端点架构。响应包含 success、broadcast_id 以及每个收件人的 errors。
模板
使用已批准的模板立即发起对话或定时发起。
文档 →GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule群发
读取营销活动结果和各收件人状态，并预先估算费用。
文档 →GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost消息收发
在 24 小时窗口内使用文本、媒体或按钮回复。
文档 →POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator团队收件箱
分配操作员、更改状态、添加或移除标签。
文档 →PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags列出帖子和评论、公开或私下回复、检查权限。
文档 →GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions路径相对于 https://live-mt-server.wati.io/api/ext/v3。创建 webhook 使用旧版路径 POST /{tenantId}/api/v2/webhookEndpoints。
对于 AI 智能体，Wati MCP 服务器涵盖了相同的 WhatsApp 操作，并能用文本回复 Instagram 私信和 Messenger 聊天。
查看全部 19 种 WhatsApp webhook 事件类型
消息
- message
- newContactMessageReceived
- sessionMessageSent_v2
- templateMessageSent_v2
投递状态
- sentMessageDELIVERED_v2
- sentMessageREAD_v2
- sentMessageREPLIED_v2
- templateMessageFailed
模板与账户
- templateReviewed
- templateQualityUpdated
- templateCategoryUpdated
- wabaStatusReviewUpdate
- PhoneNumberQualityUpdatedEvent
- accountUpdated
- accountDeleted
- phoneNumberDeleted
互动与通话
- chatbotTriggered
- ctaUrlClicked
- call.status
仅限 WhatsApp 事件：尚无 Instagram webhook 事件。同时提供几个事件的 BSUID 版本。Webhook 文档
限制与方案
明确的限制。已公开。
30 至 100 每 10 秒
模板发送
调用发送模板的频率，取决于您的方案（Growth、Pro 或 Business）。
10,000 个收件人
每次 v3 发送调用
一个模板，最多 10,000 人，每人可带有各自的变量。
24 小时 窗口
自由格式回复
文本、媒体和按钮需要开放的客户服务窗口。超出此窗口，请发送模板。
429 Retry-After
请求过快时
Wati 会告知您需要等待多长时间。被接受的消息将在队列中处理。
详细速率限制与方案可用性
| 端点 | Growth | Pro | Business |
|---|---|---|---|
/addContact, /getContacts | 10 / 10 s | 10 / 10 s | 10 / 10 s |
/getMessages | 10 / 10 s | 10 / 10 s | 10 / 10 s |
/sendTemplateMessage | 30 / 10 s | 60 / 10 s | 100 / 10 s |
/sendTemplateMessages | 30 / 10 s | 60 / 10 s | 100 / 10 s |
限制如 错误与速率限制 中所发布，按端点名称列出。v1 批量调用最多支持 1,000 个联系人。核心消息收发、模板和联系人端点适用于所有方案。团队分配、聊天状态、聊天机器人和自定义细分群体需要 Pro 或 Business 方案。一次性更新大量联系人的属性需要 Business 方案。各方案的端点可用性。如需更高的限制，请联系 Wati 讨论您的具体用例。
一次广播 API 调用可以触达多少人？
每次 v3 发送调用最多支持 10,000 个收件人。你发送一个已批准的模板，每个收件人都可以拥有自己的变量，例如姓名或订单号。根据你的套餐，模板发送限制为每 10 秒 30、60 或 100 次调用。你的号码的 Meta 消息限制和模板质量仍然适用，因此在大规模发送之前请先预热新号码。
我可以安排广播并在发送前检查费用吗？
可以。POST /messageTemplates/schedule 会在你选择的时间发送，而 POST /broadcasts/estimate-cost 会在发送任何内容之前估算费用。
如何查看谁接收并阅读了广播？
调用 GET /broadcasts 查看你的营销活动，调用 GET /broadcasts/{broadcast_id}/recipients 查看每个收件人的状态。若要获取实时更新，请订阅 sentMessageDELIVERED_v2、sentMessageREAD_v2 和 templateMessageFailed 等 Webhooks。
如何将结果与我自己的记录进行匹配？
为每个收件人分配一个 local_message_id，例如你的订单号。Wati 会在发送调用的每个收件人结果中返回该 ID，并附带该号码的任何错误信息。
我可以选择使用哪个 WhatsApp 号码发送广播吗？
可以。传入带有发送方号码名称或号码的 channel。留空则通过你的默认渠道发送。
我需要懂编程吗？
比以前需要懂的要少。AI 应用构建器可以根据简单的英语指令编写 API 调用，并且本页面上的示例展示了每一次调用。
在开始对话之前，你仍然需要一个连接到 Wati 的 WhatsApp 号码、一个 API 令牌以及一个经 Meta 批准的模板。如果 AI 工具编写了代码，请检查你的令牌是否保留在服务器上。
API 的速率限制是多少？
在所有套餐中，联系人和消息历史记录调用均限制为每 10 秒 10 个请求。在 Growth、Pro 和 Business 套餐中，模板发送分别限制为每 10 秒 30、60 或 100 个请求。当你达到限制时，将收到带有 Retry-After 标头的 HTTP 429。如需更高的限制，请联系 Wati。
我可以随时向客户发送消息吗？
在 WhatsApp 上，自由格式的文本、媒体和互动消息需要一个开放的 24 小时客户服务窗口。在此窗口之外，请使用经 Meta 批准的模板来开启对话。
WhatsApp 商业应用（WhatsApp Business app）与 API 之间有什么区别？
商业应用适用于手机上的手动聊天，最多支持 5 台关联设备，广播列表上限为 256 个联系人。API 将 WhatsApp 连接到你自己的系统。你可以批量发送已批准的模板、自动回复、接收 Webhooks 并跨团队收件箱共享一个号码。