跳转到正文
OmniChannels.ai

API 与 SMPP

如何通过 API 发送 WhatsApp 消息?

更新于

简短回答

通过 API 发送 WhatsApp 消息,需先经 Meta 合作伙伴或 Cloud API 绑定 WhatsApp Business 账户,收集订阅同意并获批模板。发送模板开启会话;客户回复后,可在 24 小时服务窗口内发送自由格式消息。

首次发送前需要准备什么

  • 一个 WhatsApp Business 账户(WABA),通常通过合作伙伴的 Meta Embedded Signup 流程创建,并带有已验证的企业电话号码和显示名称。
  • 至少一个已获批的消息模板,类别为营销、实用型(Utility)或身份验证。
  • 按 Meta 政策要求,取得每位收件人的订阅同意(opt-in)。
  • 计费安排。自 2025 年 7 月 1 日起,Meta 按送达消息收费,并依消息类别和收件人所在市场而定;请查看 Meta 最新价目表。

用模板还是自由消息?

自 2026 年 10 月 1 日起,在每个企业电话号码每月 1,000 条免费服务消息之后,Meta 还会对窗口内发送的服务消息和实用型模板收费。

情形可以发送的内容
由您发起会话仅限已获批的模板
客户在最近 24 小时内给您发过消息任何消息类型:文本、媒体、互动消息或模板
24 小时窗口已关闭仅限已获批的模板
发送一次性验证码身份验证模板

发送步骤

  1. 创建模板,填写名称、语言、类别和示例变量值,并提交 Meta 审核。
  2. 等待模板状态变为已批准。
  3. 调用发送接口,传入收件人、模板名称、语言和变量值。
  4. 保存返回的 ID,然后在 Webhook 上跟踪 SENT、DELIVERED、READ 或 FAILED。

示例:发送模板消息

在 OmniChannels.ai 上,每条 WhatsApp 消息都通过 POST https://api.broadnet.me/whatsapp/message/sendbulk 发送,请求格式为 multipart 表单数据,并带 Bearer 令牌。将 messageType 设为 TEMPLATE,并传入 destinationNo、templateName、templateLanguage 和 bodyTemplateVariables。调用会返回 batchId,各收件人的状态会推送到您的 Webhook,或通过 GET /whatsapp/message/bulk-insights 获取。

官方来源