Déclencheur Webhook

Écrit par Stanislas

Dernière mise à jour Il y a 4 mois

Les déclencheurs Webhook vous permettent de démarrer automatiquement des automatisations d'agents lorsque des systèmes externes envoient des données à Swiftask via des requêtes HTTP POST. Au lieu de déclencher manuellement un agent, vous configurez une URL de webhook que les services externes peuvent appeler — lorsqu'ils le font, votre automatisation s'exécute instantanément.

Aperçu

Un déclencheur webhook est un point de terminaison URL auquel les systèmes externes peuvent envoyer des données. Lorsqu'une requête POST arrive à cette URL, Swiftask active automatiquement votre automatisation configurée et transmet les données entrantes à votre agent. C'est idéal pour intégrer Swiftask à des services externes comme des systèmes de tickets, des créateurs de formulaires, des processeurs de paiement ou des applications personnalisées.

Considérez un déclencheur webhook comme une sonnette pour votre automatisation. Quand quelqu'un l'actionne (envoie une requête POST), votre agent se réveille et gère la tâche.

Prérequis

Avant de créer un déclencheur webhook, vous avez besoin de :

  • Un agent configuré : L'agent doit avoir des objectifs et des instructions clairs, ainsi que toutes les compétences nécessaires (envoyer des e-mails, exporter des fichiers, enregistrer dans une base de données, etc.)

  • Une base de connaissances (si nécessaire) : Si votre agent fait référence à des documents ou des données, ajoutez-les d'abord à la base de connaissances de l'agent

  • Accès aux Automatisations : Vous devez avoir l'autorisation de créer des automatisations dans votre espace de travail

  • Un système externe prêt : Vous aurez besoin d'un service ou d'une application externe capable d'envoyer des requêtes HTTP POST

Guide étape par étape

Étape 1 : Accédez à la section Déclencheurs

Accédez à l'agent que vous souhaitez automatiser.

  1. Cliquez sur Agents dans la barre latérale gauche

  2. Trouvez votre agent et cliquez pour l'ouvrir

  3. Dans la barre latérale gauche, recherchez la section Automatisations

  4. Cliquez sur Déclencheurs (marqué comme NOUVEAU)

  5. Vous verrez une liste de tous les déclencheurs existants pour cet agent

Étape 2 : Choisissez le type de déclencheur

Cliquez sur le bouton Nouveau Déclencheur (bouton rouge avec icône +).

Une boîte de dialogue s'ouvre, affichant les options de type de déclencheur.

  1. Recherchez l'option Webhook

  2. Lisez la description : "Déclenchement via URL de webhook HTTP. Parfait pour l'intégration avec des services externes."

  3. Cliquez sur Webhook pour le sélectionner

Étape 3 : Configurez le déclencheur webhook

La boîte de dialogue passe à l'étape de configuration.

Vous verrez un formulaire avec le champ suivant :

Nom du Déclencheur

  1. Cliquez sur le champ de saisie intitulé "Nom du Déclencheur"

  2. Entrez un nom descriptif qui identifie ce déclencheur

  3. Exemples : "Ticket de Support Client", "Nouvelle Soumission de Formulaire", "Paiement Reçu"

  4. Ce nom apparaît dans votre liste de déclencheurs et les journaux, soyez donc spécifique

La boîte de dialogue explique : "Après avoir créé ce déclencheur, vous recevrez une URL de webhook unique que vous pourrez utiliser pour déclencher votre automatisation depuis n'importe quel service externe."

Étape 4 : Vérifiez votre déclencheur

Après avoir entré le nom du déclencheur, cliquez sur Suivant.

La boîte de dialogue passe à l'étape de vérification.

Vous verrez un résumé de votre configuration webhook :

  • Type de déclencheur : Webhook

  • Description : "Déclenchement via URL de webhook HTTP. Parfait pour l'intégration avec des services externes."

  • Nom du Déclencheur : Le nom que vous avez entré

