渠道方对比
统一消息发送能力
调用 POST /v1/messages 时，各 provider 支持的消息载荷类型和渠道特有扩展字段。
能力
| 能力 | Telegram | Twitter / X | LINE | Zalo | |
|---|---|---|---|---|---|
| text 文本 | 完整支持 | 完整支持 | 完整支持 | 完整支持 | 完整支持 |
| image 图片 | 完整支持 | 完整支持 | 完整支持 | 完整支持 | 完整支持 |
| video 视频 | 完整支持 | 完整支持 | 完整支持 | 完整支持 | 完整支持 |
| audio 音频 | 完整支持 | 完整支持 | 部分支持 | 完整支持 | 完整支持 |
| document 文件 | 完整支持 | 完整支持 | 不支持 | 完整支持 | 完整支持 |
| reply_to.reply_token 引用回复 | 不支持 | 完整支持 | 不支持 | 不支持 | 不支持 |
| mentions @ 成员 | 不支持 | 完整支持 | 不支持 | 不支持 | 不支持 |
| provider_data.parse_mode 富文本 | 完整支持 | 不支持 | 不支持 | 不支持 | 不支持 |
备注
- WhatsApp 音频消息的 content 必须是 JSON 字符串 {"url":"...","seconds":N,"waveform":"..."}，其中只有 url 是必填。
- parse_mode（Markdown / HTML）目前只在 Telegram 上完整生效，其他渠道会忽略该字段。
- Twitter 仅接受作为媒体附件的音频，不支持独立的语音消息。
- Twitter 不支持任意文档附件，请先转换为图片或外链再发送。
- reply_to.reply_token 用于引用回复：把入站事件里的 data.message.reply_token 原样回传。当前仅 WhatsApp 支持——其他渠道返回 501 unsupported_by_provider；token 被篡改返回 400 invalid_reply_token。
- mentions 用于群消息 @ 成员：在 mentions 数组里声明 id，并在 text / caption 中放置 {{@<id>}} 锚点。仅 WhatsApp 支持；其他渠道忽略该字段，占位符按原文发出。provider_data.mentions 已废弃。