Messaging APIで既読を付けるには|対象メッセージ・トークン・対応済みの違い
この記事の結論
LINEの既読APIは指定したメッセージと、それ以前のメッセージが対象です。チャット設定、markAsReadTokenの取得、編集イベントの例外、APIの成功と担当者の対応完了を分ける確認手順を解説します。
最終更新:2026年11月15日
Messaging APIで既読を付けるときは、指定した一通だけでなく、それ以前に送られたメッセージも対象になります。APIが成功したことと、スタッフが内容を読み、必要な回答を終えたことは分けて記録してください。
この記事は、顧客から届いたメッセージにシステムから既読を付けたい開発・運用担当者向けです。管理画面の「要対応」「対応済み」の使い分けは、チャットの状態と担当の記事で扱います。
チャット設定と、使うトークンを確認する
公式の既読ガイドでは、LINE Official Account Managerの[応答設定]で[チャット]をオンにしていることが、APIで既読を付ける条件です。オフの場合は、ユーザーからのメッセージに自動で既読が付きます。
調査のために先にオン・オフを切り替えると、既存の応答運用へ影響するおそれがあります。まず現在の設定と、どの処理が既読を付ける設計なのかを確認します。返信が重なる問題もある場合は、管理画面・外部ボット・手動返信の切り分けを参照してください。
使うのは、署名を確認したメッセージイベントの message.markAsReadToken です。返信用の replyToken や、メッセージを識別する message.id を代わりに送るものではありません。
送信先は api.line.me、HTTPメソッドはPOST、パスは次のとおりです。
/v2/bot/chat/markAsRead
リクエスト本文には markAsReadToken を指定し、チャネルアクセストークンで認証します。詳細な入力条件は既読APIのリファレンスで確認できます。ここに掲載した説明は実際の顧客へAPIを実行した記録ではありません。
「最後に取得したトークン」でよいとは限らない
以下は、同じ顧客から三通届いた架空の例です。
- 9:00「予約を変更したいです」
- 9:02「来週の火曜日を希望します」
- 9:05「難しければ木曜日でも大丈夫です」
二通目の既読トークンでリクエストすると、その一通と、それ以前の一通が対象になります。三通目はこのリクエストの対象外です。ただし、別の操作や処理で既読になっている可能性はあり、対象外というだけで現在も未読だとは断定できません。
「一通だけ見たので一通だけ既読にしたい」という意図で、最新の三通目のトークンを使うと、対象範囲が意図より広くなります。実装では、トークンと対象のメッセージID・会話・受信時刻を対応させ、どこまでを対象にするか決めてから呼び出します。

トークンがない場合と、400の場合を分ける
公式ガイドでは既読トークンに有効期限はありません。ただし、期限がないことだけで、手元の値が正しい、どのイベントにも値がある、呼び出しが必ず成功するとは判断しません。
テキストのメッセージオブジェクトでは、編集イベントに既読トークンは含まれません。編集通知から値を取ろうとして見つからない場合は、最初に受信したメッセージイベントの記録と、編集通知を区別してください。別の会話から取ったトークンで空欄を埋めないようにします。
既読APIの 400 は、無効な既読トークンが指定されている場合のエラーです。返信トークンとの取り違え、受信後の保存で値が欠けていないか、対象のイベントと合っているかを確認します。時間がたったという理由だけで「期限切れ」と決めつけないでください。
共有する調査メモにはトークンの実値や会話全文を貼らず、対象チャネル、発生時刻、イベントの種類、値の有無、APIの結果を残します。実値の照合が必要なら、権限のある内部記録で行います。
既読APIの成功を、相談の完了条件にしない
APIの成功時はHTTP 200 と空のJSONオブジェクトが返ります。これを記録する欄と、担当者が内容を確認した欄、返信や確認作業が残っている欄を分ける設計が必要です。
たとえば予約変更の例では、希望日を受け取って既読を付けても、空き枠の確認や変更結果の連絡は残っています。「既読になったから対応済み」と自動で閉じず、誰が空き枠を確認し、誰が返答するかを残します。これは運用の提案であり、APIが対応状態や担当者を自動設定するという説明ではありません。
実装を確認するときは、次の三点を一つの会話でたどれるようにします。
- どのメッセージまでを既読の対象にしたか。
- APIの結果と、相手側での表示確認をどこまで行ったか。
- まだ必要な確認・返信と、次に担当する人は誰か。
表示を整える処理と、人が返す仕事を分けることで、別画面を何枚も探さなくても次の対応を判断しやすくなります。相談を引き取る具体例は、受付から返答までのチャット対応も参考にしてください。
仕様確認:2026年11月15日。例は架空です。実機での既読表示や送受信、個別の導入成果は未確認です。