LINE活用の基礎

Messaging APIで既読を付けるには|対象メッセージ・トークン・対応済みの違い

制作:LIFE合同会社

AIを使用して制作・更新制作方法と確認範囲

#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を実行した記録ではありません。

「最後に取得したトークン」でよいとは限らない

以下は、同じ顧客から三通届いた架空の例です。

  1. 9:00「予約を変更したいです」
  2. 9:02「来週の火曜日を希望します」
  3. 9:05「難しければ木曜日でも大丈夫です」

二通目の既読トークンでリクエストすると、その一通と、それ以前の一通が対象になります。三通目はこのリクエストの対象外です。ただし、別の操作や処理で既読になっている可能性はあり、対象外というだけで現在も未読だとは断定できません。

「一通だけ見たので一通だけ既読にしたい」という意図で、最新の三通目のトークンを使うと、対象範囲が意図より広くなります。実装では、トークンと対象のメッセージID・会話・受信時刻を対応させ、どこまでを対象にするか決めてから呼び出します。

同じ顧客から三通届いた架空の例。二通目の既読トークンを使うと、一通目と二通目が既読APIの対象となり、三通目はこのリクエストの対象外。対象外でも別の操作で既読になり得る。API成功と人が読んだこと、返信・対応完了は別に確認する。

図解画像を開く(保存用)

トークンがない場合と、400の場合を分ける

公式ガイドでは既読トークンに有効期限はありません。ただし、期限がないことだけで、手元の値が正しい、どのイベントにも値がある、呼び出しが必ず成功するとは判断しません。

テキストのメッセージオブジェクトでは、編集イベントに既読トークンは含まれません。編集通知から値を取ろうとして見つからない場合は、最初に受信したメッセージイベントの記録と、編集通知を区別してください。別の会話から取ったトークンで空欄を埋めないようにします。

既読APIの 400 は、無効な既読トークンが指定されている場合のエラーです。返信トークンとの取り違え、受信後の保存で値が欠けていないか、対象のイベントと合っているかを確認します。時間がたったという理由だけで「期限切れ」と決めつけないでください。

共有する調査メモにはトークンの実値や会話全文を貼らず、対象チャネル、発生時刻、イベントの種類、値の有無、APIの結果を残します。実値の照合が必要なら、権限のある内部記録で行います。

既読APIの成功を、相談の完了条件にしない

APIの成功時はHTTP 200 と空のJSONオブジェクトが返ります。これを記録する欄と、担当者が内容を確認した欄、返信や確認作業が残っている欄を分ける設計が必要です。

たとえば予約変更の例では、希望日を受け取って既読を付けても、空き枠の確認や変更結果の連絡は残っています。「既読になったから対応済み」と自動で閉じず、誰が空き枠を確認し、誰が返答するかを残します。これは運用の提案であり、APIが対応状態や担当者を自動設定するという説明ではありません。

実装を確認するときは、次の三点を一つの会話でたどれるようにします。

  • どのメッセージまでを既読の対象にしたか。
  • APIの結果と、相手側での表示確認をどこまで行ったか。
  • まだ必要な確認・返信と、次に担当する人は誰か。

表示を整える処理と、人が返す仕事を分けることで、別画面を何枚も探さなくても次の対応を判断しやすくなります。相談を引き取る具体例は、受付から返答までのチャット対応も参考にしてください。

仕様確認:2026年11月15日。例は架空です。実機での既読表示や送受信、個別の導入成果は未確認です。

この記事に関連するサービス