如何用 API 发送 WhatsApp 消息

发布于 2026年8月23日

有时仅做校验还不够——你需要真正发送一条 WhatsApp 消息：一条引导文案、一条通知、一条客服回复或一条交易提醒。WhatsApp 消息 API 让你通过普通 HTTP 完成这些：创建会话、绑定 WhatsApp 账户，然后从该账户发送消息。

本指南带你发出第一条消息。

工作原理

发送是基于会话的。一个会话代表一个已绑定的 WhatsApp 账户，流程如下：

  1. 创建会话 —— 拿到会话 ID 和登录二维码。
  2. 绑定账户 —— 用你要发送消息的 WhatsApp 账户扫描该二维码。
  3. 发送消息 —— 携带会话 ID 调用发送接口。

第一步 —— 获取 API Key

注册并在控制台复制一个有效 Key。账户赠送免费点数，可完整跑通整个流程。

第二步 —— 创建会话

curl -X POST "https://api.opendata-api.com/api/project/whatsapp-messaging/create-session?key=你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"qr","deviceName":"My Bot"}'

响应会包含会话 ID 以及用于展示登录二维码的数据。用你要发送消息的 WhatsApp 账户扫描它——就像绑定 WhatsApp 网页版一样。

第三步 —— 发送消息

会话绑定后，传入会话 ID 以及 to 号码（E.164 纯数字）和 text 即可发送文本：

curl -X POST "https://api.opendata-api.com/api/project/whatsapp-messaging/send-message?key=你的API_KEY&sessionId=SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{"to":8613800138000,"text":"Hello from the API!"}'

除文本外，该项目还支持富媒体、聊天、群组、联系人、在线状态等更多能力——完整接口列表见项目页。

重要：请负责任地使用

WhatsApp 会严格管控自动化与批量消息，滥发垃圾信息的账户会被封禁。为保持良好状态：

  • 只发给有预期的人 —— 已授权的用户、客户、交易通知接收人。
  • 不要群发冷名单。 先校验号码（见 WhatsApp 查询指南），只触达可送达且已同意的联系人。
  • 遵守 WhatsApp 条款以及你业务所在地的消息/隐私法规。

立即体验

在 WhatsApp 消息页面浏览完整接口集，并阅读 create-session 与 send-message 接口文档。查看定价了解每次请求成本。