新しいメッセージ(トリガー)

このピースでできること

  • LINE ユーザーからボットに届いた新しいメッセージを受信して、ワークフローを起動します。
  • Webhook 方式でリアルタイムに受信します。

LINEの接続方法

1. LINE公式アカウントの作成・Messaging APIの有効化

  • 以下の公式ドキュメントに従って公式アカウントの作成とMessaging APIの有効化を行ってください。

2. LINE Developer consoleからチャネルアクセストークンを取得する

  • LINE Developer consoleからMessaging APIを有効化したチャネルに入り、「Messaging API設定」を開きます。
 
  • 下の方にチャネルアクセストークンがあるのでコピーしておきます。
  • workrunの画面でLINEの「新しいメッセージ」トリガーを選択し、Bot Tokenから「接続を作成」を選択します。
  • LINE Developer consoleで取得した「チャネルアクセストークン」を入力して保存します。

3. webhook URLの設定とテスト

  • workrunに記載のwebhook URLをコピーします。下記の画像でwebhook URLの一部を隠していますが、全てコピーしてください。
  • LINE Developer consoleの「Messaging API設定」のタブに戻り、Webhook URLの部分にworkrunからコピーしてきたwebhook URLをペーストします。下記の画像でwebhook URLの一部を隠していますが、全てペーストしてください。
  • workrunでトリガーピースだけのワークフローを公開します。
  • LINE Developer consoleのWebhook URLの「検証」ボタン押して、「成功」とダイアログが出たら接続完了です。
  • この後はMessaging APIチャネルに紐づいたLINE公式アカウントを友だち追加して、動作の検証を行ってください。友だちの追加の仕方は以下の公式ドキュメントを参照してください。

ピースの設定項目

1. セットアップ手順(情報表示)

  • LINE Developers Console で Webhook URL を設定します。
  • Activepieces 側でフローを公開(Publish)した後、生成された Webhook URL()を貼り付けます。
  • Console の「検証」ボタンで接続を確認します。

取得できる情報

LINEから届いたメッセージイベントを、1イベントずつ取得できます。後続ステップでは や を直接参照します。
  • / / :イベント種別・動作モード・イベント時刻。
  • / :送信元の種類・ユーザーID。グループ・ルームでは、通知に含まれる / なども利用できます。
  • :通知に含まれる返信用トークン。
  • / :メッセージID・種類。テキストの場合は が本文です。
  • / :通知に含まれるイベントID・再送フラグ。

取得条件と注意点

  • 受信した のうち、 かつ のイベントだけを返します。イベントが複数ある場合は別々に出力します。
  • 出力は 配下の要素そのものです。元のWebhook本文全体や 配列で包んだオブジェクトではありません。
  • メッセージ種類により項目は異なります。画像・音声などのファイル本体をこのトリガーで追加取得する処理はありません。
  • 受信用トリガーはBot Tokenを利用してAPIから取得する方式ではありません。LINE側のWebhook設定が必要です。Bot Tokenを使う接続案内は、後続の送信アクション等の設定時に参照してください。
  • テストはLINEから実際にメッセージを送り、受信イベントを確認してください。

利用例

を通知本文に、 を後続処理の宛先の管理に利用できます。

出力例(抜粋)

キーと階層を示す架空例です。実際の項目・値は受信内容や接続先により異なります。

LINE受信イベントの補足

受信イベントのポイント
  • 処理対象は かつ のイベントです。
  • 重要フィールド
    • メッセージ送信者のユーザーID(返信やプッシュ宛先の管理に使用)
    • 一度だけ使える返信用トークン(有効期限あり)
    • ユーザーが送ったテキスト
サンプル(Webhook ペイロード)