Vérifiez les informations pour vous assurer qu'elles sont correctes.

Étape 5 : Créez le déclencheur

Une fois la configuration vérifiée :

  1. Cliquez sur le bouton rouge Créer le Déclencheur

  2. La boîte de dialogue se ferme

  3. Vous revenez à la liste Déclencheurs

  4. Votre nouveau déclencheur webhook apparaît maintenant dans la liste avec le statut "Actif"

Étape 6 : Obtenez votre URL de webhook

Après la création du déclencheur, vous pouvez consulter ses détails pour obtenir l'URL de webhook.

  1. Dans la liste Déclencheurs, trouvez votre déclencheur webhook

  2. Cliquez dessus pour ouvrir le panneau de détails

  3. Faites défiler pour trouver URL du Webhook (POST)

  4. Copiez l'URL complète — c'est ce que les systèmes externes appelleront

Le panneau de détails montre également :

  • ID : Identifiant unique pour ce déclencheur

  • Type : WEBHOOK

  • Nom du Déclencheur : Le nom que vous avez configuré

  • Statut : Actif (ou Inactif si désactivé)

  • Créé le / Mis à jour le : Horodatages

  • Statut de l'Automatisation : EN ATTENTE (en attente de la première exécution)

  • Exemple d'utilisation : Une commande curl montrant comment appeler le webhook

Configurer votre système externe

Une fois que vous avez votre URL de webhook, vous devez configurer votre système externe pour envoyer des requêtes POST vers celle-ci.

Structure de base de l'URL de webhook

Votre URL de webhook ressemble à ceci :

https://graphql.swiftask.ai/api/agent-automation/webhook/[identifiant-unique]

Envoyer des données au webhook

Les systèmes externes doivent envoyer une requête POST avec des données JSON :

curl -X POST https://graphql.swiftask.ai/api/agent-automation/webhook/[identifiant-unique] \
-H "Content-Type: application/json" \
-d '{
  "data": "Toutes les données que vous souhaitez envoyer à l'agent"
}'

L'agent reçoit ces données et les traite selon ses instructions configurées.

Cas d'utilisation pratiques

Cas d'utilisation 1 : Automatisation des tickets de support client

  • Configuration : Vous utilisez un système de tickets (comme Zendesk) pour gérer les demandes de support.

  • Déclencheur webhook : Lorsqu'un nouveau ticket est créé, le système de tickets envoie une requête POST à votre webhook Swiftask.

  • Action de l'agent : Votre agent de support lit les détails du ticket, recherche dans votre base de connaissances les informations pertinentes et envoie un e-mail de réponse au client.

  • Résultat : Les clients reçoivent des réponses instantanées aux questions courantes sans intervention manuelle.

Cas d'utilisation 2 : Traitement des soumissions de formulaire

  • Configuration : Vous avez un formulaire de contact sur votre site web construit avec un service de formulaires (comme Typeform ou Formspree).

  • Déclencheur webhook : Lorsque quelqu'un soumet le formulaire, le service de formulaires envoie les données de soumission à votre webhook Swiftask.

  • Action de l'agent : Votre agent lit la réponse du formulaire, catégorise la demande et la route vers le membre de l'équipe approprié ou envoie un e-mail d'accusé de réception.

  • Résultat : Les soumissions de formulaires sont automatiquement traitées et catégorisées instantanément.

Cas d'utilisation 3 : Gestion des notifications de paiement

  • Configuration : Vous traitez les paiements via un processeur de paiement (comme Stripe).

  • Déclencheur webhook : Lorsqu'un paiement est reçu, le processeur de paiement envoie une notification webhook à Swiftask.

  • Action de l'agent : Votre agent reçoit les détails du paiement, met à jour votre base de données, génère une facture et envoie un e-mail de confirmation au client.

  • Résultat : Le traitement des paiements est entièrement automatisé, de la notification à la confirmation du client.

