【GAS】LINE BOTでユーザー操作をデータで受け取るポストバックアクションの使い方

2019-11-09 / 2025-11-27

この記事では、Google Apps Script (GAS) を利用して、LINE BOTで「ポストバックアクション」を使用する方法を解説します。

ポストバックアクションは、ユーザーがボタンをタップした際に、テキストメッセージを送信するのではなく、サーバー側（GAS）に特定のデータ（ポストバックデータ）を送信する機能です。これにより、ユーザーには見えないデータをトリガーとして、BOT側で様々な処理を分岐させることが可能になります。

公式ドキュメントはこちらを参照してください。

Google Apps Script 始め方スプレッドシート活用例を各ショップで検索

楽天市場で探す Amazonで探す Yahoo!ショッピングで探す

LINE BOT チャットボット作り方を各ショップで検索

楽天市場で探す Amazonで探す Yahoo!ショッピングで探す

事前準備

実装を始める前に、以下の準備が必要です。

チャンネルアクセストークンの取得: LINE Developersコンソールからアクセストークンを取得します。

【初心者向け】LINE Messaging APIのアクセストークンを取得する方法を解説

LINE BOT開発に不可欠なMessaging APIのチャンネルアクセストークンを取得する手順を、実際の画面キャリプチャを交えて詳しく解説します。LINE Developersへの登録からプロバイダー、チャンネル作成、トークン発行までを網羅。

ユーザーIDの取得: メッセージの送信先となるご自身のLINEユーザーIDを取得します。

【GAS】LINE BOTでユーザーIDを取得する方法｜Webhookで情報を受け取る

Google Apps Script（GAS）を使って、LINE BOTと友だちになっているユーザーのIDを取得する方法を解説します。Webhook経由で送信されるイベント情報から、特定のユーザーを識別するための`userId`を抜き出すサンプルコードを紹介します。

スクリプトプロパティの設定: 今回のサンプルコードでは、アクセストークンとユーザーIDをスクリプトプロパティに保存して使用します。以下の記事を参考に、TOKENとDEBUGIDというキーでそれぞれの値を設定してください。

【GAS】Google Apps Scriptで簡単なLINE BOTを作る方法（コピペ可）

Google Apps Script(GAS)を使って、特定のキーワードに反応するシンプルなLINE BOTを作成する手順を解説します。Googleアカウントさえあれば無料で開発可能。初心者でもコピペで実装できるよう、コードと設定方法を詳しく紹介します。

実装コード

以下の関数は、ポストバックアクションが設定されたボタンテンプレートメッセージを送信します。

/*
ボタンテンプレートメッセージを送る(postback)
-----------------------------*/
function postback_action() {
  /* スクリプトプロパティのオブジェクトを取得 */
  const prop = PropertiesService.getScriptProperties().getProperties();

  /* ボタンテンプレートメッセージを送る(postback) */
  UrlFetchApp.fetch('https://api.line.me/v2/bot/message/push', {
    'headers': {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer ' + prop.TOKEN, // スクリプトプロパティにトークンは事前に追加しておく
    },
    'method': 'POST',
    'payload': JSON.stringify({
      "to": prop.DEBUGID, // スクリプトプロパティに送信先IDは事前に追加しておく
      "messages": [
        {
          "type": "template",
          "altText": "postback",
          "template": {
            "type": "buttons",
            "thumbnailImageUrl": "https://placehold.jp/640x480.jpg?text=postback", // 画像のURL
            "imageAspectRatio": "rectangle",
            "imageSize": "cover",
            "imageBackgroundColor": "#FFFFFF",
            "title": "メニュー",
            "text": "以下より選択してください。",
            "actions": [
              {
                "type": "postback",
                "label": "ポストバック1",
                "data": "action=postback1&item=A" // Webhookで受け取るデータ
              },
              {
                "type": "postback",
                "label": "ポストバック2",
                "data": "action=postback2&item=B" // Webhookで受け取るデータ
              }
            ]
          }
        }
      ],
      "notificationDisabled": false // trueだとユーザーに通知されない
    }),
  });
}