メディアの送信：画像、動画、音声、文書
メディアは、ファイルを先にアップロードして返された id を指定する方法と、Meta に取得させる公開リンクを渡す方法で送信できます。アップロードのほうが信頼性が高く、サイズ上限は種類ごとに異なるため注意が必要です。
種類ごとの上限
種類ごとに異なり、上限を超えると説明的なエラーではなく error 131053 が返ります。
- 画像：5 MB。JPEG と PNG。
- 動画：16 MB。MP4 と 3GPP。動画は H.264、音声は AAC。
- 音声：16 MB。AAC、AMR、MP3、MP4 音声、Opus を使用する OGG。
- 文書：100 MB。PDF や Office 形式を含む、一般的な文書形式の多くに対応します。
- ステッカー：アニメーションは 100 KB、静止画は 500 KB。WebP のみ。
アップロードとリンクの比較
同じファイルを送る方法は 2 つありますが、失敗の仕方が異なります。
アップロードでは、まずファイルを Meta に送信し、送信時に指定する media id が返されます。リンクでは、送信時に Meta が取得する URL を渡します。リンクの方法は簡単に見えますが、見えない失敗要因が増えます。ブラウザーで開ける URL でも、地域制限、ファイアウォールルール、ブラウザーが保持しているセッション Cookie により、Meta のインフラから到達できない場合があります。
アップロードしてください。リクエストは 1 回増えますが、失敗要因を 1 つの種類ごと取り除けます。
メディアの受信
受信したメディアはバイトデータではなく media id として届きます。ハンドラーは、その id を使ってファイルを別途取得します。
- すぐに取得してください。id は無期限に有効ではありません。
- 取得に失敗すると error 131052 が返ります。通常は送信者のアップロードが完了していないことを意味します。
- 後で必要になる場合は、ファイルを自分で保存してください。Meta はアーカイブではありません。
- メディアの取得に失敗してもメッセージを記録し、テキストとコンテキストを残してください。
Coexistence で変わること
Coexistence 番号のメディアは、他の Cloud API 番号とまったく同じように動作し、上限も同じです。
知っておくべき唯一の違いは履歴です。番号を初めて接続すると、Meta は WhatsApp Business アプリから最近のメッセージを同期します。ただし、この同期の対象はメッセージ本文であり、メディア全体のアーカイブではありません。接続前のメディアは、これまでどおり電話に保存されています。
よくある間違い
- 簡単に見えるからとリンクを送る。Meta のネットワークはブラウザーと同じではありません。
- 受信メディアを数時間後に取得する。メディア id には有効期限があります。
- コーデックを確認せずに動画を書き出す。編集ソフトの初期設定は対応していないことがあります。
EasyCoexistence は Meta からの受信メッセージイベントを直接エンドポイントに届けるため、メディア id がすぐにシステムへ届き、有効なうちに取得できます。
よくある質問
送信できる最大ファイルサイズは？
100 MB です。ただし文書のみです。動画と音声は 16 MB、画像は 5 MB が上限です。
アップロードと URL のどちらを使うべきですか？
アップロードしてください。到達不能を失敗の原因から取り除けます。
メディア id はどのくらい有効ですか？
無期限ではありません。そのため、受信イベントが届いたらすぐにメディアを取得してください。
接続時に古いメディアも同期されますか？
いいえ。履歴の同期対象は最近のメッセージ内容です。接続前のメディアは電話に残ります。
続きを読む
始める準備はできましたか？
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日