Cas d'utilisation 4 : Enrichissement de données externes

  • Configuration : Vous avez un système CRM avec de nouvelles pistes qui arrivent.

  • Déclencheur webhook : Lorsqu'une nouvelle piste est créée dans votre CRM, il envoie les données de la piste à votre webhook Swiftask.

  • Action de l'agent : Votre agent reçoit les informations sur la piste, recherche l'entreprise, enrichit le profil de la piste avec des données supplémentaires et renvoie les informations mises à jour à votre CRM.

  • Résultat : Votre CRM obtient automatiquement des données de pistes enrichies sans recherche manuelle.

Conseils & meilleures pratiques

  • Gardez des noms de déclencheurs descriptifs : Utilisez des noms qui indiquent clairement ce qui déclenche l'automatisation. "Support Client" est mieux que "Déclencheur 1".

  • Testez d'abord avec curl : Avant d'intégrer avec votre système externe, testez manuellement votre URL de webhook en utilisant curl ou Postman pour vous assurer qu'elle fonctionne.

  • Gérez les erreurs avec élégance : Si votre agent échoue à traiter les données du webhook, vérifiez les journaux d'exécution pour voir ce qui n'a pas fonctionné. Ajustez les instructions de votre agent si nécessaire.

  • Surveillez les exécutions de webhook : Dans la liste Déclencheurs, vous pouvez activer/désactiver les déclencheurs et voir leur statut. Surveillez le "Statut de l'Automatisation" pour voir si les déclencheurs s'exécutent avec succès.

  • Utilisez des données significatives dans votre webhook : Envoyez toutes les informations dont votre agent a besoin pour accomplir la tâche. N'envoyez pas de données vides ou incomplètes.

  • Sécurisez votre webhook : Traitez votre URL de webhook comme un mot de passe. Ne la partagez pas publiquement ou ne la stockez pas dans un système de contrôle de version. Si elle est compromise, supprimez le déclencheur et créez-en un nouveau.

Dépannage

"L'URL du webhook ne fonctionne pas"

  • Vérifiez que l'URL est copiée exactement comme indiqué dans les détails du déclencheur

  • Vérifiez que votre système externe envoie une requête POST (pas GET)

  • Assurez-vous que l'en-tête Content-Type est défini sur "application/json"

  • Consultez les journaux d'exécution du déclencheur pour voir si le webhook a été reçu

"Le déclencheur apparaît mais l'automatisation ne s'exécute pas"

  • Vérifiez que le statut du déclencheur est "Actif" (activez-le si nécessaire)

  • Vérifiez que l'agent a toutes les compétences nécessaires configurées

  • Vérifiez que les instructions de l'agent sont claires et spécifiques

  • Consultez les journaux d'exécution pour voir les messages d'erreur

"Je dois mettre à jour l'URL du webhook"

  • Supprimez le déclencheur actuel et créez-en un nouveau

  • Mettez à jour votre système externe pour utiliser la nouvelle URL de webhook

"Plusieurs déclencheurs webhook pour le même agent"

  • Vous pouvez créer plusieurs déclencheurs webhook pour différents systèmes externes

  • Chaque déclencheur obtient sa propre URL unique

  • Chaque déclencheur peut avoir des noms différents pour une identification facile

Ressources supplémentaires

  • Introduction à l'automatisation avec des agents : Apprenez les concepts généraux de l'automatisation d'agents et comment fonctionnent les déclencheurs

  • Création d'une automatisation avec des agents : Configurez le flux de travail d'automatisation complet après avoir créé votre déclencheur

  • Agents > Créer un agent IA > Objectifs & instructions : Configurez ce que votre agent doit faire lorsque le webhook se déclenche

  • Agents > Créer un agent IA > Compétences (Outils IA) : Ajoutez des capacités comme l'envoi d'e-mails ou la mise à jour de bases de données

Prêt à automatiser ? Créez votre premier déclencheur webhook maintenant et commencez à connecter des systèmes externes à vos agents Swiftask. L'URL de webhook est générée instantanément et prête à l'emploi.