プロバイダ比較
統一メッセージ送信の対応状況
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 は非推奨です。