---
title: "Webhookで自社システムにデータを送信"
description: "登録・参加・当選のたびに指定したURLへリクエストを送信。署名付きペイロード、Basic認証、カスタムペイロード、全配信のログに対応しています。"
url: https://scratcher.io/ja/help/developers/webhooks
language: ja
---

1. [ヘルプセンター](https://scratcher.io/ja/help)
2. [API、Webhook、MCP](https://scratcher.io/ja/help/developers)
3. Webhookで自社システムにデータを送信

# Webhookで自社システムにデータを送信

登録・参加・当選のたびに指定したURLへリクエストを送信。署名付きペイロード、Basic認証、カスタムペイロード、全配信のログに対応しています。

Webhookは、キャンペーンへの参加や賞品の当選など、何かが起きた瞬間に指定したURLへデータを送信する仕組みです。受信側のシステムは開発者が構築します。

Webhookは、**Webhooks & API**を含むプラン(Basic以上)でご利用いただけます。

## キャンペーンWebhookとアカウントWebhookの違い

- **キャンペーンWebhook**はキャンペーンエディターで設定し、そのキャンペーンでのみ発火します。イベントは「リードがキャンペーンに参加するたび」と「リードが賞品に当選したとき」の2種類で、設定項目も最も豊富です。
- **アカウントWebhook**は**設定** > **Webhooks**で設定します。イベントは「新しいリードが作成されたとき」で、どのキャンペーン経由かにかかわらず、その人が初めてリードに追加されたときに1人につき1回だけ発火します。

## キャンペーンにWebhookを追加する

1. エディターでキャンペーンを開き、**接続** > **Webhooks**に進みます。
2. **Webhookを追加**をクリックします。
3. **ペイロードURL**を入力します。URLはhttpsで始まる必要があります。「送信データの安全性を確保するため、WebhookはHTTPSのみに対応しています。」
4. **コンテンツタイプ**を選択します:**application/json**または**application/x-www-form-urlencoded**。
5. **メソッド**を選択します。初期設定は**GET**で、データはURLに含めて送信されます。ボディで送信するには**POST**を選択してください。ほとんどのシステムはこちらを想定しています。
6. **認証**(POSTのみ)では、URLにユーザー名とパスワードが必要な場合は**Basic Auth**を選択し、**ユーザー名**と**パスワード**を入力します。不要な場合は**なし**のままにします。
7. リクエストに署名するための**シークレット**を入力します(推奨)。下記の「署名を検証する」をご覧ください。
8. システムからの応答を確認したい場合は、**レスポンスボディを記録**をオンにします。「デバッグ用にレスポンスボディを保存します。」
9. **有効**はオンのままにします。「Webhookが有効な場合のみイベントを配信します。」
10. イベントを選択します:「リードがキャンペーンに参加するたび」または「リードが賞品に当選したとき」。
11. 送信するフィールドを自分で指定したい場合は、**カスタムペイロード**をオンにします(下記参照)。
12. **Webhookを追加**をクリックします。「Webhookを追加しました」と表示されます。

**Webhooks**パネルには、キャンペーンのWebhookが**有効**または**無効**の状態とともに一覧表示され、直近のリクエストが失敗した場合は**前回の配信に失敗**と表示されます。**アクション**から**編集**、**配信を表示**、**削除**ができます。Webhookを編集する際、現在のシークレットを維持するには**シークレット**を空欄のままにしてください。

## アカウントWebhookを追加する

1. **設定** > **Webhooks**(**開発者**の下)に進みます。Webhookは**マイWebhook**の下(リードリストが複数ある場合は各リスト名の下)に一覧表示されます。
2. プラスマークのカードをクリックしてWebhookを追加します。**Webhookを追加**ダイアログに「選択したイベントが発生するたびに外部URLへリクエストを送信します。」と表示されます。
3. 上記と同様に、**ペイロードURL**、**コンテンツタイプ**(「Webhookのコンテンツタイプを選択」)、**メソッド**、**シークレット**を入力します。
4. **Webhookをトリガーするイベント**で、「新しいリードが作成されたとき」を選択します。
5. 独自のフィールドを使いたい場合は、「はい、カスタムペイロードを指定します(上級者向け)」にチェックを入れます。
6. 必要に応じて**レスポンスボディを記録**(「このWebhookはレスポンスボディを記録します」)にチェックを入れ、**有効**(「このフックがトリガーされるとイベントの詳細を配信します」)はチェックしたままにします。
7. **Webhookを追加**をクリックします。

Webhookをクリックすると、内容の変更(**変更を保存**)、**新しいシークレット**の設定、**配信を表示**、**Webhookを削除**(「この操作は元に戻せません!」)ができます。

## 送信される内容

初期設定では、ボディには`event`(イベント名:`lead_created_on_campaign`、`new_campaign_winner`、`lead_created`)と`data`オブジェクトが含まれます。

- `campaign`:キャンペーンの`id`と`name`(キャンペーンWebhook)
- `lead`:フィールドキー別のリードのフォーム項目(例:`first_name`)、および`id`、`phone_number`、`created_at`
- `lead.permissions`:各同意チェックボックスについて、同意の有無、文言、日時、IPアドレス(キャンペーンWebhook)
- `participant`:流入元の`channel`と参加日時(キャンペーンWebhook)
- `quiz`:名前付きクイズ設問への回答(「Simple」で始まる読みやすい名前でも含まれます)
- `prize`:賞品の`id`、`name`、`value`、`coupon_code`、当選日時(当選者Webhook)

空の値と、同意されなかった項目は除外されます。GETメソッドの場合は、同じデータがURLのクエリパラメータとして送信されます。

## カスタムペイロード

**カスタムペイロード**をオンにすると、選択したフィールドのみが送信され、`event`のラッパーは付きません。

1. **データマッピング**で**マッピングを追加**をクリックします。
2. システムが想定する**フィールド名**を入力します。英字、数字、ハイフン、アンダースコアが使えます。
3. 送信するScratcherのフィールド(「グループ → フィールド」)を選択するか、**カスタム値**を選んで固定の**値**を入力します。
4. フィールドごとに繰り返します。削除するにはゴミ箱アイコン(**削除**または**データマッピングを削除**)をクリックします。

## 署名を検証する

シークレットを設定すると、すべてのリクエストに`X-Hub-Signature`ヘッダーが付与されます。値は`sha1=`に続けて、シークレットをキーとしてJSONエンコードしたペイロード(上記のボディ)から算出したHMAC-SHA1ハッシュです。受信側でも同じ計算を行って比較すれば、リクエストがScratcherから送られたものか確認できます。

## 配信と再試行

- URLが応答しない場合やエラー(ステータス400以上)を返した場合、Scratcherは5秒後と1分後の2回、再試行します。
- リダイレクトには追従しないため、最終的なURLを指定してください。
- 配信履歴(キャンペーンでは**配信を表示**、アカウントWebhookでは**配信を表示**)を開くと、各リクエストとレスポンスを確認できます。各配信には**ID**、**リクエスト**、ステータスコード付きの**レスポンス**(記録している場合は**レスポンスボディ**も)が表示されます。**コピー**でペイロードをコピーできます。
- **失敗した配信のみ表示**をオンにすると、問題のある配信だけを確認できます。上部には「過去60日間の失敗した配信」が表示されます。
- **再試行**をクリックすると配信を再送できます:「Webhookを再送しています。」
- 「Webhookの配信ログは60日間保存されます。」

## トラブルシューティング

- 「…フィールドにはHTTPSを使用してください。」:**ペイロードURL**がhttpで始まっています。httpsを使用してください。
- すべての配信が応答なしで失敗する:ローカルや社内のアドレスなど、インターネットからアクセスできないURLです。公開URLを使用してください。
- システムにデータが届かない:メソッドが**GET**のため、データはURLに含まれています。**POST**に切り替えてください。
- システムが想定するフィールドがない:値が空だったか、同意されなかった項目です。存在しないフィールドは空として扱うようシステムを設定してください。

API、Webhook、MCP

- [REST APIを使い始める](https://scratcher.io/ja/help/developers/rest-api)
- [Webhookで自社システムにデータを送信](https://scratcher.io/ja/help/developers/webhooks)
- [自社のAIツールで使えるScratcher MCP](https://scratcher.io/ja/help/developers/mcp)

さらに学ぶ

## 関連記事

- [REST APIを使い始める](https://scratcher.io/ja/help/developers/rest-api): 適切なスコープを持つパーソナルアクセストークンを作成するか、OAuthアプリを登録して、自社のシステムからキャンペーン、リード、リストを読み取りましょう。
- [配信ステータスの確認とリードの再送信](https://scratcher.io/ja/help/integrations/delivery-status): リードがどのツールに送信されたかを確認し、エラーメッセージの意味を理解して問題を解決し、再送信しましょう。
- [Zapierで8,000以上のアプリと連携](https://scratcher.io/ja/help/integrations/zapier): Zapierを使えば、Scratcherの新規登録データをGoogleスプレッドシート、Slack、CRMなど数千のアプリに送信できます。

お困りですか？

## まだお困りですか？

担当者がサポートします。すでに Scratcher をご利用の場合は、プラットフォーム内のチャットが最も早い方法です。

- **[チャットで相談](https://platform.scratcher.io/ja/login)**

    ログインして右下のチャットボタンをクリックしてください。Rex がすぐに回答し、チームにもワンクリックでつながります。
- **[ミーティングを予約](https://scratcher.io/ja/book-a-meeting)**

    チームとの 30 分の無料ビデオ通話：製品ツアー、キャンペーンのアイデア、設定のサポート。
- **[メールで問い合わせ](mailto:contact@scratcher.io)**

    contact@scratcher.io までご連絡いただければ、折り返しご返信します。
