LINE活用の基礎

LINEミニアプリの通知を続けて送れない|サービス通知トークンと残り回数の確認

制作:LIFE合同会社

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

#LINEミニアプリ#サービスメッセージ#通知

この記事の結論

LINEミニアプリのサービスメッセージで、初回は成功しても次の通知が送れない場合の確認順。通知トークンの更新・保存、残り回数、期限、テンプレートの公開状態を分けて調べます。

最終更新:2026年11月18日

LINEミニアプリで予約確認は送れたのに、次のリマインドが送れない。その場合は、前回の送信結果に含まれる新しいサービス通知トークンを保存し、次の処理がその値を使っているかを確認します。最初に発行した値を、ずっと使う設計にはしません。

この記事は、サービスメッセージを実装・運用する担当者向けです。電話番号を利用するLINE通知メッセージや、LIFFからトークへ送るメッセージとは別の仕組みです。日本では「LINEミニアプリ お知らせ」のトークルームに表示され、自社の公式アカウントのトークだけを探しても見つからない場合があります。

初回から失敗する場合と、後続だけ失敗する場合を分ける

公式のサービスメッセージ手順では、公開環境での利用は認証済ミニアプリが対象です。未認証ミニアプリでも開発用の内部チャネルでテストできますが、その成功を公開用の利用許可と取り違えないようにします。APIで使うテンプレートも審査を通過している必要があります。

初回から送れないなら、チャネルとテンプレートの公開状態、API用テンプレート名、必要な変数を先に確認します。後続だけ失敗するなら、それらに加えて前回応答と保存処理を追います。「同じ利用者への通知だから」という理由だけで、別の予約や別の操作の記録を流用しないようにしてください。

回数と期限は、送信後の応答を見て管理する

LINEミニアプリのAPIリファレンスによると、サービス通知トークンは発行から1年間有効で、その期限内に最大5回のサービスメッセージを送れます。利用者の一つの操作に対応する通知枠であり、毎月5回の配信枠や、自由な広告枠ではありません。利用状況に応じて制限が変更される場合は審査時に通知されるため、個別に通知された条件も確認します。

送信に成功したら、少なくとも次の情報を対応する操作の記録へ保存します。

  • 更新後のnotificationToken:次の通知に使う値。
  • remainingCount:その時点で残っている送信可能回数。
  • expiresIn:その時点から有効期限までの秒数。受信時刻とともに扱う。
  • sessionIdと自社の処理記録:どの通知処理だったかを担当者が照合するための情報。

トークンの値を更新しても、回数が5回へ戻ったとは扱いません。期限も自社で「今回から1年」と計算し直さず、応答の残り時間を確かめます。トークンそのものは秘密情報として保管し、問い合わせ票や共有ログに貼り付けません。

サービスメッセージの後続通知を確認する図。前回の送信成功、更新後トークンと残り回数・期限の保存、次の処理による最新値の参照を順に確認する。送信成功の応答でexpiresInとremainingCountがともに0なら、その通知は送信されたがトークンを更新できなかった状態なので、同じ通知を再送しない。公開用は認証済ミニアプリと審査済テンプレートが前提で、広告枠ではない。

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

「残り0」を、その通知の失敗と取り違えない

送信APIの応答仕様には、成功応答のexpiresInとremainingCountがともに0なら、メッセージは送信されたものの、サービス通知トークンを更新できなかった状態だと説明されています。残り0を見て同じ内容を送信し直す判断は避けます。

一方、通信が途中で切れて応答を受け取れなかった場合は、成功応答を受け取ったケースとは区別します。自社の送信履歴、処理の開始・終了、保存済み応答を確認し、結果が不明なまま「未送信」として繰り返さない設計が必要です。APIの受付結果だけで、利用者が読んだことまで確認できるわけでもありません。

401ならチャネルアクセストークンとサービス通知トークンの有効性、403ならチャネルの送信許可や指定テンプレートを確認します。番号だけから一つの原因へ決め打ちせず、応答内容と失敗した段階を合わせます。チャネル用・LIFF用・サービス通知用のトークンを混ぜないことも大切です。

予約の確認とリマインドを、同じ用件の記録で追う

架空の予約サービスで「予約確認は成功、翌日のリマインドは失敗」という相談を受けたとします。最初に見るのは、利用者へ再操作を求める画面ではなく、予約確認後の保存結果です。

  1. 予約確認の送信結果は成功だったか。
  2. 更新後の値と残り回数・期限を、該当する予約の記録へ保存したか。
  3. リマインド担当の処理は、保存前の古い値を参照していないか。
  4. 複数の処理が同時に動き、互いの更新を上書きしていないか。
  5. 失敗中の予約について、誰が状況を確認し、必要な案内を返すか。

これは切り分け用の架空例で、実際の障害原因や導入実績ではありません。通知の失敗と予約そのものの取消を結び付けず、受付済みの用件を一つの記録で確認できるようにします。

通知枠を使い切ったときの案内を先に決める

サービスメッセージは、利用者の操作に対する確認や応答という条件があります。広告やクーポン配布を混ぜたり、同じLIFFアクセストークンから通知トークンを何個も発行して枠を増やしたりする用途ではありません。LIFFアクセストークン1つから発行できるサービス通知トークンは1つです。

通知できない場合に備え、ミニアプリ内で確認できる受付状況、問い合わせ先、確認担当を用意します。別の配信経路を使うなら、その経路の利用条件や同意を別途確認します。「届かなければ自動的に別の人のIDへ送る」といった処理にはしません。

LIFFアクセストークンの期限とアプリ終了の影響は、通知トークンを発行する前の確認にも役立ちます。実装を依頼するときは、通知内容だけでなく、送信結果の保存先・次回の参照先・失敗時の返信担当を一緒に伝えてください。

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