WebHooks

ウェブフック（Webhook）とは？

ウェブアプリで何らかの作業が完了したり、特定のイベントが発生した際に、リアルタイムで通知を受け取ることができる機能です。Listlyでデータ抽出後、Slackなどの企業向けメッセージングアプリと連携すると、データ抽出完了時にリアルタイムで通知を受け取ることができます。

---

使い方

Slackウェブフック連携

超簡単ガイド

➡️ Slackにインカミングメッセージアプリを追加 ➡️ Listlyタスクにウェブフックを追加 ➡️ データの再抽出またはスケジューラーを使用して 希望するSlackチャンネルで通知を受け取る

1

Slackにログインしてアプリ管理設定を開く

Slackにログイン後、左サイドバーでワークスペース名（例：Acme Inc.）をクリックしてください。 「ツールと設定メニュー」が表示されたら、「アプリ管理設定」をクリックしてアプリディレクトリを開いてください。

2

Incoming Webhooks を追加する

Slackアプリディレクトリページで「Incoming Webhooks」または「受信Webhook」を検索してSlackに追加してください。

Slackに追加後、どのチャンネルで通知を受け取るかを選択してください。この段階で、通知を受け取りたいチャンネルを新たに追加することもでき、抽出結果メッセージを送信するボットの名前を設定することもできます。Listlyサービス連携に必要な Webhook URL をコピーした後、設定を保存してください。

3

ListlyでタスクにWebhookを設定する

Listlyのデータボードで、結果通知を受け取りたいタスクを見つけ、右側の データ ボタンをクリックしてください。そして上部メニュー右側の Hook ボタンを押してウェブフック設定ウィンドウを開きます。

ウェブフック設定ウィンドウが表示されたら、以下と同じようにRequest Method、JSON値を入力してください。URL入力欄には、前のステップでコピーした Webhook URL を入力してください。

Method	JSON
POST	下記JSONを入力してください。

JSON（例）:

{
  "text": "#taskkey is #status. <https://www.listly.io/single?key=#taskkey&tab=4&card=30|See> result\nFrom Listly.",
  "icon_emoji": ":white_check_mark:"
}

4

通知を受け取る

再抽出またはスケジューラーを使用してそのタスクのデータを再度抽出すると、以下のようにSlackでデータ抽出通知メッセージを受け取ることができます。

その他の設定

• JSON形式に慣れている場合、上記で入力したJSONに channel: #チャンネル名 または user: @ユーザー名 を追加して、通知を受け取るチャンネル/ユーザーを変更できます。username: ボット名 を追加すると、通知を送信するボットの名前も変更できます。

• Slackインカミングウェブフック（Incoming Webhooks）について詳しく知りたい場合は、Slackが提供するドキュメント（https://api.slack.com/legacy/custom-integrations/messaging/webhooks）を参照してください。