# Webhook で自分のシステムにイベントを送る

> Webhook は、新規注文や在庫の変動など、ストアで何かが起きた瞬間に自分のシステムに知らせます。設定 > Webhook でエンドポイント URL を追加し、イベントを選び、テストを送信し、すべての配信とその応答を確認できます。

ヘルプセンター / 連携 - 2026年11月2日 更新

Webhook は、ストアで何かが起きた瞬間に、指定したウェブアドレスへメッセージを送ります。たとえば、新規注文を発送システムへ、在庫の変動を在庫表へ、新しい顧客を CRM へ、そのまま届けられます。自分のシステムから Shoprocket に変更を問い合わせ続ける必要はありません。

メッセージの送り先が必要です。自分のサーバー上のアドレスか、自動化プラットフォームなどアドレスを用意してくれるツールです。受信側の設定は通常、開発者の仕事です。

## はじめる前に

- Webhook は **Growth** プラン以上で利用できます。それより下のプランでは、どのプランに含まれるかが画面に表示されます。
- Webhook は **API キー** とともに **開発者ツール** アプリに含まれています。サイドバーの **設定** に **Webhook** が見当たらない場合は、**アプリ** を開き、**開発者** の下にある **開発者ツール** を見つけて **追加** をクリックします。[アプリを追加・削除する](https://shoprocket.io/ja/help/the-apps-page.md) を参照してください。

## エンドポイントを追加する

1. ダッシュボードで **設定 > Webhook** を開き、**エンドポイントを追加** をクリックします。
2. **名前** を入力します。送り先のシステムにちなんだ名前にすると、削除したときに何が止まるか分かります。
3. **エンドポイント URL** を入力します。`https://` で始まる必要があります。
4. 実際のビジネスで使うエンドポイントでは、**テストモードのエンドポイント** をオフのままにします。テスト注文だけを受け取るエンドポイントではオンにします。
5. 送信するイベントを選びます。イベントを 1 つずつチェックするか、グループごとに **すべて選択**、または **すべてのイベントを購読** を使います。システムが処理するイベントだけにするのがおすすめです。イベントの横の **例** をクリックすると、送信されるメッセージを確認できます。
6. **エンドポイントを追加** をクリックします。

![Webhook エンドポイントの追加ドロワー: 名前 Fulfilment、https のエンドポイント URL、テストモードのエンドポイントはオフ、order.created にチェックが入りペイロード例を表示](https://shoprocket.io/img/help/webhooks/add-endpoint.webp)

## イベント

| グループ | イベント |
|---|---|
| **注文** | 作成、更新、支払い、返金、発送完了、一部発送、削除 |
| **顧客** | 作成、更新、削除 |
| **商品** | 作成、更新、削除 |
| **在庫** | 在庫の更新 |
| **割引** | 作成、更新、削除 |
| **カテゴリ** | 作成、更新、削除 |
| **定期購入** | 作成、更新、更新失敗、一時停止、再開、キャンセル、期限切れ |
| **ライセンスキー** | 割り当て、停止、再有効化、期限切れ、無効化 |

## テストを送信する

エンドポイントの **テスト送信** をクリックします。Shoprocket がすぐにテストイベントを送り、エンドポイントが受け付けたか、サーバーがどう応答したかを表示します。たとえば「140ms で 200 を応答しました。」や、まったく到達できなかったことなどです。

## 送信内容を確認する

エンドポイントの下にある **最近の配信** カードには、Shoprocket が送信しようとしたすべてのイベントが表示されます。日時、サーバーが返した応答コード、試行回数です。配信のステータスは **配信済み**、**待機中**、**再試行中**、**失敗** のいずれかです。自分の側で問題を直したら、任意の配信で **再送** をクリックすると、もう一度送信できます。

![エンドポイントの最近の配信: HTTP 200 で配信済みのイベント、HTTP 500 で再試行中の 1 件、再送ボタン](https://shoprocket.io/img/help/webhooks/recent-deliveries.webp)

## 配信に失敗したとき

サーバーは各メッセージに 2xx の応答コードで応答する必要があります。そうでない場合、Shoprocket は約 1 日間、再試行を続けます。

1 つのエンドポイントへの配信が 20 回連続で失敗すると、エンドポイントは停止され、その理由が表示されます。エンドポイントを直してから **今すぐ再度有効にする** をクリックします。停止中に溜まったものは、そのあと送信されます。エンドポイントが停止される前には、失敗が重なるにつれて警告が表示されます。たとえば「3 件の配信が連続で失敗しました。20 件に達すると、このエンドポイントは自動的に停止されます。」です。

## エンドポイントを編集・削除する

エンドポイントの編集ボタンをクリックして名前、アドレス、イベントを変更し、**保存** をクリックします。そのエンドポイントへの送信を完全にやめるには、**削除** をクリックして確認します。

## 開発者向け

すべてのメッセージはエンドポイントの署名シークレットで署名されているため、サーバーで本当に Shoprocket から届いたものか確認できます。エンドポイントの **署名シークレットを表示** をクリックしてコピーします。各メッセージにはイベント名と配信 ID も含まれるので、サーバーで重複を無視できます。署名の確認方法、各イベントのペイロード、再試行の詳細は開発者ガイドにあります。[Webhook](https://shoprocket.io/docs/webhooks.md) をご覧ください。

## 関連記事

- [API キーを作成する](https://shoprocket.io/ja/help/api-keys.md)
- [Zapier](https://shoprocket.io/ja/help/zapier.md)
- [テストモードと本番](https://shoprocket.io/ja/help/test-mode-vs-live.md)

[ダッシュボードで Webhook を開く](https://app.shoprocket.io/go/settings/webhooks)

---

- HTML version: https://shoprocket.io/ja/help/webhooks
- Language: 日本語 (ja)
- Also in: [العربية](https://shoprocket.io/ar/help/webhooks.md), [Deutsch](https://shoprocket.io/de/hilfe/ereignisse-mit-webhooks-senden.md), [Ελληνικά](https://shoprocket.io/el/help/webhooks.md), [English](https://shoprocket.io/help/webhooks.md), [Español](https://shoprocket.io/es/ayuda/envia-eventos-con-webhooks.md), [Français](https://shoprocket.io/fr/aide/envoyer-des-evenements-avec-les-webhooks.md), [עברית](https://shoprocket.io/he/help/webhooks.md), [हिन्दी](https://shoprocket.io/hi/help/webhooks.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/webhook.md), [Italiano](https://shoprocket.io/it/aiuto/invia-eventi-con-i-webhook.md), [Lietuvių](https://shoprocket.io/lt/pagalba/webhookai.md), [Norsk](https://shoprocket.io/nb/hjelp/webhooks.md), [Nederlands](https://shoprocket.io/nl/hulp/webhooks.md), [Polski](https://shoprocket.io/pl/pomoc/webhooki.md), [Português](https://shoprocket.io/pt/ajuda/envie-eventos-com-webhooks.md), [Română](https://shoprocket.io/ro/ajutor/webhooks.md), [Русский](https://shoprocket.io/ru/help/webhooks.md), [ไทย](https://shoprocket.io/th/help/webhooks.md), [Türkçe](https://shoprocket.io/tr/yardim/webhooklar.md), [中文](https://shoprocket.io/zh/help/webhooks.md)
