LINEDC Advent Calendar 2025

LINE messaging APIで新しく利用できるようになった既読API

Last updated at 2025-12-21Posted at 2025-12-21

既読APIの一般公開

2025年11月5日に既読APIが法人ユーザーだけでなく、誰でも使えるようになりました。

既読APIとは

なんでわざわざ既読をAPIで、、、LINE公式アカウントを使ったbotなら既読が勝手につくから関係ない！
と、思われるかもしれないのですが、既読がつかない場合があります。

それは、応答設定でチャットをONにしていた場合です。

・チャットをONにしていてwebhookを併用することはない！
・webhookを使っているのにチャットをONにすることはない！
ということがほとんどだと思うのですが

・基本はwebhookを使ったbotで応答しているが、個別対応が必要なものはチャットで対応する

という運用の場合、併用することが多くあります。
その場合、botやオフィシャルアカウントマネージャーで自動応答した場合は、既読がつかず
オフィシャルアカウントマネージャーのチャット画面でメッセージを開くまで既読がつかないということになります。

以前はwebhookとチャットは併用ができなかったのですが、2022年12月1日より、チャットとwebhookの併用ができるようになりました。

既読APIと使うときに利用する、既読トークン

既読トークンってどこにあるの？？っと思ったのですが
毎回メッセージを送るたびに送られておりました。

webhook.json

{"type":"message",
 "message":
    {
    "type":"text",
    "id":"593000101958385840",
    "quoteToken":"jLXhZ4-RHoqbmudH0zR8l1N9J************",
    "markAsReadToken":"MHo994SECoNEC4-0nWmS****************", //←既読APIに使う既読トークン
    "text":"おはよう"
    },
 "webhookEventId":"01KCZEEQCFZXG**********",
 "deliveryContext":
    {
        "isRedelivery":false
    },
  "timestamp":1766286908304,"source":
    {
    "type":"user","userId":"U799b8d72b1a6a**********"
    },
  "replyToken":"72ce31e6778246fc**********",
  "mode":"active"
}

このmarkAsReadTokenを指定して、既読APIを送ります

既読APIをGASで作ってみた

既読API.gs

function markAsRead() {
  var markAsReadToken ="markAsReadTokenのID"

  const url = 'https://api.line.me/v2/bot/chat/markAsRead';

  const payload = {
    markAsReadToken: markAsReadToken
  };

  const params = {
    method: 'post',
    headers: {
      'Authorization': 'Bearer ' + CHANNEL_ACCESS_TOKEN,
      'Content-Type': 'application/json'
    },
    payload: JSON.stringify(payload),
  };