🚀 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 API

Wati API:适用于 WhatsApp、Instagram 和您的 AI 智能体的统一 API。

直接从您自己的产品在 WhatsApp 和 Instagram 上向客户发送消息,或通过 Wati MCP 服务器让 AI 助手代劳。

渠道
  • WhatsApp
  • Instagram
  • AI 智能体 (MCP)
  • TikTok 即将推出
  • Messenger 即将推出

最后更新于

  • 16,000+家遍布 190 多个国家的企业
  • 4.6/5G2 上的平均评分
  • 官方Meta 商业伙伴与 WhatsApp BSP
G2 聊天机器人领导者G2 中端市场聊天机器人领导者G2 聊天机器人发展势头领导者G2 WhatsApp 营销最具实施性奖ISO 27001GDPR

一个 API。WhatsApp、Instagram 和您的 AI 助手。

在客户已经使用的应用程序上接触他们。将其构建到您的代码中,或交给 AI 智能体。

  • 两大渠道已上线当前支持 WhatsApp 和 Instagram。TikTok 和 Messenger 即将推出。
  • 支持代码或无代码从您的产品调用 REST API,或通过 MCP 服务器连接 AI 助手。
  • 您的团队随时掌握动态对话将显示在 Wati 团队收件箱中,方便人工随时介入。
渠道

Wati API 涵盖的内容

两个消息传递渠道和一个用于 AI 智能体的 MCP 服务器现已上线。TikTok 和 Messenger 紧随其后。

  • 上线

    WhatsApp

    向单个或 10,000 名客户发送经批准的模板,在聊天中回复,启动聊天机器人并获取 Webhook。

    WhatsApp API
  • 上线

    Instagram

    使用 REST API 公开或私下回复评论。通过 MCP 服务器回答私信 (DM)。

    Instagram API
  • 上线

    AI 智能体 (MCP)

    使用 OAuth 连接 AI 助手。通过日常用语发送模板、回复聊天并更新联系人。

    MCP 服务器
  • 即将推出

    TikTok

    在同一个 Wati API 中实现 TikTok 对话。

  • 即将推出

    Messenger

    在同一个 Wati API 中实现 Messenger 对话。AI 智能体已经可以通过 MCP 服务器用文本进行回复。

覆盖范围

各渠道功能支持情况

对照公开文档,查看目前可以通过 Wati API 在各个渠道上执行的操作。

按渠道划分的 Wati API 功能
功能WhatsAppInstagramMessengerTikTok
使用已批准的模板向单个人或最多 10,000 人发起对话REST API 和 MCP–即将推出AI 智能体已经可以通过 MCP 使用文本回复。即将推出
在开放的聊天中回复文本、媒体和按钮。REST API 和 MCPMCP私信文本回复
公开或私下回复评论–REST API 和 MCP
用于新消息和发送状态的 WebhooksREST API–
为联系人启动 Wati 聊天机器人REST API、Pro 和 Business 计划–

REST API:使用 API 令牌从您的代码中进行调用。MCP:AI 助手通过 Wati MCP 服务器为您执行此操作。–:目前不在 API 中。完整列表请参见 API 参考。

开始使用

只需三步,即可上线。

  1. 注册

    创建您的账户

    在 API 注册页面注册 Wati,然后连接您的 WhatsApp 号码或 Instagram 账户。

  2. 获取密钥

    打开开发者控制台

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

  3. 发送

    发送您的第一个请求

    只需一次调用即可发送已批准的模板。送达和已读更新将通过 Webhook 接收。

POST/api/ext/v3/messageTemplates/send
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": "my_first_call",
    "recipients": [{ "phone_number": "14155552671",
      "custom_params": [{ "name": "name", "value": "Maya" }] }]
  }'

使用 Meta 在您的账户中批准的模板名称。WhatsApp API 页面上提供更多示例。

安全与限制

默认安全。限制公开。

24 小时 窗口期

WhatsApp 优先使用模板

自由格式的回复需要开启 24 小时客户服务窗口。在此之外,请从 Meta 批准的模板开始。

OAuth 适用于 MCP

您的 AI 工具中无密钥

AI 客户端在浏览器中登录 Wati MCP 服务器。您无需将 API 密钥粘贴到工具中。

带权限范围的 令牌

仅授予您许可的访问权限

每个 API 令牌都包含您选择的权限范围,并且可以设置过期时间。它仅显示一次,请将其保存在您的服务器上。

每 10 秒 30 至 100 次 请求

模板发送

取决于您的套餐。如果请求过快,将收到包含 Retry-After 标头的 HTTP 429 错误。

详细速率限制和套餐可用性
按套餐划分的记录速率限制
端点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 秒

限制如 错误与速率限制 中所述。核心消息传送、模板和联系人端点适用于所有套餐。团队分配、聊天状态、聊天机器人和自定义分群需要 Pro 或 Business 套餐。按套餐划分的端点可用性。如需更高的限制,请与 Wati 讨论您的具体用例。

常见问题

常见问题解答

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

什么是 Wati API?

Wati API 允许您的产品通过 Wati 发送和接收客户消息。目前它支持 WhatsApp 和 Instagram,并提供了一个 MCP 服务器,以便 AI 助手可以通过聊天完成相同的工作。您的团队可以在 Wati 团队收件箱中跟进每一次对话。

Wati API 支持哪些渠道?

WhatsApp 和 Instagram。在 WhatsApp 上,您可以发送已批准的模板、在聊天中回复、启动聊天机器人以及接收 Webhook。在 Instagram 上,REST API 涵盖了评论功能:列出帖子和评论、公开回复以及发送私密回复。Instagram 私信功能通过 Wati MCP 服务器运行。

TikTok 和 Messenger 即将推出。

是否支持 TikTok 或 Messenger?

目前 API 中尚不支持。两者均即将推出。连接到 Wati MCP 服务器的 AI 代理在登录 Wati 账户后,已经可以使用文本回复 Messenger 聊天。

我需要编写代码吗?

不需要。连接支持远程 MCP 的 AI 助手,通过 OAuth 登录并用简单的日常语言提问,例如列出您的模板或回复聊天。

如果您更喜欢代码,REST API 使用一个基础 URL 和一个 bearer 令牌,AI 应用构建器可以为您编写调用代码。

在哪里可以找到文档?

完整的参考文档公开在 docs.wati.io:包括 API 参考、MCP 服务器指南、速率限制以及按套餐划分的端点可用性。AI 编码工具可以在 docs.wati.io/llms.txt 阅读整个索引。

如何获取 API 密钥?

在 live.wati.io/start/api 注册,然后在 Wati 中打开开发者控制台,创建一个仅包含您所需权限范围的 API 令牌。该令牌只显示一次,因此请将其存储在您的服务器上,切勿存储在浏览器或移动应用中。

此页面与 WhatsApp API 页面有何不同?

此页面是所有 Wati API 的概览:包括各个渠道、各项功能在何处可用以及如何开始。WhatsApp API 页面则更深入地探讨 WhatsApp,包含各个端点组、多种语言的代码示例以及完整的限制说明。

API 速率限制是多少?

在所有套餐中,联系人和消息历史记录调用均限制为每 10 秒 10 次请求。在成长版、专业版和商业版中,模板发送分别限制为每 10 秒 30、60 或 100 次请求。当您触及限制时,将收到带有 Retry-After 标头的 HTTP 429 响应。如需更高的限制,请联系 Wati。

立即基于 WhatsApp 和 Instagram 构建应用。

免费开始并拨打您的第一个 API 调用,或者告诉我们您想要构建什么。