Paramètres généraux
Webhooks
Recevoir automatiquement un événement dans vos systèmes dès qu'un appel Leexi a été transcrit et analysé.
Définition : Un webhook prévient vos systèmes sans que vous ayez à interroger Leexi. Dès qu'un appel est transcrit et que ses insights IA sont générés, Leexi envoie une requête à l'URL que vous avez configurée, avec le contenu de l'appel.
Vidéo de la fonctionnalité
Aucune vidéo n'est disponible pour le moment.
À qui est-ce adressé ?
- Aux équipes techniques qui veulent déclencher un traitement automatique à la fin de chaque appel.
- Aux administrateurs qui alimentent un entrepôt de données, un outil interne ou une automatisation maison.
Permissions et licences
- La consultation des webhooks demande la permission de lecture des webhooks, leur création et leur modification la permission d'écriture.
- Les données envoyées reprennent le format de l'API publique : la référence webhooks en décrit le détail.
Guide d'utilisation
Ouvrir la page Webhooks
Rendez-vous dans Paramètres > Paramètres avancés > Webhooks. La liste affiche pour chaque webhook son nom, ses règles d'accès, son URL, sa description et son état.
Créer un webhook
Cliquez sur "Ajouter", puis renseignez un nom, l'URL qui recevra les événements et une description. L'URL doit être joignable depuis Internet et ne peut être utilisée que par un seul webhook de votre entreprise.
Définir les règles d'accès
Trois modes sont disponibles :
- Liés à un utilisateur : le webhook ne reçoit que les événements des appels auxquels cet utilisateur a accès.
- Accès à tout : le webhook reçoit les événements de tous les appels de l'entreprise.
- Accès personnalisés : après enregistrement, vous êtes redirigé vers la page Règles d'accès pour délimiter le périmètre exact.
Traiter les événements reçus
Votre endpoint reçoit une requête POST contenant le type d'événement et les données de l'appel. Répondez avec un code de succès, puis traitez le contenu de votre côté.
Activer ou suspendre un webhook
L'interrupteur de la colonne "Actif" suspend l'envoi des événements sans supprimer la configuration, le temps d'une maintenance de votre côté par exemple.
Pour aller plus loin
- Un seul type d'événement existe aujourd'hui,
call.processed, envoyé une fois la transcription et les insights IA entièrement générés. - Le corps de la requête contient le nom de l'événement et les données de l'appel, au même format que l'appel détaillé de l'API publique.
- Si votre endpoint ne répond pas ou renvoie une erreur, Leexi réessaie jusqu'à dix fois avec un délai croissant : 10 secondes, 1 minute, 5, 15 et 30 minutes, 1 heure, 6 heures, puis toutes les 24 heures.
- Passé ces dix tentatives, le webhook est désactivé automatiquement et les administrateurs de l'entreprise reçoivent un email les en informant. Réactivez-le une fois votre endpoint rétabli.
- Les clés API couvrent le besoin inverse : interroger Leexi au moment qui vous convient plutôt que d'attendre un événement.
Questions récurrentes
N'importe quelle réponse de succès suffit. Toute réponse en erreur, comme toute absence de réponse, déclenche une nouvelle tentative.
Parce que dix tentatives d'envoi consécutives ont échoué. Vérifiez que votre URL est joignable et qu'elle répond correctement, puis réactivez le webhook.
Non, les deux fonctionnent indépendamment. Une clé API reste utile si vous voulez récupérer des données complémentaires après réception d'un événement.
Oui, en configurant des accès personnalisés et les règles d'accès correspondantes.
Points de vigilance
- La requête n'est pas signée : utilisez une URL difficile à deviner et, si vous devez valider les données reçues, rappelez l'API publique.
- Un endpoint lent ou indisponible finit par désactiver le webhook : mieux vaut accuser réception rapidement et traiter le contenu ensuite.
- Les événements ne sont pas rejoués pour la période où le webhook était inactif : les appels traités pendant ce temps doivent être récupérés via l'API publique.
- Le contenu envoyé inclut les données de l'appel : assurez-vous que le système destinataire offre le niveau de confidentialité attendu.