Integrations
LINE WORKS 連携
LINE WORKS と Pigeon Workflow を連携することで、Bot 宛のメッセージ受信をトリガーにワークフローを起動したり、 トーク・チャンネルへ自動でメッセージを送信できます。社内問い合わせの自動応答や通知ボットに活用できます。
組織共有の連携です。LINE WORKS 連携は組織の管理者(オーナー)が設定します。設定後は組織内の全メンバーが ワークフローで利用できます。
連携でできること
- Bot 宛のメッセージ受信をトリガーにワークフローを自動起動(受信ノード)
- AI で生成した応答をトーク・チャンネルへ自動送信(送信ノード)
- 社内ヘルプデスクの一次回答ボットや、業務通知の自動配信を構築
提供されるノード
| ノード | 種別 | 概要 |
|---|---|---|
| LINE WORKS 受信 | 入力(トリガー) | Bot 宛メッセージを受信してワークフローを起動 |
| LINE WORKS 送信 | 出力 | 指定のトーク・チャンネルへメッセージを送信 |
セットアップ手順
① LINE WORKS Developer Console で Bot を作成
LINE WORKS は OAuth の画面フローではなく、Developer Console で発行した 認証情報を手入力して接続します。
1
LINE WORKS Developer Console で Bot を作成
LINE WORKS Developer Console にログインし、Bot を新規作成します。
2
認証情報を取得
以下を控えます。
- Client ID / Client Secret
- Service Account
- Private Key(JWT 署名用 RSA 秘密鍵)
- Bot ID
- Bot Secret(Webhook 署名鍵)
- 表示名
② Pigeon Workflow 側で認証情報を登録
1
サービス連携画面を開く
Pigeon Workflow ダッシュボードの「設定」→「サービス連携」→「LINE WORKS」を選択します。
2
取得した認証情報を入力して保存
Client ID / Client Secret / Service Account / Private Key / Bot ID / Bot Secret / 表示名 を入力して保存します。保存時に資格情報の有効性が検証されます。
3
Webhook URL を控える
保存すると連携ごとに Webhook URL が発行されます。次の手順で使うため コピーしておいてください。
③ LINE WORKS 側に Webhook URL を登録
1
Bot コールバック URL に登録
LINE WORKS Developer Console の Bot 設定で、コールバック URL に手順②で発行された Webhook URL を登録します。
2
署名検証について
LINE WORKS からの受信は署名ヘッダー
X-Works-Signature を Bot Secret で HMAC-SHA256 検証します(自動で行われます)。受信ノードが後段に渡すデータ
| フィールド | 内容 |
|---|---|
userId | 送信者のユーザー ID |
channelId | トーク・チャンネル ID |
text | メッセージ本文 |
contentType | メッセージの種別(text / image など) |
issuedTime | メッセージ送信日時 |
送信ノードでは channelId と message を指定して送信します。
よくある落とし穴
| 症状 | 原因 / 対処 |
|---|---|
| 保存時に資格情報エラー | Private Key の改行が崩れていないか、Client ID / Service Account のコピー漏れがないか確認 |
| 受信トリガーが発火しない | Bot コールバック URL に連携別 Webhook URL が正しく登録されているか確認 |
| 署名検証エラー(401) | 登録した Bot Secret が Developer Console の値と一致しているか確認 |