# WebHooks

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

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

***

## 使い方

### Slackウェブフック連携

{% hint style="info" %}
**超簡単ガイド**

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

{% stepper %}
{% step %}

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

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

![](/files/efa413b3e8f5904e2b01e129e43483e98fe7ac07)
{% endstep %}

{% step %}

### Incoming Webhooks を追加する

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

![](/files/72aeb845963c56fa418b3d07c9c25689338fc00e)

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

![](/files/fb742a93b9d598660dfc2855d44c09bff3801480)
{% endstep %}

{% step %}

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

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

![](/files/359b11603d5058e0920f1d5e9536ccfac2d29ada)

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

![](/files/2148620996f6ed7b8b724e94859949decacd12fd)

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

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:"
}
```

{% endstep %}

{% step %}

### 通知を受け取る

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

![](/files/fd1ec26ccc00eaf2d0781b4d479108a94182c79c)
{% endstep %}
{% endstepper %}

### その他の設定

* JSON形式に慣れている場合、上記で入力したJSONに **channel: #チャンネル名** または **user: @ユーザー名** を追加して、通知を受け取るチャンネル/ユーザーを変更できます。**username: ボット名** を追加すると、通知を送信するボットの名前も変更できます。
* Slackインカミングウェブフック（Incoming Webhooks）について詳しく知りたい場合は、Slackが提供するドキュメント（<https://api.slack.com/legacy/custom-integrations/messaging/webhooks）を参照してください。>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.listly.io/docs/ja/getting-started/result-page-features/webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.