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)を参照してください。

最終更新

役に立ちましたか?