---
title: "Webhook"
description: "インバウンドのWebhookを使うと、別のシステムが従業員の代わりにフォームを送信できます。WebhooksビューにはすべてのWebhookがエンドポイントとともに一覧表示され、開くとシークレットの状態とログが見られます。"
sidebar:
  label: 概要
  order: 0
area: settings
feature: webhooks
appPath: /settings/general/webhooks
lastVerified: 2026-11-15
version: "2026-11-10"
audience: admin
related:
  - settings/webhooks/create-a-webhook-secret
  - flows/forms
  - notices
intercom:
  - id: "16858360"
    title: Create a Webhook (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16858360-create-a-webhook-pyn-2
    note: draws on
translation:
  source: settings/webhooks/index.mdx
  sourceSha: dd1218d30155660a0b00aca101164f1e7fc0f495
---

インバウンドのWebhookは、別のシステムがJSONをPOSTするアドレスです。各Webhookはフォームに属します。届いたペイロードは、ペイロードが指定する従業員によるそのフォームの送信になり、その送信がオートメーションをトリガーできます。Webhookはフォームの**Webhook**サイドパネルで作成し、Settingsにはそれらすべてが1か所に一覧表示されます。

![Settings > General > Webhooks lists every inbound webhook created on a form.](https://support.pyn.ai/media/settings/webhooks/settings-webhooks-list.png)

## Webhookの仕組み

- エンドポイントは`POST /api/webhook/<webhook id>`で、ヘッダー`Authorization: Bearer <secret>`とJSONのボディを付けます。パネルには送るべき**URL**と**Header**が表示されます。「Post a JSON body here, with the secret as a bearer token.」とあります。
- ボディは`subject_id`で従業員を、`fields`の下で回答を指定します。そのidがどのソースシステムのものか、たとえばBambooHRの従業員idかは、フォームの**Subject**設定が決めます。
- すべての呼び出しには、受け付けられた時点で`202`が返ります。各ペイロードがどうなったかの記録は**History**タブです。エントリには`submitted`、`unknown-subject`、`missing-fields`、`invalid-fields`、`ambiguous-fields`、`already-submitted`などのコードが付きます。
- `Idempotency-Key`ヘッダーを送ると、再試行が安全になります。同じキーの繰り返しには再び`202`が返りますが、2回目は処理されません。
- Pynが受け取れなかったペイロードは、[通知](https://support.pyn.ai/ja/notices/)に通知を上げます。呼び出し側が同じ間違いを繰り返しても、多数の通知が上がるのではなく1つの通知が更新されます。管理者にメールすることもできます。[通知メールを設定する](https://support.pyn.ai/ja/settings/notifications/)を参照してください。
- Webhookはシークレットを持つまで何も受け付けず、アーカイブされたWebhookはペイロードを受け付けなくなります。

## できること

- [Webhookシークレットを作成または置き換える](https://support.pyn.ai/ja/settings/webhooks/create-a-webhook-secret/)
- パネルからWebhookの名前を変更する：**Title**を編集し、Enterを押すか、別の場所をクリックして保存する
- ペイロードの**History**を読み、フォームのWebhookサイドパネルからログ全体をCSVでエクスポートする
- メニュー（**...**）からWebhookをアーカイブする

## アプリ内の場所

Pynで`/settings/general/webhooks`を開くか、メインナビゲーションの**Settings**を開いて**General**の下の**Webhooks**を選びます。Webhookを作成するには、[フォーム](https://support.pyn.ai/ja/flows/forms/)でフォームを開き、レールの**Settings**を選んでから**Add Webhook**を選びます。

## 関連ページ

- [Webhookシークレットを作成または置き換える](https://support.pyn.ai/ja/settings/webhooks/create-a-webhook-secret/)：最初のペイロードの前に行います。
- [フォーム](https://support.pyn.ai/ja/flows/forms/)：Webhookを作成してサブジェクトを選ぶにはこちらです。
- [通知](https://support.pyn.ai/ja/notices/)：Pynが受け取れなかったペイロードについてです。
