Aller au contenu principal

Webhooks

L'onglet Webhooks sert à gérer les webhooks, qui permettent de connecter Siesta AI à des systèmes et applications externes. Un webhook fournit une URL unique à laquelle un service externe peut envoyer des requêtes HTTP, déclenchant ainsi ou influençant le comportement du système.

Chaque webhook :

  • a son propre nom,
  • est lié à une clé API spécifique,
  • peut être actif ou inactif,
  • a une URL unique.

Les webhooks sont souvent utilisés comme déclencheurs pour Workflows, qui peuvent être lancés depuis des systèmes externes.

Aperçu des webhooks​

Sur l'écran principal de l'onglet Webhooks, une liste de tous les webhooks créés est affichée dans un tableau.

Colonnes affichées :

  • Nom – nom du webhook saisi par l'utilisateur
  • URL – URL générée automatiquement pour le webhook
  • État – état actuel du webhook (Actif / Inactif)
  • Actions – autres options de gestion du webhook (par exemple, modification)

En haut de la page, il est possible de :

  • rechercher des webhooks,
  • cliquer sur le bouton Ajouter un webhook.

Aperçu des webhooks

Création d'un nouveau webhook​

En cliquant sur Ajouter un webhook, une boîte de dialogue s'ouvre pour créer un nouveau webhook.

Champs du formulaire

  • Nom – champ obligatoire pour saisir le nom du webhook (par exemple, Webhook)
  • Actif – interrupteur permettant d'activer le webhook lors de sa création ou de le laisser inactif
  • Clé API – sélection de la clé API avec laquelle le webhook sera autorisé (par exemple, clé API pour mon script Python)

Actions

  • Annuler – ferme la boîte de dialogue sans créer de webhook
  • Créer – crée un nouveau webhook et génère son URL

Création d'un webhook

Détails du webhook​

Après avoir ouvert un webhook spécifique, sa page de détails s'affiche.

Informations affichées :

  • nom du webhook,
  • état (actif / inactif),
  • URL du webhook – adresse unique qui peut être copiée d'un simple clic.

Depuis les détails du webhook, il est possible de :

  • modifier les paramètres du webhook,
  • changer son état actif,
  • utiliser l'URL du webhook dans des applications externes ou dans des Workflows.

Détails du webhook

État du webhook​

L'état du webhook détermine s'il est prêt à recevoir des requêtes :

  • Actif – le webhook est allumé et disponible
  • Inactif – le webhook est éteint et les requêtes ne sont pas traitées

L'état est visible à la fois dans l'aperçu des webhooks et dans les détails du webhook.

Utilisation typique des webhooks​

Les webhooks sont principalement utilisés pour :

  • l'intégration de Siesta AI avec des applications externes,
  • le déclenchement de processus automatisés,
  • la connexion de scripts personnalisés (par exemple, Python),
  • le transfert de données entre systèmes en temps réel.

Résumé​

Les webhooks dans Siesta AI offrent un moyen simple et sécurisé de connecter la plateforme à des systèmes externes. Grâce à une gestion claire, un lien avec des clés API et la possibilité d'activer ou de désactiver, les webhooks peuvent être facilement contrôlés et gérés. Si vous utilisez un webhook comme déclencheur, nous vous recommandons de l'associer à des Workflows.