简短回答
通过 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 小时窗口已关闭 | 仅限已获批的模板 |
| 发送一次性验证码 | 身份验证模板 |
发送步骤
- 创建模板,填写名称、语言、类别和示例变量值,并提交 Meta 审核。
- 等待模板状态变为已批准。
- 调用发送接口,传入收件人、模板名称、语言和变量值。
- 保存返回的 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 获取。
