渠道
一个端点，七种渠道类型
OmniMessage 是一个自带渠道的网关。您连接自己已有的发送方，所有发送方都以相同的方式寻址、跟踪和计费。
自带渠道
只需连接一次，通过控制台或 API 均可
发送方连接后即成为一个带 ID 的渠道。该 ID 是发送请求中唯一与渠道相关的值。
发送方归您所有
号码、机器人或账号均以您的名义在服务商处注册。即使不再使用 OmniMessage，发送方仍然是您的。
两份独立账单
OmniMessage 按每条出站消息收取网关费。Meta、Twilio 或其他服务商针对渠道收取的费用，由他们直接向您收取。
登录授权或粘贴凭据
WhatsApp、Messenger 和 Instagram 通过在控制台中使用 Facebook 登录来授权，TikTok 则使用 TikTok 登录来授权。Telegram、SMS 和 SMS OTP 需在控制台中或通过 API 提供凭据；已接入 Cloud API 的 WhatsApp 号码也可以用这种方式连接。
凭据只写不读
令牌、验证码和凭据会在您连接渠道时传递给投递层。网关不会存储这些信息，API 也绝不会返回它们。
curl https://api.omnimessage.co/v1/channels \
-H "Authorization: Bearer om_live_..." \
-H "Content-Type: application/json" \
-d '{
"type": "whatsapp",
"name": "Support line",
"identifier": "+971800123456",
"credentials": {
"wab_account_id": "...",
"phone_number_id": "...",
"access_token": "..."
}
}'{
"id": "ch_7Hq2mN5vB8cX1zL0pK3j",
"object": "channel",
"mode": "live",
"type": "whatsapp",
"name": "Support line",
"identifier": "+971800123456",
"status": "active",
"connection_status": "pending",
"capabilities": ["text", "attachments", "template", "button", "list", "location", "contacts", "cta_url"],
"created_at": "2026-10-01T08:00:00.000Z"
}适用于 WhatsApp、Telegram、SMS 和 SMS OTP。需要 channels:write 权限范围。订阅 channel.connected 和 channel.disconnected 即可跟踪连接状态。
WhatsApp Business
从您自己的 WhatsApp Business Platform（Cloud API）电话号码发送消息。OmniMessage 将您的消息转发至 Cloud API，并向您回报已发送、已送达、已读和失败状态。
每条出站消息 $0.001，或 1 个套餐点数
- 所需条件
- 一个有权访问您的 Meta 商务组合的 Facebook 登录账号。在控制台中选择通过 Facebook 继续，Meta Embedded Signup 会完成 WhatsApp Business 账号和号码的设置。已接入 Cloud API 的号码也可以凭其 ID 和系统用户访问令牌，在控制台中或通过 API 连接。
- API 凭据
wab_account_idphone_number_idaccess_token- 渠道类型
whatsapp- 发送方标识
- E.164 格式的发送方电话号码，例如
+971800123456。 - 接收方（
to） - E.164 格式的电话号码。
- 注意事项
- 在 24 小时客户服务窗口之外，WhatsApp 仅接受已获批准的模板消息。
- 使用
GET /v1/channels/:id/templates列出渠道已获批准的模板。 - Meta 会话费由 Meta 向您的 WhatsApp Business 账号收取，与网关费相互独立。
SMS
从您自己 Twilio 账号下的 Twilio 电话号码发送 SMS。可用于通知、提醒和双向会话，入站消息会投递到您的 Webhook。
每条出站消息 $0.0005，或 1 个套餐点数
SMS OTP
专为验证码设计的渠道类型。它只接受纯文本，因此登录流程不会误用它发送其他内容。
每条出站消息 $0.0005，或 1 个套餐点数
- 所需条件
- 您的 OTP SMS 服务商账号及其 API 密钥。
- API 凭据
api_key- 渠道类型
sms_otp- 发送方标识
- 在您的服务商处注册的发送方 ID 或号码。
- 接收方（
to） - E.164 格式的电话号码。
- 消息类型
- 文本
- 注意事项
- 仅限文本。附件和交互式类型会被拒绝，并返回
unsupported_message_type。 - 服务商费用由您的服务商收取，与网关费相互独立。
- 仅限文本。附件和交互式类型会被拒绝，并返回
Telegram
通过您创建的 Telegram 机器人发送消息。机器人令牌是唯一的凭据，向机器人发消息的用户会以 message.received 事件的形式到达。
每条出站消息 $0.0003，或 1 个套餐点数
Messenger
使用文本、媒体和回复按钮，回复联系您 Facebook Page 的用户。入站消息会连同回复所需的发送方 ID 一起到达您的 Webhook。
每条出站消息 $0.0005，或 1 个套餐点数
使用文本、媒体和回复按钮回复发送到您 Instagram 专业账号的私信，所用端点与其他所有渠道相同。
每条出站消息 $0.0005，或 1 个套餐点数