一套消息 API，覆盖八个渠道
用同一个基础 URL 和同一个 Bearer 令牌，在您自己的代码中发送短信、WhatsApp、RCS、Messenger、Instagram、Telegram、电子邮件和推送。通过 Webhook 跟踪每条消息，用 SMPP 扩展短信发送规模，并让 AI 智能体通过 MCP 使用同一套 API。
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "447700900123",
"message": "Your code is 482913",
"messageType": "TEXT"
}'
# 200 OK
2603121407537573731真实请求：POST /sms/sendSms 以纯文本形式返回消息 ID。请将令牌、Sender ID 和号码替换为您自己的值。
简短回答
更新于
OmniChannels.ai 为开发者提供一套 REST API，覆盖短信、WhatsApp、RCS、Messenger、Instagram、Telegram、电子邮件和推送。它提供 OpenAPI 3.1 规范中约 225 个已文档化的路径、TypeScript SDK、送达状态 Webhook、基于 TLS 的 SMPP v3.4，以及面向 AI 智能体的 MCP 服务器。测试权限仅向您自己验证过的号码发送，工程师会协助您完成对接，分销商可在自有品牌下使用同一套 API。
开发者能获得什么
一次对接即可覆盖客户使用的所有渠道，并配备生产团队所需的工具。
一套 REST API，八个渠道
短信、WhatsApp、RCS、Messenger、Instagram、Telegram、电子邮件和推送共用同一个基础 URL、同一个 Bearer 令牌和同一种错误格式，新增渠道只需调用新的接口，而不必更换服务商。
OpenAPI 3.1 与 TypeScript SDK
OpenAPI 3.1 规范中约 225 个已文档化的路径，可导入 Postman 或用于生成客户端；另有面向 TypeScript 和 Node.js 的官方 @broadnet/cpaas-sdk 包。
送达状态 Webhook
各渠道的状态已统一标准化（SUBMITTED、SENT、DELIVERED、READ、FAILED 和 REJECTED），并推送到您的 HTTPS 端点；同时提供轮询和重新推送接口作为兜底。
面向大批量短信的 SMPP v3.4
基于 TLS 的 Transceiver 绑定，支持 IP 白名单，按账户开通，与 REST API 使用相同的直连运营商线路。
面向 AI 智能体的 MCP 服务器
使用您的令牌将 Claude、Cursor 或任何 MCP 客户端连接到 API，让智能体在您设定的约束下发送消息并读取送达报告。
上线前先测试
测试凭证使用与生产环境相同的基础 URL，仅向您自己验证过的号码发送，因此切换到生产环境时代码无需改动。
工程师提供支持
消息工程师会评估您的使用场景，协助 REST 或 SMPP 的设计、Sender ID 和各国规则，并陪伴您直至上线。
为分销商而设计
分销商可在自有品牌下使用同一套 API；每个子账户拥有各自的额度、Sender ID、用户和 Webhook，并提供用于账户管理的分销商 API。
开发者能力一览
哪些功能现已可用，哪些需要与我们的团队一起开通。
| 项目 | 状态 | 详情 |
|---|---|---|
| REST API（短信、WhatsApp、RCS、Messenger、Instagram、Telegram、电子邮件、推送） | 已上线 | 基础 URL 为 https://api.broadnet.me，使用 Bearer 令牌认证。提交简短申请后发放测试权限。 |
| 送达状态 Webhook | 已上线 | 按账户或子账户配置，各渠道状态已标准化。 |
| TypeScript SDK | 已上线 | npm install @broadnet/cpaas-sdk axios。其他语言可直接调用 REST API 或生成客户端。 |
| OpenAPI 3.1 规范 | 已上线 | 公开地址为 https://omnichannels.ai/developers/openapi.json（YAML 版本位于 /developers/openapi.yaml）：包含客户令牌可调用的所有操作，适用于 Postman、Insomnia、客户端生成和 AI 编程工具。 |
| MCP 服务器 | 已上线 | 通过 Streamable HTTP 访问 https://mcp.broadnet.me/mcp，使用您的令牌认证。 |
| 基于 TLS 的 SMPP v3.4 | 按需提供 | 绑定、吞吐量和 IP 白名单由我们的团队按您的账户开通。 |
| 语音（验证码、IVR、外呼、AI 语音智能体） | 按需提供 | 由客户团队协助开通；REST API 中没有公开的语音接口。 |
从首次请求到上线
不提供即时自助注册。接入从一份简短申请开始，以便按您的渠道和国家来配置账户。
- 1
申请测试权限
告诉我们您的渠道、目标国家、发送量和使用场景。工程师审核申请后发放测试凭证。
- 2
发送第一条测试消息
按照快速入门，向您自己验证过的号码发送一条短信，并在您的 Webhook 上接收送达状态。
- 3
开发对接
添加所需渠道，处理错误和重试，并记录消息 ID。我们的工程师可以审阅您的 REST 或 SMPP 设计方案。
- 4
完成发送方报备
Sender ID、WhatsApp Business 账户和 RCS 智能体的报备与您的开发同步进行，并遵循各国及各平台的规则。
- 5
正式上线
为您的账户开启生产线路。您的代码继续调用同一个基础 URL，因此切换时无需任何改动。
这套 API 适合您的团队吗？
适合以下情况
- 您希望用一次对接覆盖短信、WhatsApp、RCS、社交消息、电子邮件和推送，而不是对接多家服务商。
- 您需要在自己的系统里获得逐条消息的送达状态，而不仅仅是在后台看板上查看。
- 您的短信发送量很大，希望在 REST 之外同时使用 SMPP。
- 您转售消息服务，需要在自有品牌下使用同一套 API，并使用子账户。
- 您正在构建需要通过 MCP 发送并跟踪消息的 AI 智能体。
开始前需要了解的事项
- 不提供即时自助注册；提交简短申请后才发放测试权限。
- 官方 SDK 仅支持 TypeScript；其他语言使用原生 HTTP 或根据规范生成的客户端。
- API 不支持幂等键，因此您的对接程序应在重试前先记录每次发送。
- 语音和 SMPP 由我们的团队协助开通，而不是通过公开接口。
- WhatsApp、Messenger 和 Instagram 的发送须遵循 Meta 的规则，包括已审核的模板和消息窗口。
文档
集成 API 所需的一切，从首次调用到 SMPP 绑定和 AI 智能体。技术文档以英文撰写。
- 快速开始· 英文快速入门：发送您的第一条消息获取测试凭证，用 cURL、Node.js、Python 或 PHP 发送第一条短信，接收送达状态，并了解上线前需要检查的事项。
- 快速开始· 英文身份验证如何用 Bearer 令牌验证 API 请求，安全地存储和轮换令牌，解读 401 响应，以及通过 OAuth 连接 Facebook 主页和 Instagram。
- 消息渠道· 英文短信 API发送单条和群发短信，选择 TEXT 或 UNICODE 编码，计算分段，定时发送，控制群发任务，并在发送前查询号码。
- 消息渠道· 英文WhatsApp Business API通过一个 multipart 接口发送 WhatsApp 模板、文本、媒体和交互式消息，管理模板和批量任务，并跟踪每位收件人的状态。
- 消息渠道· 英文RCS Business Messaging API发送 RCS 文本、媒体、富媒体卡片、轮播和建议回复，先检查设备能力，并为不支持 RCS 的用户规划短信回退。
- 消息渠道· 英文Facebook Messenger API通过 OAuth 连接 Facebook 主页，然后在 Meta 的消息窗口内发送 Messenger 文本、媒体、按钮和轮播模板以及快捷回复。
- 消息渠道· 英文Instagram 消息 API通过 OAuth 连接 Instagram 专业账户，并用 API 回复 Instagram 私信：文本、媒体、快捷回复、通用模板和表情回应。
- 消息渠道· 英文Telegram API从已连接的发送方发送 Telegram 文本、照片、文档、视频、位置和联系人消息，使用已保存的模板，并在沙盒中做冒烟测试。
- 消息渠道· 英文邮件 API通过您的 SMTP 发件方发送事务邮件和群发邮件，支持 HTML、模板、附件、抄送和定时发送，另有域名检查和沙盒发送。
- 消息渠道· 英文推送通知 API按用户标识、设备令牌、主题或用户分群向应用用户发送推送通知，支持图片、深度链接、操作按钮、模板和试运行。
- 消息渠道· 英文语音：验证码、IVR、通话与 AI 智能体OmniChannels.ai 上的语音能力，从语音验证码和 IVR 到 AI 语音智能体以及短信转语音回退，以及我们的团队如何为您的账户开通。
- 事件与错误· 英文Webhook 与送达状态在您的 HTTPS 端点接收送达状态和入站消息，快速响应，对事件去重，并在需要时轮询或重新触发状态。
- 事件与错误· 英文错误、重试与速率限制HTTP 状态码和错误响应体，哪些错误应通过退避与抖动重试，默认速率限制，分页，以及如何避免重复发送。
- 连接方式· 英文SMPP v3.4 连接何时使用 SMPP 而非 REST，绑定如何通过 TLS 开通，submit_sm 要点、编码、长短信拼接、送达回执和错误码。
- 工具· 英文面向 AI 智能体的 MCP 服务器将 Claude、Cursor、VS Code 等 MCP 客户端连接到消息 API，让 AI 智能体用您的令牌安全地发送和跟踪消息。
- 工具· 英文SDK、OpenAPI 规范与代码示例使用 TypeScript SDK，将 OpenAPI 3.1 规范导入 Postman 或 Insomnia，生成客户端，并通过 Java、.NET、Go 和 Ruby 调用 API。
- 工具· 英文OpenAPI 3.1 规范下载消息 API 的公开 OpenAPI 3.1 规范，导入 Postman 或 Insomnia，生成客户端和类型，并提供给 AI 编程工具使用。
- 工具· 英文在 Claude Code 中使用 MCP 服务器用 claude mcp add 将 OmniChannels.ai MCP 服务器添加到 Claude Code，通过 .mcp.json 共享，把令牌保存在环境变量中，并对发送类工具设置权限控制。
- 工具· 英文在 Cursor 中使用 MCP 服务器通过 .cursor/mcp.json 将 Cursor 连接到 OmniChannels.ai MCP 服务器，从环境变量读取令牌，开关各项工具，并发送第一条消息。
- 工具· 英文在 n8n 中使用 MCP 服务器通过 MCP Client Tool 节点为 n8n AI Agent 提供 OmniChannels.ai 消息工具，或调用 REST API 并用普通 n8n 节点接收送达状态。
- 工具· 英文通过 Webhook 使用 Make 和 Zapier在 Make 场景和 Zap 中通过 HTTP 请求调用 REST API 发送消息，并通过 Make 或 Zapier 的 Webhook 接收送达状态和入站消息。
API 如何融入您的技术栈
您的系统使用一个 Bearer 令牌调用一个 REST API。BroadNet 通过合适的渠道和运营商路由每条消息，并将送达状态回传到您的 Webhook。
您的应用、CRM 或 AI 智能体
- Bearer 令牌，统一基础 URL
- 基于 TLS 的 SMPP 3.4，适用于高并发
- 面向 AI 智能体的 MCP 服务器
BroadNet 消息 API
BroadNet 消息 APIhttps://api.broadnet.me您客户的手机
送达状态回传至您的 Webhook
SENTDELIVEREDREADFAILED
开发者常见问题
如何进行认证？
在每个请求的 Authorization: Bearer 请求头中携带账户的访问令牌。令牌按账户发放，不存在用用户名和密码换取令牌的接口。缺失或无效的令牌会返回 401。请将令牌保存在您的服务器上，切勿放入浏览器或移动端代码。
基础 URL 是什么？有单独的沙箱环境吗？
所有调用都发往 https://api.broadnet.me，不带版本前缀。测试与生产使用同一个基础 URL：测试凭证只向您自己验证过的号码发送，生产环境则在发送方审核通过后为您的账户开启，因此您的代码无需更改。
如何获取送达回执？
状态会推送到您账户上配置的 Webhook 地址：SUBMITTED、SENT、DELIVERED、在支持已读回执的渠道上的 READ、FAILED 和 REJECTED。您也可以主动轮询，例如用 GET /sms/list 查询短信群发任务，用 GET /whatsapp/message/bulk-insights 查询 WhatsApp 批次。
如何处理重试和重复发送？
仅对网络错误、429 和 5xx 响应进行重试，并采用指数退避加抖动，切勿在不做修改的情况下重试 4xx 错误。由于 API 不支持幂等键，请在发送前先记录每次发送，保存返回的消息 ID，并在超时后先检查状态再决定是否重新发送。
有哪些速率限制？
文档中的默认值为：REST 每秒 200 个请求，可突发至 500 个并持续最多 60 秒；每个 SMPP 绑定每秒 1,000 条消息；号码查询每秒 50 个请求。您账户的具体限额会随凭证一并确认。超限请求会返回 429，并带有 Retry-After 响应头。
支持哪些编程语言？
任何能够发起 HTTPS 请求的语言。我们提供官方 TypeScript SDK（@broadnet/cpaas-sdk），文档中还包含 cURL、Node.js、Python、PHP、Java、.NET、Go 和 Ruby 的原生 HTTP 示例。您也可以根据 /developers/openapi.json 提供的公开 OpenAPI 3.1 规范生成客户端。
短信应该用 REST 还是 SMPP？
REST 适合大多数应用，并能通过一套 API 使用所有渠道。基于 TLS 的 SMPP v3.4 适合持续的大批量短信发送，尤其是在您已经运行 SMPP 客户端的情况下。绑定、吞吐量和 IP 白名单按账户开通，同一个账户也可以两者并用。
可以通过 API 转售消息服务吗？
可以。分销商在自有品牌下使用同一套 API。每个子账户拥有各自的额度、Sender ID、用户和 Webhook，分销商 API 则涵盖开户、充值、费率表管理和报表。申请接入时请说明您有转售需求，以便我们与您一起搭建账户结构。
相关指南
- 集成消息API对接指南：REST、SMPP与Webhook9 分钟阅读
- 营销已发送、已送达、已读、失败：消息状态详解8 分钟阅读
- 集成如何通过 Webhook 将 CRM 接入全渠道收件箱8 分钟阅读
- 短信与验证码WhatsApp与短信验证码指南：安全、送达与防欺诈9 分钟阅读
- WhatsAppWhatsApp Cloud API 错误码：含义与排查方法8 分钟阅读
- 短信与验证码什么是A2P短信？企业短信如何抵达手机8 分钟阅读
了解平台更多功能
申请测试权限
告诉我们您的渠道、国家和发送量。工程师会为您已验证的号码配置测试凭证，并协助您规划上线到生产环境。
请分享您的技术栈以及想要连接的内容，解决方案工程师会与您跟进。