---
title: "如何通过 API 发送 WhatsApp 消息？"
description: "如何通过 API 发送 WhatsApp 消息：绑定 WhatsApp Business 账户、获批模板、遵守 24 小时窗口并跟踪每条消息的送达。"
canonical: "https://omnichannels.ai/zh/answers/send-whatsapp-message-api/"
language: "zh"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# 如何通过 API 发送 WhatsApp 消息？

Canonical: https://omnichannels.ai/zh/answers/send-whatsapp-message-api/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

**简短回答:** 通过 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 获取。

## 官方来源

- [Template fundamentals — Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview)
- [Send messages: customer service windows — Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages)
- [Pricing on the WhatsApp Business Platform — Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing)
- [Embedded Signup — Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview)

## 相关问题

- https://omnichannels.ai/zh/answers/whatsapp-24-hour-window/
- https://omnichannels.ai/zh/answers/how-to-get-whatsapp-business-api/
- https://omnichannels.ai/zh/answers/whatsapp-template-rejected/
- https://omnichannels.ai/zh/answers/whatsapp-otp-authentication-template/
- https://omnichannels.ai/zh/answers/delivery-report-webhook/

更新于: 2026-10-10