---
title: "一套消息 API，覆盖八个渠道"
description: "一套 REST API 覆盖短信、WhatsApp、RCS、Messenger、Instagram、Telegram、邮件和推送，支持 Webhook、SMPP、SDK 与 MCP 服务器。"
canonical: "https://omnichannels.ai/zh/developers/"
language: "zh"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# 一套消息 API，覆盖八个渠道

Canonical: https://omnichannels.ai/zh/developers/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

用同一个基础 URL 和同一个 Bearer 令牌，在您自己的代码中发送短信、WhatsApp、RCS、Messenger、Instagram、Telegram、电子邮件和推送。通过 Webhook 跟踪每条消息，用 SMPP 扩展短信发送规模，并让 AI 智能体通过 MCP 使用同一套 API。

**简短回答:** 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 的规则，包括已审核的模板和消息窗口。

## 开发者常见问题

### 如何进行认证？

在每个请求的 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 则涵盖开户、充值、费率表管理和报表。申请接入时请说明您有转售需求，以便我们与您一起搭建账户结构。

更新于: 2026-10-10