新しいメッセージが送信されたら(トリガー)

このピースでできること

  • LINE WORKSのボットに新しいメッセージが送信されたことを検知して、フローを起動します。
  • このトリガーでの受信にはOAuth接続は不要です。ボットへのCallback URLの設定が必要です。以下の共通接続手順は、後続でメッセージ送信などのアクションを使う場合に参照してください。
 

LINE WORKS の接続方法

OAuth2 で認証します。事前に LINE WORKS Developer Console でアプリと Bot を作成する必要があります。

事前準備 1:アプリの作成

  1. LINE WORKS Developer Console にアクセスします
  1. 「アプリの追加」 をクリックし、アプリを作成します
  1. クライアントID と クライアントシークレット をコピーします
  1. 接続画面に表示されている リダイレクト URL をアプリの設定に登録します

事前準備 2:Bot の作成(メッセージ送信を使う場合)

メッセージ送信・ファイル送信機能を利用する場合は Bot の作成が必要です。
  1. Bot の作成手順 を参照して Bot を作成します

スコープの設定

利用する機能に応じて、スペース区切りでスコープを入力します。
  • bot — メッセージ送信・Bot 機能(デフォルト)
  • user.read — ユーザー情報の読み取り
複数指定する場合はスペースで区切ります(例: )。

接続手順

  1. 接続画面で クライアントID・クライアントシークレット・スコープ を入力します
  1. 「接続」 をクリックします
  1. LINE WORKS のログイン画面が表示されるので、アカウントでログインします
  1. アクセス許可を確認して 「許可」 をクリックします
 

ピースの設定項目

1. Webhook URL(設定不要)

  • フローを有効化するとWebhook URLが自動生成され、画面に表示されます。
  • LINE WORKS Developer Consoleのボット設定で、Callback URLにこのWebhook URLを設定します。

2. セットアップ手順(設定不要)

  • 画面に表示される手順に沿って、LINE WORKS Developer ConsoleでWebhook(Callback URL)設定を行います。

取得できる情報

ボットに届いたメッセージの通知本文を1件ずつ取得できます。
  • :イベントの種類。対象は です。
  • / :送信元メンバーのID・ドメインID。
  • :トークルームID。1対1のトークでは送信されません。
  • :メッセージが作成された日時。
  • :メッセージの種類。
  • :テキストメッセージの本文。テキストの場合に利用できます。
  • 、位置情報やスタンプの項目など:受信したメッセージの種類に応じて含まれる情報です。全種類で同じ項目が返るわけではありません。

取得条件と注意点

  • このトリガーのWebhook URLをボットのCallback URLへ登録し、受け取るメッセージタイプを有効にしてください。
  • 通知本文がオブジェクトで の場合に、本文全体を返します。参加通知やpostbackなど別のイベント種類は対象外です。
  • 出力に を追加する形式ではありません。テキストは 、送信元は を参照します。
  • 画像やファイルが届いた場合も、ファイル本体を自動でダウンロードする処理はありません。

利用例

で処理を分け、テキストの場合は を後続の通知や記録に利用できます。

出力例(抜粋)

テキスト受信時のキーを示す架空例です。

Webhookセットアップ手順

  1. LINE WORKS Developer Consoleにアクセスします。
  1. 対象のボットを選択します。
  1. Callback URLをOnにします。
  1. 「メンバーが送信可能なメッセージタイプ」で受け取りたいものにチェックを入れます。
  1. Callback URLに表示されたWebhook URLを入力して保存します。

テスト方法

  • フローを実行せずにサンプルデータを取得するには、Webhook URLの末尾に /test を追加してリクエストを送信してください。