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

WhatsApp Groups API

WhatsApp 群组 API:创建群组,通过代码保持更新。

为课程班级、VIP 俱乐部或支持案例创建 WhatsApp 群组,并从您自己的系统中向其发送更新。

最后更新于

WhatsApp 群组功能现状

功能使用方式状态
创建群组并通过您的系统发送更新REST API即将推出

Wati API 中暂无群组端点。欢迎与我们讨论您的用例。

  • 16,000+家企业,遍布 190 多个国家/地区
  • 4.6/5G2 平均评分
  • 官方Meta 业务合作伙伴与 WhatsApp BSP
G2 领导者,聊天机器人G2 中端市场领导者,聊天机器人G2 势头领导者,聊天机器人G2 最易实施,WhatsApp 营销ISO 27001GDPR

一个群组。所有人同步最新动态。

班级、俱乐部和支持案例尽在一个 WhatsApp 群组中,由您的系统保持最新。

  • 从模板开始通过已批准的模板开启对话,无论是面向单个客户还是 10,000 名客户。
  • 在聊天中继续客户回复后即可发送文字、多媒体和按钮。
  • 交由您的团队收尾Webhooks 通知您的代码。团队收件箱通知您的员工。
产品

发送。回复。收到反馈。转交给人工。

群发

个性化消息,大规模发送。

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

消息传递

回复内容远不止纯文本。

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

订单更新与提醒

在恰当的时间,提供恰当的更新。

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

自动回复和聊天机器人

您的代码来回答。

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

Webhooks

每次回复,即时送达。

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

团队收件箱

代码开启,人工完成。

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

联系人和分群

您的 CRM,在 Wati 中镜像呈现。

通过自定义属性创建和更新联系人,然后在向其发送消息之前预览分群。

InstagramInstagram 评论和私信

构建 Instagram 自动化。

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

快速上手

三步即可上线。

  1. 连接

    连接您的号码

    通过 Wati 内置的 Meta 嵌入式注册(Embedded Signup)链接您的 WhatsApp 号码。

  • 认证

    获取令牌

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

  • 发送

    发起您的第一次调用

    通过一个请求发送经过批准的模板。然后添加 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 仅为示例。具体措辞由您批准的模板决定。

    Fragment 1 of 5. Translate only the text inside this item.
    随时可用的代码隐藏代码
    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": "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": []
        }
      ]
    }
    内置功能

    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 参考文档是公开的。阅读文档

    如何获取 WhatsApp 群组 API 的访问权限?

    与我们联系以获取访问权限。分享您的使用场景(例如课程班级、VIP 俱乐部或支持工单),Wati 团队将为您介绍适合您账户的选项。

    WhatsApp 群组 API 可以用来做什么?

    群组适用于围绕一个主题与多人进行对话的场景:需要调整日程的课程班级、获得优先访问权限的 VIP 俱乐部,或者将您的团队与客户员工聚集在一起的支持工单。您的系统创建群组并向其中发布更新。

    目前可以使用什么来发送一对多更新?

    广播 API。它每次调用可向最多 10,000 人发送一个已批准的模板,并提供每个收件人的结果。每个人都会在自己的独立聊天中收到消息,而不是在群组中。

    我需要懂编程吗?

    比以前要求更低了。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 连接到您自己的系统。您可以批量发送已批准的模板、自动回复、接收 webhooks 并在团队收件箱中共享一个号码。

    我的套餐包含哪些端点?

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

    您的第一条消息只需一个请求即可发送。

    获取访问权限,在 Wati 中连接您的 WhatsApp 号码并进行您的第一次调用。

    {"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"如何获取 WhatsApp 群组 API 的访问权限?","acceptedAnswer":{"@type":"Answer","text":"与我们联系以获取访问权限。分享您的使用场景(例如课程班级、VIP 俱乐部或支持工单),Wati 团队将为您介绍适合您账户的选项。"}},{"@type":"Question","name":"WhatsApp 群组 API 可以用来做什么?","acceptedAnswer":{"@type":"Answer","text":"群组适用于围绕一个主题与多人进行对话的场景:需要调整日程的课程班级、获得优先访问权限的 VIP 俱乐部,或者将您的团队与客户员工聚集在一起的支持工单。您的系统创建群组并向其中发布更新。"}},{"@type":"Question","name":"目前可以使用什么来发送一对多更新?","acceptedAnswer":{"@type":"Answer","text":"广播 API。它每次调用可向最多 10,000 人发送一个已批准的模板,并提供每个收件人的结果。每个人都会在自己的独立聊天中收到消息,而不是在群组中。"}},{"@type":"Question","name":"我需要懂编程吗?","acceptedAnswer":{"@type":"Answer","text":"比以前要求更低了。AI 应用构建器可以通过简单的英文指令编写 API 调用,本页面上的示例也展示了每次调用。在开始对话之前,您仍然需要一个连接到 Wati 的 WhatsApp 号码、一个 API 令牌以及一个经 Meta 批准的模板。如果 AI 工具编写了代码,请确保您的令牌保留在服务器上。"}},{"@type":"Question","name":"API 速率限制是多少?","acceptedAnswer":{"@type":"Answer","text":"在所有套餐中,联系人和消息历史记录调用均限制为每 10 秒 10 个请求。模板发送在成长版 (Growth)、专业版 (Pro) 和商业版 (Business) 中分别限制为每 10 秒 30、60 或 100 个请求。当您达到限制时,您将收到带有 Retry-After 标头的 HTTP 429。如需更高的限制,请联系 Wati。"}},{"@type":"Question","name":"我可以随时给客户发消息吗?","acceptedAnswer":{"@type":"Answer","text":"在 WhatsApp 上,自由格式的文本、媒体和交互式消息需要处于开放的 24 小时客户服务窗口内。在该窗口之外,请使用经 Meta 批准的模板来开启对话。"}},{"@type":"Question","name":"WhatsApp 商业应用与 API 有什么区别?","acceptedAnswer":{"@type":"Answer","text":"商业应用适用于手机上的手动聊天,最多支持 5 台关联设备,广播列表上限为 256 个联系人。API 将 WhatsApp 连接到您自己的系统。您可以批量发送已批准的模板、自动回复、接收 webhooks 并在团队收件箱中共享一个号码。"}},{"@type":"Question","name":"我的套餐包含哪些端点?","acceptedAnswer":{"@type":"Answer","text":"核心消息传递、模板和联系人端点包含在所有套餐中。团队分配、聊天状态、聊天机器人和自定义分群需要专业版或商业版。文档按套餐列出了端点的可用性。"}}]}