> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook でワークスペースのイベントを送信する

> ワークスペースで何かが起きたときに、署名付きリクエストを自社のシステムに送信します。ワークスペース設定で送信 Webhook を作成、有効化、一時停止、管理します。

送信 Webhook は、ワークスペースで何かが変わったときに自社のシステムに通知します。アプリの公開や AI チャットによる返信の完了など、ワークスペースで何かが起きると、Base44 は指定した URL に署名付きリクエストを送信します。これにより、変更を確認しなくてもシステムを最新の状態に保てます。

> [!WARNING]
>
> 送信 Webhook を使用するには Enterprise プラン (Business または Enterprise) が必要です。管理できるのはワークスペースのオーナーと管理者のみです。まず、開発者が URL に受信側を用意する必要があります。作成方法については、[送信 Webhook の概要](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md)を参照してください。

![4 つの Webhook (有効 2 つ、一時停止 1 つ、保留中 1 つ) が一覧表示された Outgoing タブ](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhooks-list.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=9db3c1b0c640a60be866ef912e96fca4)

Webhooks ページの送信 Webhook

***

## Webhook を作成する

イベントを受信する URL ごとに Webhook を作成します。1 つのワークスペースにつき最大 10 個まで作成できます。新しい Webhook は **Pending** の状態で、有効化するまで何も受信しません。作成後、Base44 にワークスペースの公開署名キーが表示されます。受信側はこのキーを使って、各リクエストが Base44 から送信されたことを確認します。このキーは開発者と安全に共有できます。

**Webhook を作成するには:**

1. 左下のワークスペース名をクリックし、**Settings** をクリックします。
2. サイドバーの **Webhooks** をクリックし、**Outgoing** タブをクリックします。
3. **Create webhook** をクリックします。
4. **Endpoint URL** を入力します。`https://` で始まる必要があります。
5. **Events to send** で、この URL が受信するイベントを選択します。イベントには 2 種類あります:
   * **アプリイベント:** ワークスペース内のアプリが作成、公開、オフライン化、ゴミ箱へ移動、またはゴミ箱から復元されたとき。
   * **AI チャットイベント:** アプリエディタの AI チャットがメッセージの処理を開始したとき (**Chat turn started**) または完了したとき (**Chat turn ended**)。
6. (任意) Webhook の用途がチームにわかるよう、**Description** を入力します。
7. **Create webhook** をクリックします。

