LINEで受信した動画・音声を取得できないとき|202と取得準備の確認
この記事の結論
Messaging APIで受け取った動画・音声の取得が202になるとき、processing・succeeded・failedを確認します。イベント受信、ファイル取得、保存、担当者の確認を分け、再送依頼の前に調べる手順を整理します。
最終更新:2026年11月15日
Messaging APIで、ユーザーから届いた動画・音声の取得にHTTP 202 が返る場合、LINE側でデータの取得準備が続いており、まだファイル本体を受け取れていないことがあります。Webhookを受信したことだけで、動画の保存まで完了したと判断しないでください。
この記事の対象は、顧客からLINE公式アカウントへ送られたコンテンツを自社システムで取得する処理です。こちらから配信した動画が相手の端末で再生できない場合は、送信用動画のURL・形式・端末の確認を参照してください。
まず、取得する対象とAPIをそろえる
コンテンツ取得の公式仕様では、Webhookで受信したメッセージIDを使い、ユーザーから届いた画像・動画・音声・ファイルを取得します。動画・音声は、イベントの contentProvider.type が line であることも確認します。別の提供元を同じ取得先で扱わないでください。
取得先のドメインは api-data.line.me です。メッセージ送信などで使う api.line.me と取り違えないようにします。コンテンツ取得はGETで、パスは次の形です。
/v2/bot/message/{id}/content
{id} には対象イベントのメッセージIDを使い、チャネルアクセストークンで認証します。ユーザーIDや、別の添付ファイルのIDを代入しません。調査時も、顧客の動画を公開URLへ置き直して確認する方法は避け、閲覧権限のある環境で扱います。
202なら、取得準備の状況を確認する
サイズの大きい動画・音声では、取得できるまでに時間がかかることがあります。公式仕様は、準備中のコンテンツ取得が 202 を返し、バイナリデータを取得できない場合を説明しています。
この場合は、同じメッセージIDを使い、動画・音声の取得準備を確認するAPIへ進みます。ドメインは同じ api-data.line.me、HTTPメソッドはGETです。
パスは、上のコンテンツ取得パスの末尾へ /transcoding を付けた形です。途中の {id} は、取得しようとしている動画・音声のメッセージIDのままにします。
このAPIのHTTP 200 は、状況を返すリクエストが成功したという意味です。JSON内の status まで読みます。
processing:準備中です。ファイル取得済み・保存済みにはせず、次の確認を予定します。succeeded:取得の準備が完了しています。コンテンツ取得APIで本体を取得し、自社側の保存結果を確認します。failed:準備に失敗しています。自社の保存成功へ進めず、対象とエラーを記録して次の案内を判断します。
succeeded は「保存済み」ではありません。状況を返すJSONを動画ファイルとして保存してしまわないよう、二つのAPIの応答を分けて扱います。

何度も再送を頼む前に、止まっている段階を見る
以下は、顧客から商品の状態を撮った動画を受け取る架空の例です。導入実績や実機試験の結果ではありません。
Webhookは届いているのに担当者の画面へ動画が出ない場合、顧客へすぐ「送れていないので再送してください」と返す前に、取得準備中なのか、本体取得に失敗したのか、保存後の表示で止まったのかを調べます。
準備中の再確認は、実装側で間隔と打ち切り条件を決めます。一定秒数後に必ず終わるという保証は置かず、無制限に呼び出し続けない設計にします。長く未完了なら技術担当へ渡し、顧客への返答担当も残してください。これらは運用設計の提案です。
受信記録すら見つからない場合は、コンテンツの準備状態以前の問題です。Webhookの配送・受信・処理の切り分けから確認します。Webhookを正常に受け付けた応答と、その後のファイル取得結果を同じ成功欄へまとめないようにします。
写真・ファイルの閲覧権限や送信取消への対応は、受信した添付資料の扱いで整理しています。本稿の準備状況確認と合わせて設計してください。
本体を取得した後も、保存と閲覧を確認する
コンテンツ取得APIが正常に返すのはHTTP 200 とバイナリデータで、形式は Content-Type ヘッダーで確認できます。内部で縮小などの変換が行われる場合もあるため、受け取ったものが必ず送信時の元ファイルと同一だとは扱いません。
公式仕様では、コンテンツは一定期間後に自動で削除され、保存期間は保証されません。「明日もAPIから取れる」と決めず、業務で必要な範囲について保存先、閲覧できる担当者、保管期間を決めます。管理画面のチャット履歴の保存期間を、このAPIから取得できる期間へ読み替えないでください。
取得時に 404 や 410 などが返った場合も、まず対象ID、取得先、応答内容を記録します。そのコードだけで顧客が送信していなかったと断定しません。再送が必要と判断した場合は、必要な資料と理由を絞って案内します。
担当者へ渡す記録には、次の項目があると続きから確認できます。
- 対象チャネル、受信時刻、対象メッセージを内部で照合できる記録先。
- コンテンツ取得のHTTP結果と、準備状況の
status。 - 本体取得・保存・画面表示のどこまで確認したか。
- 次に調べる人、顧客へ返す人、返答の予定。
共有メモへトークンや動画本体、会話全文を複製する必要はありません。元の会話と権限のある保存先を結び付け、内容を確認する担当者が迷わず続きを開けるようにします。ファイルの取得に成功しても、相談への回答が終わったことにはならないため、残る仕事は別に追います。
仕様確認:2026年11月15日。実際の顧客データを使った取得・保存・送受信や、導入効果は未確認です。