渠道方對比
統一訊息發送能力
呼叫 POST /v1/messages 時，各 provider 支援的訊息 payload 型別與渠道專屬擴充欄位。
能力
| 能力 | 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 僅接受作為 media 附件的音訊，不支援獨立語音訊息。
- 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 已棄用。