Déclencheurs depuis un webhook

Aperçu

Un déclencheur webhook est un point de terminaison URL HTTP dédié qui lance une automatisation d'agent dès qu'un système externe envoie des données à Swiftask via une requête HTTP POST. Au lieu d'ouvrir une session de chat ou de lancer une action manuellement, l'agent se réveille immédiatement lorsque le point de terminaison reçoit les données entrantes.

Ce déclencheur relie vos applications externes à vos agents IA Swiftask. Lorsqu'un événement survient dans un outil tiers, ce dernier appelle l'URL du webhook en transmettant la charge utile directement dans le flux de travail de l'agent.

Quand utiliser les déclencheurs webhook

Les déclencheurs webhook conviennent aux flux de travail pilotés par les événements où des plateformes externes doivent solliciter automatiquement des capacités d'IA.

Utilisez les déclencheurs webhook pour connecter des plateformes populaires telles que :

• Plateformes de support client (Zendesk, Freshdesk, Intercom) : Router automatiquement de nouveaux tickets, analyser le sentiment ou rédiger des ébauches de réponse.

• Générateurs de formulaires (Typeform, Google Forms, Tally, Jotform) : Traiter les réponses soumises, catégoriser les entrées et déclencher des tâches de suivi.

• Processeurs de paiement et e-commerce (Stripe, Shopify, WooCommerce) : Analyser les confirmations de paiement, générer des récapitulatifs ou notifier la comptabilité.

• CRM (HubSpot, Salesforce, Pipedrive) : Enrichir les profils de prospects entrants et lancer des actions de prospection.

• Outils pour développeurs et CI/CD (GitHub, GitLab, Sentry) : Examiner les pull requests, résumer les alertes de build ou trier les journaux d'incidents.

• Plateformes d'automatisation (Zapier, Make, n8n) : Recevoir des charges utiles issues de flux de travail multi-étapes existants.

Prérequis

Avant de configurer un déclencheur webhook, assurez-vous d'avoir :

• Un agent configuré : Un agent doté d'instructions définies et des compétences requises (ex. : envoyer des e-mails, mettre à jour des bases de données, exporter des fichiers).

• Une base de connaissances d'agent (facultatif) : Des documents ou sources de connaissances reliés à l'agent si la tâche automatisée s'appuie sur des données internes.

• Permissions d'espace de travail : Les droits d'accès nécessaires pour configurer des agents et des automatisations dans votre espace de travail Swiftask.

• Un service externe : Un service tiers, script personnalisé ou application capable d'émettre des requêtes HTTP POST avec des charges utiles JSON.

Guide étape par étape

Étape 1 : Ouvrir les automatisations de l'agent

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

1. Cliquez sur Agents dans la barre latérale gauche et sélectionnez votre agent cible.

2. Dans le menu de configuration de l'agent à gauche, repérez la section Automatisations et cliquez sur Déclencheurs.

Étape 2 : Initier un nouveau déclencheur

Lancez le flux de création depuis le tableau de bord des déclencheurs.

1. Consultez votre tableau de bord des déclencheurs, qui affiche l'adresse e-mail directe de l'agent ainsi que les déclencheurs existants.

2. Cliquez sur le bouton rouge + Nouveau déclencheur en haut à droite.

Étape 3 : Sélectionner le type de déclencheur Webhook

Choisissez la façon dont les systèmes externes déclencheront votre agent.

1. Dans la fenêtre Créer un nouveau déclencheur sous Sélectionner un type, localisez l'option Webhook.

2. Cliquez sur Webhook ("Déclenchez via une URL webhook HTTP. Parfait pour l'intégration avec des services externes.").

Étape 4 : Configurer le nom du déclencheur

Définissez un nom pour identifier clairement ce déclencheur dans vos journaux et paramètres.

1. À l'étape Configurer, cliquez sur le champ de saisie Nom du déclencheur.

2. Saisissez un libellé descriptif (par exemple, "Test webhook trigger" ou "Réception tickets support").

3. Cliquez sur Suivant pour continuer.

Étape 5 : Vérifier et créer le déclencheur

Contrôlez vos paramètres avant l'enregistrement.

1. À l'étape Vérifier, contrôlez le type de déclencheur sélectionné et son nom.

2. Cliquez sur le bouton rouge Créer le déclencheur.

Étape 6 : Confirmer le statut actif

Assurez-vous que votre déclencheur apparaît bien dans la liste et qu'il est activé.

1. La fenêtre modale se ferme et vous ramène à la page Déclencheurs.

2. Vérifiez que votre nouveau déclencheur webhook s'affiche dans la liste avec le badge Actif et l'interrupteur activé.

Étape 7 : Récupérer l'URL du webhook et la charge utile de test

Accédez aux détails du point de terminaison pour connecter vos systèmes externes.

1. Cliquez sur la carte du déclencheur dans la liste pour ouvrir le panneau latéral Détails du déclencheur.

2. Localisez le champ URL du webhook (POST) et cliquez sur l'icône de copie pour copier l'URL.

3. Consultez l'encadré Exemple d'utilisation pour examiner une commande curl préformatée.

4. Utilisez le bouton Historique dès que vous souhaitez vérifier les exécutions passées et les charges utiles reçues.

Cas d'utilisation pratiques

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

• Configuration : Un outil de helpdesk externe (comme Zendesk) reçoit les demandes entrantes.

• Déclencheur webhook : La création d'un nouveau ticket transmet l'objet et le corps du ticket à l'URL du webhook.

