新しいメッセージが送信されたら(トリガー)
このピースでできることLINE WORKS の接続方法事前準備 1:アプリの作成事前準備 2:Bot の作成(メッセージ送信を使う場合)スコープの設定接続手順ピースの設定項目1. Webhook URL(設定不要)2. セットアップ手順(設定不要)取得できる情報取得条件と注意点利用例出力例(抜粋)Webhookセットアップ手順テスト方法
このピースでできること
- LINE WORKSのボットに新しいメッセージが送信されたことを検知して、フローを起動します。
- このトリガーでの受信にはOAuth接続は不要です。ボットへのCallback URLの設定が必要です。以下の共通接続手順は、後続でメッセージ送信などのアクションを使う場合に参照してください。
LINE WORKS の接続方法
OAuth2 で認証します。事前に LINE WORKS Developer Console でアプリと Bot を作成する必要があります。
事前準備 1:アプリの作成
- LINE WORKS Developer Console にアクセスします
- 「アプリの追加」 をクリックし、アプリを作成します
- クライアントID と クライアントシークレット をコピーします
- 接続画面に表示されている リダイレクト URL をアプリの設定に登録します
事前準備 2:Bot の作成(メッセージ送信を使う場合)
メッセージ送信・ファイル送信機能を利用する場合は Bot の作成が必要です。
- Bot の作成手順 を参照して Bot を作成します
スコープの設定
利用する機能に応じて、スペース区切りでスコープを入力します。
- bot — メッセージ送信・Bot 機能(デフォルト)
- user.read — ユーザー情報の読み取り
- directory.read — ディレクトリ情報の読み取り
複数指定する場合はスペースで区切ります(例: )。
接続手順
- 接続画面で クライアントID・クライアントシークレット・スコープ を入力します
- 「接続」 をクリックします
- LINE WORKS のログイン画面が表示されるので、アカウントでログインします
- アクセス許可を確認して 「許可」 をクリックします
ピースの設定項目
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セットアップ手順
- LINE WORKS Developer Consoleにアクセスします。
- 対象のボットを選択します。
- Callback URLをOnにします。
- 「メンバーが送信可能なメッセージタイプ」で受け取りたいものにチェックを入れます。
- Callback URLに表示されたWebhook URLを入力して保存します。
テスト方法
- フローを実行せずにサンプルデータを取得するには、Webhook URLの末尾に /test を追加してリクエストを送信してください。