Les webhooks et les clés API dans Empower vous permettent d'automatiser le transfert de vos données d'appels vers vos systèmes internes, CRM et outils de BI. Dans ce guide, vous apprendrez comment créer et configurer un webhook, personnaliser ses déclencheurs et générer des clés API sécurisées.
Les webhooks et les clés API dans Empower
1. Accéder au menu et créer un webhook
Accédez à l'espace de configuration des développeurs pour ajouter un nouveau point de terminaison.
- Rendez-vous dans la section Paramètres de votre interface Empower
- Dans le menu de gauche, cliquez sur l'option Développeur.
- Consultez la liste de vos webhooks existants ou cliquez sur Ajouter un nouveau.
- Saisissez le Nom de votre webhook dans le champ dédié
- Saisissez l'URL de requête (point de terminaison HTTP, ex: https://webhook.site/...) dans le champ URL. Cliquez sur Vérifier pour valider l'URL jusqu'à ce que l'icône "Vérifié" apparaisse.
- Saisissez un jeton secret ou une clé personnalisée pour sécuriser les requêtes entrantes.
2. Configurer les déclencheurs du webhook
Activation des déclencheurs
Définissez les événements précis qui déclencheront l'envoi automatique de données vers votre système.
- Activez ou désactivez les bascules (toggles) selon vos besoins de gestion d'appels :
- Appels : Déclenché lorsqu'un appel est créé et traité.
- Tags, Drapeaux et Notes : Déclenché lors de l'ajout ou de la suppression d'un tag, d'un drapeau ou d'une note.
- Moments : Déclenché lors de l'ajout ou du retrait d'un moment d'appel.
- Résumé et Score d'appel : Déclenché lorsqu'un résumé d'appel ou un score est modifié.
- Analyse de Framework : Déclenché lorsqu'une analyse de framework est mise à jour manuellement.
Tester le webhook
Simulez un envoi de données réelles pour vérifier la réception du payload JSON avant la mise en production.
- Cliquez sur le bouton Tester le déclencheur pour simuler la création et le traitement d'un appel.
- Cliquez sur le bouton Copier la charge utile pour vérifier la structure du JSON envoyé (incluant les détails de l'appel et le score d'évaluation).
- Une fois le test réussi, cliquez sur Enregistrer le webhook pour valider la configuration.
- Le test simule une requête POST avec des données d'exemple envoyées à votre système pour vérifier la bonne réception.
- Le payload JSON standard envoyé automatiquement après l'analyse d'un appel inclut généralement les call_details (identifiants de l'appel) et le call_score (détails de l'évaluation automatisée).
- Une fois que vous avez vérifié la connexion et configuré vos déclencheurs, enregistrez le webhook pour activer la configuration. Vous pourrez facilement le supprimer plus tard s'il n'est plus nécessaire.
- Assurez-vous que l'URL de réception est sécurisée (HTTPS).
- Vérifiez que votre serveur est configuré pour accepter les requêtes POST avec des données JSON.
- Gérez toujours la clé d'autorisation dans vos en-têtes pour filtrer correctement toute requête indésirable ou malveillante.
Exemple de charge utile (Payload) Webhook
Voici un exemple de JSON envoyé automatiquement à votre webhook après une analyse d'appel :
4. Générer et gérer vos clés API dans Empower
Créez des clés d'accès API pour sécuriser l'authentification de vos applications tierces.
- Dans le menu latéral gauche de la section Développeur, cliquez sur l'onglet Clés API.
- Cliquez sur le bouton Ajouter une clé API
- Saisissez le Nom de la clé API dans le champ correspondant.
- Recherchez et sélectionnez l'Utilisateur associé dans le menu déroulant
- Cliquez sur Afficher puis sur Copier pour récupérer votre clé API en lieu sûr.
Vous pouvez modifier ou révoquer une clé API à tout moment en cliquant sur le bouton d'édition situé à côté de la clé dans votre liste
🎉 Vous savez désormais comment configurer les webhooks et les clés API dans Empower et pouvez automatiser le transfert de vos données d'appels vers vos outils internes en toute sécurité !