• Action de l'agent : L'agent consulte la documentation interne de support, évalue l'urgence et rédige une proposition de réponse.

• Résultat : Les équipes de support traitent les tickets de routine plus rapidement sans tâche répétitive de triage.

Cas d'utilisation 2 : Traitement de formulaires en ligne

• Configuration : Un formulaire de contact ou de qualification est hébergé sur Typeform ou sur votre site web.

• Déclencheur webhook : Chaque soumission transmet les réponses sous forme de charge utile JSON à Swiftask.

• Action de l'agent : L'agent synthétise la soumission, qualifie le prospect et crée une tâche pour le responsable de compte.

• Résultat : Les nouvelles demandes sont traitées immédiatement dès leur envoi.

Cas d'utilisation 3 : Gestion des notifications de paiement

• Configuration : Une plateforme de facturation ou de paiement (comme Stripe) traite les transactions des clients.

• Déclencheur webhook : Les événements de paiement réussi appellent l'URL du webhook.

• Action de l'agent : L'agent lit les détails de la commande, consigne la transaction dans les registres internes et envoie un e-mail d'accueil personnalisé.

• Résultat : Les flux de travail transactionnels s'exécutent en continu 24h/24 et 7j/7 sans supervision manuelle.

Cas d'utilisation 4 : Enrichissement de profils de prospects

• Configuration : Un nouveau contact est créé dans votre CRM.

• Déclencheur webhook : Le CRM envoie le nom de l'entreprise et son domaine à l'URL du webhook.

• Action de l'agent : L'agent effectue des recherches sur l'entreprise, extrait les informations clés et renvoie le résumé dans la fiche du CRM.

• Résultat : Les équipes commerciales disposent d'un contexte complet avant de contacter les prospects.

FAQ

Puis-je intégrer directement les webhooks de commentaires Facebook avec un agent Swiftask ?

Problème : Les Webhooks Facebook exigent une requête de vérification en GET, avec un token de vérification et une réponse au challenge, avant d’envoyer les événements de commentaires. Les URL webhook Swiftask acceptent actuellement uniquement les requêtes POST. Elles ne peuvent donc pas être validées directement par Meta.

Solution :

• Créer une automatisation avec l’API Facebook : Utilisez l’API Graph Facebook pour récupérer régulièrement les commentaires des publications de votre Page.

• Envoyer les commentaires à Swiftask : Une fois récupérées, envoyez les données des commentaires à votre agent Swiftask via son URL Webhook avec une requête POST.

• Utiliser un token d’accès à la Page : Générez un Page Access Token valide avec les permissions nécessaires, telles que pages_read_engagement et pages_manage_metadata.

• Récupérer les commentaires d’une publication : Appelez l’endpoint Graph API suivant pour chaque publication de la Page :

  GET /{post-id}/comments

• Configurer l’automatisation Swiftask : Créez une automatisation déclenchée par le webhook entrant et indiquez à l’agent comment analyser, classer, notifier ou répondre aux commentaires reçus.

Conseils & meilleures pratiques

• Utilisez des noms de déclencheurs explicites : Nommez vos déclencheurs en précisant leur source et leur rôle (ex. : "Stripe - Paiements échoués") pour les retrouver rapidement dans l'historique.

• Testez les points de terminaison avec curl : Envoyez une requête POST de test à l'aide de la commande curl fournie avant de connecter des plateformes en production.

• Définissez l'en-tête de contenu JSON : Assurez-vous que votre système externe envoie bien l'en-tête "Content-Type: application/json".

• Sécurisez l'URL du webhook : Considérez votre URL de webhook comme confidentielle. En cas d'exposition, supprimez le déclencheur et générez-en un nouveau.

• Surveillez l'historique d'exécution : Cliquez régulièrement sur Historique dans le panneau des détails du déclencheur pour vérifier la bonne réception des requêtes et diagnostiquer d'éventuelles erreurs.

Dépannage

• "L'URL du webhook renvoie une erreur ou ne parvient pas à se connecter"

  • Vérifiez que votre plateforme externe envoie une requête HTTP POST et non une requête GET.

  • Assurez-vous que l'en-tête Content-Type: application/json est bien présent.

  • Vérifiez que l'URL du point de terminaison a été copiée dans son intégralité.

• "Le déclencheur est reçu mais l'agent ne s'exécute pas"

  • Vérifiez que l'interrupteur du déclencheur est bien positionné sur Actif.

  • Assurez-vous que les instructions de l'agent expliquent précisément comment exploiter les données entrantes.

  • Vérifiez que les compétences requises (ex. : envoi d'e-mails, mise à jour du CRM) sont activées et authentifiées.

• "Besoin de renouveler ou de modifier le point de terminaison du webhook"

  • Supprimez le déclencheur existant depuis la liste des déclencheurs.

  • Créez un nouveau déclencheur webhook pour obtenir une nouvelle URL, puis mettez à jour votre application externe.

Ressources supplémentaires

• Introduction à l'automatisation avec des agents : Comprendre les automatisations d'agents en arrière-plan et les types de déclencheurs.

• Création d'une automatisation avec des agents : Configurer des flux de travail planifiés ou événementiels.

• Communication directe par e-mail avec les agents IA : Apprendre à déclencher des agents via des adresses e-mail dédiées.

• Déclencheurs depuis Outlook : Connecter et surveiller des boîtes de réception Outlook 365.