🚀 Get TikTok DMs and Ads in Wati Team Inbox and convert social engagement into revenue See TikTok on Wati🚀 TikTok DMs + Ads now in Team Inbox →

Wati MCP 服务器

WhatsApp MCP 服务器:让你的 AI 智能体在 WhatsApp 中工作。

连接支持远程 MCP 的任意客户端,通过 OAuth 登录,并用日常语言提问:列出模板、预览发送、为聊天加标签、更新联系人。

最后更新于

  • 16,000+190+ 个国家的企业
  • 4.6/5G2 上的平均评分
  • 官方Meta 业务合作伙伴和 WhatsApp BSP
G2 聊天机器人领导者G2 中端市场聊天机器人领导者G2 发展势头聊天机器人领导者G2 最易落地 WhatsApp 营销ISO 27001GDPR

一个服务器 URL。你的智能体精通 WhatsApp。

用于模板、营销活动、联系人、细分群体和团队收件箱的工具。一键登录。配置中无需 API 密钥。

  • 从模板开始获批的模板可为一位或 10,000 位客户开启对话。
  • 在聊天中继续客户回复后即可发送文字、媒体和按钮。
  • 由你的团队收尾Webhooks 通知你的代码。团队收件箱通知你的团队成员。
产品

发送。回复。倾听。转接。

群发

个性化消息,海量触达。

选择经过批准的模板,最多可发送至 10,000 名收件人。每个人都会获得各自的变量,每个结果都按编号返回。

消息传递

超越纯文本的丰富回复。

在 24 小时窗口内,发送文本、图片、文件、回复按钮和列表选择器,并在您工作时显示输入指示器。

订单更新与提醒

在对的时机,推送对的更新。

当发生变更时,您的商店、预订或计费系统会自动发送经过批准的模板。客户点击按钮即可进行回复。

自动回复与聊天机器人

您的代码来解答。

消息 Webhook 会将每条新消息带到您的服务器。使用发送端点进行回复,或在 Pro 和 Business 版本上启动 Wati 聊天机器人。

Webhooks

每一次回复,即时送达。

Webhooks 将新消息、已读回执、点击和失败信息实时推送至您的 URL。无需轮询。

团队收件箱

代码开启,人工完成。

回复将落入 Wati 团队收件箱。通过 API 分配操作员、设置状态并添加标签,以便合适的人员进行跟进。

联系人与细分群体

您的 CRM,在 Wati 中完美镜像。

使用自定义属性创建和更新联系人,并在向其发送消息之前预览细分群体。

InstagramInstagram 评论和私信

构建 Instagram 自动化。

列出您帖子上的评论,进行公开回复或发送私信回复。

快速上手

三步即可上线。

  1. 连接

    连接您的号码

    通过 Wati 内置的 Meta 嵌入式注册功能链接您的 WhatsApp 号码。

  2. 认证

    获取令牌

    在 Wati 中创建 API 令牌,并仅授予您所需的权限范围。请将其保存在您的服务器上。

  3. 发送

    发起您的第一次调用

    通过一个请求发送已批准的模板。然后添加 Webhook 以跟踪投递状态。

您的第一个请求解析

以下是一个请求包含的内容,以及每个部分在消息中显示的位置。

  1. 收件人

    客户的 WhatsApp 号码,包含国家/地区代码。

    phone_number14155552671
  2. 使用哪条消息

    Meta 在您的账户中批准的模板名称。

    template_nameorder_update
  3. 填充内容

    模板中空白处的值,每人一个。

    custom_paramsname = Mayaorder_id = 10482
  4. 您的密钥

    您的 API 令牌,随每个请求发送。请将其保存在您的服务器上。

    Authorization: Bearer <token>
  5. 您获得的回应

    返回 200 表示 Wati 已经接受了该消息,并带有一个 broadcast_id。送达和已读状态随后会通过 Webhook 到达。

    200broadcast_id

消息文本和 order_update 仅为示例。具体措辞由您批准的模板决定。

随时可用的代码隐藏代码
内置功能

Wati 为您处理的一切,无需劳心。

号码引导接入

通过 Meta 的嵌入式注册连接。WhatsApp 业务账号将注册至您的企业。

模板状态

审批、质量和类别更改将作为 Webhook 到达,确保您在发送失败前知晓。

Webhook 重试

最多重试 144 次,每 10 分钟一次。如果您的端点持续失败,Wati 会向您发送电子邮件。