![エンドポイント URL、選択された 3 つのイベント、説明が入力された Create webhook フォーム](https://mintcdn.com/base44/Cv0IQGEx6eX2LIU1/images/create-outgoing-webhook.png?fit=max\&auto=format\&n=Cv0IQGEx6eX2LIU1\&q=85\&s=d67e53d0c07a4791f5aab4869bbad414)

Webhook を作成する

***

## Webhook を有効化する

有効化すると、URL にテストイベントが送信されます。受信側が応答し、テストイベント内のコードを返すと、Webhook は **Active** になります。有効化が完了しない場合は、Base44 がその理由を表示します。たとえば、エンドポイントが時間内に応答しなかった、コードを返さなかったなどです。受信側を修正し、もう一度有効化してください。

**Webhook を有効化するには:**

1. 左下のワークスペース名をクリックし、**Settings** をクリックします。
2. サイドバーの **Webhooks** をクリックし、**Outgoing** タブをクリックします。
3. Webhook の横にある **More actions** アイコン  をクリックし、**Activate** を選択します。

![保留中の送信 Webhook で More actions メニューが開き、Activate が強調表示されている](https://mintcdn.com/base44/61xNA58oJUO_TLT3/images/outgoing-webhook-activate-menu.png?fit=max\&auto=format\&n=61xNA58oJUO_TLT3\&q=85\&s=bd0fe1030aa91e8178100c9dc8474dc7)

保留中の Webhook を有効化する

***

## Webhook を管理する

受信側の更新中は Webhook を一時停止したり、受信する内容を変更したり、削除したりできます。数日連続で失敗した Webhook は、Base44 によって **Auto-paused** になります。受信側が再び機能するようになったら再開してください。Base44 は送信を始める前に、もう一度有効化テストを実行します。

**Webhook を管理するには:**

1. 左下のワークスペース名をクリックし、**Settings** をクリックします。
2. サイドバーの **Webhooks** をクリックし、**Outgoing** タブをクリックします。
3. Webhook の横にある **More actions** アイコン  をクリックし、オプションを選択します:
   * **Send test event:** テストイベントを送信して受信側を確認します。
   * **Edit endpoint:** URL、イベント、説明を変更します。URL を変更すると、新しい URL を有効化するまで配信が停止します。
   * **Pause deliveries** または **Resume deliveries:** 送信を停止または再開します。Webhook の一時停止中に発生したイベントは、後から送信されません。
   * **Delete endpoint:** URL への送信を直ちに停止します。

> [!NOTE]
>
> 古い `builder.turn_started.v1` と `builder.turn_ended.v1` イベントのサブスクリプションは、イベントを受信しなくなりました。代わりに **Chat turn started** と **Chat turn ended** を選択してください。

![有効な Webhook で More actions メニューが開き、Send test event、Edit endpoint、Pause deliveries、Delete endpoint が表示されている](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhook-actions-menu.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=93c4093385d7bf5870fa2618d5ea03fe)

Webhook を管理する

***

## 署名キーを管理する

すべてのリクエストは、ワークスペースのキーで署名されます。ローテーションすると、キーが新しいものに置き換わります。Base44 は 24 時間、古いキーと新しいキーの両方で署名します。そのため、開発者が新しいキーを追加する間も受信側は機能し続けます。追加が完了したら、**Finish rotation** をクリックすると、古いキーの使用を早めに停止できます。

> [!WARNING]
>
> **Revoke** を使うと、Base44 はそのキーでの署名を直ちに停止します。そのキーしか持たない受信側は、新しいキーを取得するまですべての配信を拒否します。通常の変更では、代わりにキーをローテーションしてください。

**署名キーをローテーションするには:**

1. 左下のワークスペース名をクリックし、**Settings** をクリックします。
2. サイドバーの **Webhooks** をクリックし、**Outgoing** タブをクリックします。
3. **See public keys** をクリックします。
4. **Rotate key** をクリックし、確認のためにもう一度 **Rotate key** をクリックします。

![ローテーション中の Public signing keys ダイアログ。現在のキー、古いキーの停止日、Finish rotation が表示されている](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhook-signing-keys.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=8ede530dbaeb433e3fc2c19c1707030e)

ローテーション中の署名キー

***

## よくある質問

送信 Webhook について詳しく知るには、以下の質問をクリックしてください。

> **1 つのアプリのイベントだけを送信できますか?**
>
> いいえ。Webhook は、ワークスペース内のすべてのアプリについて、選択したイベントを受信します。各イベントには対象のアプリが含まれるため、受信側は不要なアプリを無視できます。

> **サーバーがダウンしているとどうなりますか?**
>
> Base44 は各イベントを約 1 日間再試行し続けます。再試行の間隔は徐々に長くなります。Webhook が数日間失敗し続けると、Base44 が自動的に一時停止します。サーバーが再び機能するようになったら、**More actions** メニューから Webhook を再開してください。

> **Webhook はクレジットを使用しますか?**
>
> いいえ。Webhook へのイベント送信にクレジットは使用されません。

> **開発者はどのように受信側を作成しますか?**
>
> [送信 Webhook の開発者ガイド](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md) を共有してください。[イベントタイプ](https://docs.base44.com/developers/references/outbound-webhooks/get-started/event-types.md)、[リクエストの検証](https://docs.base44.com/developers/references/outbound-webhooks/get-started/verifying-requests.md)、[配信と再試行](https://docs.base44.com/developers/references/outbound-webhooks/get-started/delivery-and-retries.md) について説明しています。

> [!NOTE]
>
> このページは AI によって翻訳されました。最も正確で最新の情報については、[英語版](https://docs.base44.com/index.md) を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.