Un webhook est un mécanisme puissant qui vous permet de recevoir automatiquement des données d'Empower vers une URL personnalisée une fois qu'un événement ou un appel a été traité.

Cette configuration simplifie l'intégration d'Empower avec vos systèmes internes, outils CRM, plateformes de BI et autres applications tierces. Les cas d'utilisation courants incluent l'enrichissement automatique des fiches clients dans votre CRM, la génération de tableaux de bord personnalisés ou le déclenchement de workflows internes basés sur les scores d'appel.

Configurer vos webhooks dans Empower

1) Créer votre Webhook

Pour commencer, rendez-vous dans la section Paramètres d'Empower. De là, naviguez vers Licences > Configuration Webhook (identifiée comme la page "webhooks et clés API").

Sur cette page, vous pouvez voir la liste de vos webhooks existants et cliquer sur la flèche à côté d'eux pour voir les détails, les modifier ou les supprimer.

Cliquez sur "ajouter un webhook" et saisissez un nom pour votre nouveau webhook.
Dans le champ URL, renseignez le point de terminaison HTTP (ex: https://webhook.site/...) qui recevra les données. Cliquez sur vérifier ; une fois que le système reconnaît correctement l'URL, une icône "Vérifié" apparaîtra.
Pour sécuriser les requêtes entrantes vers votre système, saisissez un jeton secret ou une clé API personnalisée dans le champ Authorization Header.

2) Configurer les déclencheurs (triggers) du Webhook

Vous pouvez activer un déclencheur quand :

Un appel est créé et traité.
Un tag est ajouté ou supprimé d'un appel.
Un drapeau (flag) est ajouté ou supprimé d'un appel.

Une note est ajoutée ou supprimée d'un appel.
Un moment est ajouté ou supprimé d'un appel.
Un résumé d'appel a été modifié.
Un score d'appel a été modifié.

3) Tester et Enregistrer

Vous pouvez activer un déclencheur pour le tester et copier la charge utile (payload).

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.

💡 Pour garantir que votre intégration fonctionne de manière fluide et sécurisée, suivez ces recommandations :

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 :

🎉 Voilà, vous savez maintenant comment configurer votre Webhook dans Empower !