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。