---
title: "Webhookを作成する"
description: "別のシステムが従業員に代わってフォームを送信できるようにします。フォームにWebhookを追加し、従業員を特定するHRISのidを選び、シークレットを一度だけ発行して、何が届いたかのログを読みます。"
sidebar:
  order: 2
area: flows
feature: forms
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-10-30"
audience: admin
screenshots:
  - id: flows-forms-webhook-drawer
    caption: フォームのSettingsサイドパネル。WebhookのURL、ヘッダー、サブジェクト、本文の例があります。
related:
  - flows/forms/reference-webhook-api
  - flows/forms/build-a-form
  - notices
intercom:
  - id: "16858360"
    title: Create a Webhook (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16858360-create-a-webhook-pyn-2
    note: replaces
translation:
  source: flows/forms/create-a-webhook.mdx
  sourceSha: 88dd3263f023bcd0343ab040ded33eaba8203476
---

回答の中には、すでに別のシステムにあるものがあります。LMSで修了した研修、チケットツールでの機器の申請、署名済みの書類などです。フォームのWebhookを使うと、そのシステムが回答を送信としてPynに投稿し、指定した従業員に紐づけて記録できます。

## 始める前に

- あなたがAdminであること。
- フォームが作成され公開されていて、相手のシステムが対応づけられるフィールドのラベルを持っていること。[フォームを作成する](https://support.pyn.ai/ja/flows/forms/build-a-form/)を参照してください。
- 相手のシステムが、HRISの各従業員のid、つまりPynがその連携から得ているのと同じidを送れること。

![フォームのSettingsサイドパネル。WebhookのURL、ヘッダー、サブジェクト、本文の例があります。](https://support.pyn.ai/media/flows/forms/flows-forms-webhook-drawer.png)

## 手順

1. Pynで、左ナビゲーションの**Flows**を開き、**Forms**を選んで、フォームを選びます。

2. エディターの右のレールで**Settings**を選びます。サイドパネルには「**Add a webhook to let another system submit this form on an employee's behalf.**」とあります。**Add Webhook**を選びます。Webhookを追加できない場合は、**Could not add this webhook**というトーストが表示され、サイドパネルは元のままです。

3. サイドパネルの上部のコールアウトには「**This webhook accepts nothing until it has a secret.**」とあります。**Create Secret**を選ぶと、コールアウトは「**Copy this secret now. It is shown once and cannot be retrieved later.**」に変わります。相手のシステムにコピーしてから**Done**を選びます。シークレットを発行できない場合は、**Could not create the secret**というトーストが表示され、コールアウトは元のままです。すでにシークレットを持つWebhookでは「**This webhook already has a secret. Replace it if the old one has been lost.**」と表示され、代わりに**Replace Secret**が用意されています。下を参照してください。

4. コールアウトの下で**URL**をコピーし、ヘッダー`Authorization: Bearer <secret>`を控えます。

5. **Subject**の下で、相手のシステムが送るidのソースシステム（例：**BambooHR Employee ID**や**Workday Worker ID**）を選びます。説明には「**The submission is recorded against the employee holding this id.**」とあります。

6. 「**Post a body of this shape.**」の下の例を読みます。各フィールドをエイリアス（ラベルのキャメルケース）とサンプル値で示し、`subject_id`が加わります。

7. 相手のシステムからテストのペイロードを送り、サイドパネルの下部のログ（**Payloads this webhook has taken, and what became of them.**）を読みます。緑のエントリーには「**Recorded a submission for the ... identifier ...**」とあり、赤のエントリーには問題の内容が示されます。

> **Caution:** 失ったシークレットは復元できません。**Replace Secret**を選んで新しいものを発行します。**Replace Webhook Secret**ダイアログは「**The current secret stops working immediately. Anything calling this webhook will need the new one.**」と警告し、**Replace**で確定します。シークレットを置き換えられない場合は、**Could not replace the secret**というトーストが表示され、古いシークレットは引き続き使えます。

## シークレットのローテーションとログの読み方

- **Replace Secret**は1回の操作でシークレットをローテーションし、古いものはすぐに使えなくなります。確定する前に呼び出し元のシステムを更新してください。
- ログには直近20件のエントリーが表示されます。エントリーが1件でもあれば、その横のエクスポートアイコンでログ全体を`pyn-webhook-log.csv`（`receivedAt`、`outcome`、`action`、`code`、`message`、`eventId`、`subjectId`、`submissionId`）としてダウンロードできます。
- 受け付けられなかったペイロードは、[通知](https://support.pyn.ai/ja/notices/)にも通知を上げます。同じ間違いが繰り返されても、多くの通知ではなく1つの通知が最新の状態に保たれます。その行には**Acknowledge**、続いて**Archive**があります。すべてのAdminにメールするかOwnerだけにするかは、ワークスペースの通知設定で決まります。

## 確認できること

受け付けられたペイロードは、フォームの**Activity**サイドパネルに送信として表示され、従業員のレコードにはBuddyやMentorの値が入ります。各従業員について送信できるのはWebhookごとに一度だけで、2回目は`already-submitted`としてログに記録されます。[Webhook API](https://support.pyn.ai/ja/flows/forms/reference-webhook-api/)に、エンドポイント、ヘッダー、本文、レスポンス、すべてのログのコードがあります。

## 関連ページ

- [Webhook API](https://support.pyn.ai/ja/flows/forms/reference-webhook-api/)：正確なリクエストとレスポンスについてです。
- [フォームを作成する](https://support.pyn.ai/ja/flows/forms/build-a-form/)：ペイロードが埋めるフィールドについてです。
- [通知](https://support.pyn.ai/ja/notices/)：失敗が表示される場所です。
