> ## 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.

# Envoyer les événements de l'espace de travail avec des webhooks

> Envoyez une requête signée à vos propres systèmes quand un événement se produit dans votre espace de travail. Créez, activez, mettez en pause et gérez des webhooks sortants dans les paramètres de l'espace de travail.

Les webhooks sortants informent vos propres systèmes quand quelque chose change dans votre espace de travail. Quand un événement se produit, comme la publication d'une application ou la fin d'une réponse du chat IA, Base44 envoie une requête signée à l'URL de votre choix. Vos systèmes restent ainsi à jour sans avoir à vérifier les changements.

> [!WARNING]
>
> Vous devez avoir un plan Enterprise (Business ou Enterprise) pour utiliser les webhooks sortants. Seuls les propriétaires et administrateurs de l'espace de travail peuvent les gérer. Vos développeurs ont d'abord besoin d'un récepteur à l'URL. Pour savoir comment en créer un, consultez la [présentation des webhooks sortants](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md).

![L'onglet Outgoing listant 4 webhooks : 2 actifs, 1 en pause et 1 en attente](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhooks-list.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=9db3c1b0c640a60be866ef912e96fca4)

Webhooks sortants sur la page Webhooks

***

## Créer un webhook

Créez un webhook pour chaque URL qui doit recevoir des événements. Vous pouvez en créer jusqu'à 10 par espace de travail. Un nouveau webhook est **Pending** et ne reçoit rien tant que vous ne l'activez pas. Après sa création, Base44 affiche la clé de signature publique de votre espace de travail. Votre récepteur l'utilise pour confirmer que chaque requête provient de Base44. Vous pouvez partager cette clé sans risque avec vos développeurs.

**Pour créer un webhook :**

1. Cliquez sur le nom de votre espace de travail en bas à gauche, puis sur **Settings**.
2. Cliquez sur **Webhooks** dans la barre latérale, puis sur l'onglet **Outgoing**.
3. Cliquez sur **Create webhook**.
4. Saisissez l'**Endpoint URL**. Elle doit commencer par `https://`.
5. Sous **Events to send**, sélectionnez les événements que cette URL doit recevoir. Il en existe 2 types :
   * **Événements d'application :** une application de votre espace de travail est créée, publiée, mise hors ligne, placée dans la corbeille ou restaurée depuis la corbeille.
   * **Événements du chat IA :** le chat IA de l'éditeur d'application commence à traiter un message (**Chat turn started**) ou le termine (**Chat turn ended**).
6. (Facultatif) Saisissez une **Description** pour que votre équipe sache à quoi sert le webhook.
7. Cliquez sur **Create webhook**.

![Le formulaire Create webhook avec une URL de point de terminaison, 3 événements sélectionnés et une description](https://mintcdn.com/base44/Cv0IQGEx6eX2LIU1/images/create-outgoing-webhook.png?fit=max\&auto=format\&n=Cv0IQGEx6eX2LIU1\&q=85\&s=d67e53d0c07a4791f5aab4869bbad414)

Créer un webhook

***

## Activer un webhook

L'activation envoie un événement de test à votre URL. Le webhook devient **Active** quand votre récepteur répond et renvoie le code contenu dans l'événement de test. Si l'activation échoue, Base44 en indique la raison. Par exemple, votre point de terminaison n'a pas répondu à temps ou n'a pas renvoyé le code. Corrigez le récepteur et relancez l'activation.

**Pour activer un webhook :**

1. Cliquez sur le nom de votre espace de travail en bas à gauche, puis sur **Settings**.
2. Cliquez sur **Webhooks** dans la barre latérale, puis sur l'onglet **Outgoing**.
3. Cliquez sur l'icône **More actions**  à côté du webhook et sélectionnez **Activate**.

![Un webhook sortant en attente avec son menu More actions ouvert et Activate encadré](https://mintcdn.com/base44/61xNA58oJUO_TLT3/images/outgoing-webhook-activate-menu.png?fit=max\&auto=format\&n=61xNA58oJUO_TLT3\&q=85\&s=bd0fe1030aa91e8178100c9dc8474dc7)

Activer un webhook en attente

***

## Gérer les webhooks

Mettez un webhook en pause pendant la mise à jour de votre récepteur, modifiez ce qu'il reçoit ou supprimez-le. Un webhook qui échoue plusieurs jours de suite passe en **Auto-paused**. Quand votre récepteur fonctionne à nouveau, reprenez le webhook. Base44 relance alors le test d'activation avant de recommencer les envois.

**Pour gérer un webhook :**

1. Cliquez sur le nom de votre espace de travail en bas à gauche, puis sur **Settings**.
2. Cliquez sur **Webhooks** dans la barre latérale, puis sur l'onglet **Outgoing**.
3. Cliquez sur l'icône **More actions**  à côté du webhook et sélectionnez une option :
   * **Send test event :** envoie un événement de test pour vérifier votre récepteur.
   * **Edit endpoint :** modifie l'URL, les événements ou la description. Modifier l'URL interrompt les envois jusqu'à ce que vous activiez la nouvelle URL.
   * **Pause deliveries** ou **Resume deliveries :** arrête ou relance les envois. Les événements survenus pendant la pause ne sont pas envoyés ultérieurement.
   * **Delete endpoint :** arrête immédiatement les envois vers l'URL.

> [!NOTE]
>
> Les abonnements aux anciens événements `builder.turn_started.v1` et `builder.turn_ended.v1` ne reçoivent plus d'événements. Sélectionnez plutôt **Chat turn started** et **Chat turn ended**.

![Le menu More actions ouvert sur un webhook actif, avec Send test event, Edit endpoint, Pause deliveries et 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)

Gérer un webhook

***

## Gérer la clé de signature

Chaque requête est signée avec la clé de votre espace de travail. La rotation la remplace par une nouvelle clé. Pendant 24 heures, Base44 signe avec l'ancienne et la nouvelle clé. Votre récepteur continue ainsi de fonctionner pendant que vos développeurs ajoutent la nouvelle clé. Une fois terminé, cliquez sur **Finish rotation** pour cesser plus tôt d'utiliser l'ancienne clé.

> [!WARNING]
>
> **Revoke** arrête immédiatement la signature avec une clé. Les récepteurs qui ne possèdent que cette clé rejettent chaque envoi jusqu'à ce qu'ils reçoivent la nouvelle. Pour un changement de routine, effectuez plutôt une rotation de la clé.

**Pour effectuer la rotation de la clé de signature :**

1. Cliquez sur le nom de votre espace de travail en bas à gauche, puis sur **Settings**.
2. Cliquez sur **Webhooks** dans la barre latérale, puis sur l'onglet **Outgoing**.
3. Cliquez sur **See public keys**.
4. Cliquez sur **Rotate key**, puis de nouveau sur **Rotate key** pour confirmer.

![La boîte de dialogue Public signing keys pendant une rotation, avec la clé actuelle, la date d'arrêt de l'ancienne clé et 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)

Les clés de signature pendant une rotation

***

## FAQ

Cliquez sur une question ci-dessous pour en savoir plus sur les webhooks sortants.

> **Un webhook peut-il envoyer les événements d'une seule application ?**
>
> Non. Un webhook reçoit les événements choisis pour toutes les applications de votre espace de travail. Chaque événement indique l'application concernée. Votre récepteur peut donc ignorer les applications inutiles.

> **Que se passe-t-il si mon serveur est indisponible ?**
>
> Base44 réessaie chaque événement pendant environ une journée, en espaçant de plus en plus les tentatives. Si votre webhook échoue pendant plusieurs jours, Base44 le met automatiquement en pause. Quand votre serveur fonctionne à nouveau, reprenez le webhook depuis son menu **More actions**.

> **Les webhooks utilisent-ils des crédits ?**
>
> Non. L'envoi d'événements à vos webhooks n'utilise aucun crédit.

> **Comment mes développeurs créent-ils un récepteur ?**
>
> Partagez-leur le [guide développeur des webhooks sortants](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md). Il couvre les [types d'événements](https://docs.base44.com/developers/references/outbound-webhooks/get-started/event-types.md), la [vérification des requêtes](https://docs.base44.com/developers/references/outbound-webhooks/get-started/verifying-requests.md) ainsi que la [livraison et les nouvelles tentatives](https://docs.base44.com/developers/references/outbound-webhooks/get-started/delivery-and-retries.md).

> [!NOTE]
>
> Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](https://docs.base44.com/index.md).


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