速率限制与排队

频率过高将收到带 Retry-After 标头的 429 响应。已接受的消息将在队列中等待。

人工接管

专为不应仅由代码独自回答的对话打造的共享团队收件箱。

作用域 API 令牌

v3 支持作用域令牌,确保每个集成仅获得其所需的访问权限。

定时发送

只需一次调用即可安排模板稍后发送。Wati 将按时发送。

预估成本

在发送任何内容之前预估群发成本。

底层原理

各功能对应的端点。

模板

使用已批准的模板立即开始或按计划开始对话。

文档 →
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

聊天机器人 Pro+

列出您的 Wati 聊天机器人并为联系人启动一个聊天机器人。

文档 →
GET/chatbotsPOST/chatbots/start

Webhooks

管理订阅并列出您可以接收的事件类型。

文档 →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

联系人与分群

从您的 CRM 同步联系人和属性,然后针对特定分群。

文档 →
POST/contactsPUT/contactsPOST/segments/evaluate

团队收件箱

分配客服人员、更改状态、添加或移除标签。

文档 →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

列出帖子和评论、公开或私密回复、检查权限。

文档 →
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

还提供多个事件的 BSUID 版本。Webhook 文档

限制与方案

清晰限制,公开透明。

30 到 100 每 10 秒

模板发送

调用发送模板的次数,取决于您的方案(Growth、Pro 或 Business)。

10,000 名收件人

每次 v3 发送调用

一个模板,最多可达 10,000 人,每人拥有各自的变量。

24 小时 窗口

自由格式回复

文本、媒体和按钮需要开放的客服窗口。在此之外,请发送模板。

429 Retry-After

当您操作过快时

Wati 会告知您需要等待的时间。接受的消息将在队列中处理。

详细了解速率限制和方案可用性
按方案划分的已记录速率限制
端点GrowthProBusiness
/addContact, /getContacts10 / 10 秒10 / 10 秒10 / 10 秒
/getMessages10 / 10 秒10 / 10 秒10 / 10 秒
/sendTemplateMessage30 / 10 秒60 / 10 秒100 / 10 秒
/sendTemplateMessages30 / 10 秒60 / 10 秒100 / 10 秒

限制如 Errors & Rate Limits 上所公布,按端点名称列出。v1 批量调用最多可处理 1,000 个联系人。核心消息传递、模板和联系人端点适用于所有方案。团队分配、聊天状态、聊天机器人和自定义分群需要 Pro 或 Business 方案。一次性更新许多联系人的属性需要 Business 方案。按方案划分的端点可用性。如需更高的限制,请联系 Wati 讨论您的具体用例。

常见问题

常见问题解答

完整的 API 参考文档已公开。 阅读文档

什么是 Wati MCP 服务器?

一个远程 MCP 服务器,允许 AI 助手使用 Wati。文档列出了用于模板、营销活动、联系人、细分人群、对话、标签和 Webhook 的 58 个工具;实际可用工具列表取决于您登录的会话。请连接到 https://mcp.wati.io/mcp,如果是欧盟工作区,请连接到 https://eu-mcp.wati.io/mcp。

使用 Wati MCP 服务器需要 API 密钥吗?

不需要。您的 MCP 客户端会通过 OAuth 为您登录,因此配置或 URL 中无需包含 API 密钥。如果您的工作区位于欧盟地区,请使用欧盟 URL。

我的智能体可以通过 MCP 使用哪些渠道?

WhatsApp,包含全套工具。Instagram 私信(DM)和 Messenger 文本回复也已可用,其中 Messenger 需要 Wati OAuth 登录。Instagram 评论和聊天机器人工具正在陆续推出中。

我需要懂编程吗?

比过去的要求低。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 商业应用程序与 API 有什么区别?

商业应用程序适用于手机上的手动聊天,最多支持 5 台关联设备,且广播列表上限为 256 个联系人。API 可将 WhatsApp 连接到您自己的系统。您可以批量发送已批准的模板、自动回复、接收 Webhook,并在团队收件箱中共享同一个号码。

我的套餐包含哪些端点?

核心消息传送、模板和联系人端点包含在所有套餐中。团队分配、聊天状态、聊天机器人和自定义细分人群需要专业版(Pro)或商业版(Business)。文档中按套餐列出了端点的可用性。

距离发送第一条消息仅差一个请求。

免费开始,在 Wati 中连接您的 WhatsApp 号码并进行首次调用。