> For the complete documentation index, see [llms.txt](https://docs-embed.anyflow.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-embed.anyflow.jp/solution-editor/triggers/outgoing/webhook.md). # Webhookトリガー ## **概要** Webhookトリガーは、自社プロダクトや外部サービス（Salesforce, kintone など）でイベント（商談のステータスが変更された、新しいデータが書き込まれたなど）が実行された際、リアルタイムにソリューションを実行する仕組みです。

フィールド名	説明
イベント名	Webhookトリガーがイベントを待機している名前です。イベント名は、生成されるWebhookアドレスの一部になります。Webhookアドレスはウィザードに配置することが可能で、エンドユーザーがコピーできます。また、ことなるソリューション間で、Webhookトリガーのイベント名を同一に設定しておくことで、複数のソリューションを同時に実行することが可能です。
Webhookタイプ	ソリューションを発火するWebhookのタイプを選択します。GETリクエストの状態でPOSTやPUTなどの異なるタイプでWebhookを送信しても発火しません。以下の一覧から選択可能です。 - GET request - PUT/POST with unicode text data - PUT/POST with JSON payload
ペイロード	Webhookで送信されてくるペイロードを定義します。ここで定義した変数が後継のアクション等で変数として利用可能です。
ヘッダー	Webhookで送信されてくるHTTPのヘッダーを定義します。ここで定義した変数が後継のアクション等で変数として利用可能です。

## **設定方法** ### **Webhookコネクタの設定** Webhookコネクタの設定画面にて、Webhookのリクエスト元が定義しているヘッダーやペイロードを設定します。手動でペイロードを登録するか、JSONで入稿するか２つの方法が存在します。

手動で追加することも可能ですが、大量のペイロードが送信されてくる場合は、JSONで入稿することを推奨します。

1679 — kintoneから送信されてくるWebhookペイロードを入稿した例

### **Webhookタイプの設定**

GET request

リクエスト元のWebhook送信仕様が次のような場合は `GET request` を指定します。 ```json curl -G https://example.com/webhook \ -H "Authorization: Bearer your_auth_token" \ --data-urlencode "param1=value1" \ --data-urlencode "param2=value2" ``` この場合、Webhookコネクタでの設定は以下の通りになります。

PUT/POST with unicode text data

リクエスト元のWebhook送信仕様が次のような場合は `PUT/POST with unicode text data` を指定します。 ``` curl -X POST https://example.com/webhook \ -H "Content-Type: text/csv" \ -H "Authorization: Bearer your_auth_token" \ --data-binary '@test.csv' ``` この場合、Webhookコネクタでの設定は以下の通りになります。

送信されたテキストデータ（test.csv）はWebhookの出力値として「ペイロード」という変数に格納され、ソリューション内で使用することができます。

PUT/POST with JSON payload

リクエスト元のWebhook送信仕様が次のような場合は `PUT/POST with JSON payload` を指定します。 ``` curl -X POST https://example.com/webhook \ -H "Content-Type: application/json" \ -H "Authorization: Bearer your_auth_token" \ -d '{"message": "Hello, World!"}' ``` この場合、Webhookコネクタでの設定は以下の通りになります。

詳細な仕様は[WebhookのAPI仕様書](/anyflow-api/webhook.md)をご確認ください。 ### **ウィザードの設定** エンドユーザーが設定するためのWebhook URLをウィザードのスクリーンに配置するために、エンドユーザーの設定項目から、`Webhook URL`を任意のスクリーンに配置します。

プレビューではWebhook URLが `https://example.com/webhook` と表示されていますが、テストやAnyflow SDKで埋め込んだ際には、実際のWebhook URLが生成されます。

## **利用例** ### **kintoneでの例** kintoneでは[Webhookをサポート](https://jp.cybozu.help/k/ja/user/app_settings/set_webhook/webhook.html)しているので、例として取り上げます。以下のスクリーンショットは、kintoneでWebhookが送信された際にSlackに通知するシンプルなソリューションです。\ また、POSTされてくるペイロードに関してすべて手入力で入力するには時間がかかるので、[kintoneから送信されるペイロード](https://jp.cybozu.help/k/ja/user/app_settings/set_webhook/webhook_notification.html) のJSONをコピーし、ペイロードをJSONで入稿しています。

以下のように、kintoneのヘルプページに従ってWebhookが送信されるように設定します。

ソリューションのテストを行い、Webhookの待機状態になったタイミングでkintoneでイベントが発火されるようにデータの追加や編集を行い、Anyflowでテストが完了することを確認します。 ## **クラウドサインでの例** クラウドサインでも[Webhookをサポート](https://help.cloudsign.jp/ja/articles/417935-webhook-%E6%A9%9F%E8%83%BD)しているので、例として取り上げます。 Anyflow上でコピーしたWebhook URLをクラウドサイン（コネクタ側）のWebhookの設定欄に登録します。

1440 — `Hook URL`にコピーしたWebhook URLを入力し、保存する

ソリューションのテストを行い、Webhookの待機状態になったタイミングでイベントが発火されるようにデータの追加や編集を行い、Anyflowでテストが完了することを確認します。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs-embed.anyflow.jp/solution-editor/triggers/outgoing/webhook.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.