API リファレンス
プロバイダ比較

統一メッセージ送信の対応状況

現在の POST /v1/messages アダプタがマップするメッセージペイロード。実際の提供範囲と上流可用性はアカウントやリージョンで異なる場合があります。

機能

機能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 ではメディア添付の一部としての音声のみ受け付け、単独のボイスメッセージは送信できません。
  • X は document ペイロードをメディア添付として送信します。上流のファイル形式とサイズ制限は引き続き適用されます。
  • reply_to.reply_token は引用返信用:受信イベントの data.message.reply_token をそのまま渡してください。現在は WhatsApp のみ — 他のプロバイダは 501 unsupported_by_provider、改ざんされた token は 400 invalid_reply_token になります。
  • mentions はグループメンバーのメンション用です。WhatsApp はテキストとメディア caption、LINE は現在テキストのみ対応します。他のプロバイダはこのフィールドを無視します。provider_data.mentions は非推奨です。
  • TikTok の image / video は url または file_url のみで、caption と mentions には対応しません。