← API 參考
渠道方對比

統一訊息發送能力

目前 POST /v1/messages 轉接器已映射的訊息 payload。實際開放範圍與上游可用性仍可能因帳號和區域而異。

能力

能力TelegramWhatsAppXLINEZaloTikTok
text 文字完整支援完整支援完整支援完整支援完整支援完整支援
image 圖片完整支援完整支援完整支援完整支援完整支援完整支援
video 影片完整支援完整支援完整支援完整支援完整支援完整支援
audio 音訊完整支援完整支援部分支援完整支援完整支援不支援
document 檔案完整支援完整支援完整支援完整支援完整支援不支援
file 檔案完整支援完整支援完整支援完整支援完整支援不支援
contact 聯絡人名片不支援完整支援不支援不支援不支援不支援
reply_to.reply_token 引用回覆不支援完整支援不支援不支援不支援不支援
mentions @ 成員不支援完整支援不支援部分支援不支援不支援
provider_data.parse_mode 富文字完整支援不支援不支援不支援不支援不支援

備註

  • WhatsApp 音訊訊息的 content 必須是 JSON 字串 {"url":"...","seconds":N,"waveform":"..."}，其中只有 url 是必填。
  • parse_mode（Markdown / HTML）目前僅在 Telegram 完整生效，其他渠道會忽略此欄位。
  • X 僅接受作為 media 附件的音訊，不支援獨立語音訊息。
  • X 會將 document 載荷作為媒體附件傳送；仍需遵守上游的檔案類型與大小限制。
  • 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 支援文字與媒體 caption；LINE 目前只支援文字 mention。其他渠道忽略該欄位。provider_data.mentions 已棄用。
  • TikTok image / video 僅支援 url 或 file_url，不支援 caption 或 mentions。