Skip to main content
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.
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.
L'onglet Outgoing listant 4 webhooks : 2 actifs, 1 en pause et 1 en attente

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

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é

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

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

Les clés de signature pendant une rotation

​
FAQ

Cliquez sur une question ci-dessous pour en savoir plus sur les webhooks sortants.
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.
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.
Non. L’envoi d’événements à vos webhooks n’utilise aucun crédit.
Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la version anglaise.