LINEで複数写真の順序がずれるとき|imageSetで確認する受信と保存
この記事の結論
まとめて送られた写真がCRMで前後する・足りないとき、Messaging APIのimageSetを確認。届く順番と画像の順番、重複、総数不明、ファイル保存を分けて調べる手順を解説します。
最終更新:2026年11月17日
お客様がまとめて送った写真でも、Webhookは写真の順番どおりに届くとは限りません。 外部のチャット画面で写真が前後するときは、受信した順に並べていないかを調べます。画像メッセージの imageSet に順序や総数があれば、それを確認できます。
この記事はMessaging APIで受信した複数画像を、自社システムやCRMへ取り込む担当者向けです。LINEアプリ自体の写真の並びを変更する手順ではありません。ファイル一枚の取得失敗は添付ファイルの受信・保存で扱います。
受信順と、写真の順番を分ける
画像メッセージの公式仕様には、同時送信された画像について次の情報があります。
| 項目 | 確認すること |
|---|---|
imageSet.id | 同時に送られた画像のセット |
imageSet.index | セット内の順番。1から始まる |
imageSet.total | セットに含まれる画像の総数 |
message.id | 各画像メッセージのID |
imageSet の三項目は常にそろう必須項目ではありません。セット情報は複数画像を同時送信した場合の情報で、Android版LINE 11.15以前からの送信では index と total が含まれないと公式に記載されています。
同じセットの2番目、1番目、3番目という順に届いても、それだけでは送信失敗ではありません。timestamp やサーバーの受信時刻だけで、お客様が送った写真の順番を推定しないようにします。
三枚届いたかは、通知の回数で数えない
架空の例として、修理相談で三枚の写真を受け付ける場面を考えます。セット内の番号が「2、1、2、3」の順に処理へ渡り、二度目の2が同じイベントの再配達だったとします。
通知は四回でも、新しい写真が四枚になったわけではありません。Webhookの重複対策に従ってイベントIDを照合し、画像メッセージごとの記録も確認します。再配達かどうかのフラグだけで処理済みと判定せず、最初の保存が完了したかも追います。
次のように状態を分けると、調査する場所が明確になります。これは実装を検討するための例であり、LINEがCRM側の状態を自動管理する機能ではありません。
- 番号1と2を受信、総数3:番号3の受信記録を確認する段階。
- 番号1・2・3を受信、保存は二枚:受信ではなく、未保存の一枚の取得・保存を調べる段階。
- 三枚を保存、画面では二枚:表示対象、権限、読み込み結果を調べる段階。

セットを結び付ける前に、同じ相談か確認する
実装側では、対象の公式アカウント、トークの種類と識別子、送信者の情報、セットIDを対応させる方法を決めます。これは、異なる相談の写真を混ぜないための設計上の確認です。セットIDがあらゆるシステムを通じて一意だと保証されたものとして、他の識別情報を捨てないでください。
グループではトークのIDと送信者のIDは役割が異なります。取得できない送信者情報を表示名から補ったり、近い時刻に届いたという理由だけで別セットをまとめたりしません。会員IDとの紐付けも、既に確認できた関係だけを使います。
index の重複や total の食い違いがある場合は、そのまま完了にしません。同じイベントの再配達なのか、保存先の紐付けや上書きで混ざったのかを確認できるよう、元のイベントIDとメッセージIDの対応を残します。
順序や総数がない場合は「不明」を残す
imageSet がない画像を「一枚しか送っていない」と断定する必要はありません。また、セットIDだけ分かっても、総数がなければ「これで全部」とは判定できません。
画面に必要なら「受信済み二枚・総数未確認」と示す設計を検討します。一定時間届かなかったという理由で待機を終了する場合も、それは自社の運用上の区切りです。LINEが全枚数の配送を保証した合図ではありません。
待機時間と打ち切り後の担当を決め、確認が必要な相談だけ人へ渡します。未表示を見て直ちに全写真の再送を頼む前に、受信記録と保存先を調べると、お客様に同じ作業を繰り返してもらう場面を減らせます。
調査担当へ渡すメモ
問い合わせ本文や画像そのものを公開ログへ貼らず、権限のある場所で次を照合します。
- 対象アカウント・トーク・確認した時刻。
- セットID、存在する番号、総数の有無。
- 重複を除いたメッセージIDと、その取得・保存・表示の結果。
- まだ分からないことと、お客様へ返答する担当者。
画像の取得方法は contentProvider.type によって異なります。受信したIDがあるだけで保存済みとはせず、メッセージ受信の公式ガイドと添付ファイルの記事に沿って確認します。写真の受付が終わっても、見積もりや予約が確定したことにはなりません。受け付けた内容を誰が確認し、いつ何を返すかまで引き継ぎます。
仕様確認:2026年11月15日。公式資料と設計例を整理した記事です。実アカウントでの送受信・CRM保存の動作や、運用改善の効果を実証したものではありません。