Webhooks

Les webhooks permettent à Voxbi de notifier vos systèmes dès qu'un événement se produit sur un appel. Quand un appel commence, se termine, est manqué ou atteint tout autre événement que vous souhaitez surveiller, Voxbi envoie une requête HTTP vers une URL que vous définissez. Votre système reçoit ces données et peut agir en conséquence : journaliser l'appel, mettre à jour un enregistrement, envoyer une alerte ou déclencher n'importe quel workflow que vous avez construit. La logique reste dans votre système ; Voxbi fournit le signal.

C'est le mécanisme de base pour connecter Voxbi aux outils et processus métier qui ne sont pas couverts par une intégration native. Si vous disposez d'une application interne, d'un CRM sur mesure, d'un outil de ticketing ou d'une plateforme d'automatisation que vous souhaitez tenir informée de l'activité téléphonique, un webhook vous transmet les données en temps réel, sans interrogation périodique. Combinés à l'API Voxbi, qui vous permet de consulter l'historique des appels, de gérer les enregistrements, d'envoyer des SMS et de piloter la téléphonie par programmation, les webhooks complètent le tableau en vous poussant les événements au moment précis où ils se produisent.

Quand utiliser les webhooks

• Un helpdesk interne qui doit créer automatiquement un ticket lorsqu'un appel support est manqué pendant les heures ouvrées, afin qu'aucun appel ne reste sans réponse même si la file est sans surveillance.

• Un outil d'analyse métier ou de reporting qui a besoin de données d'appels précises et en temps réel, sans exports manuels ni interrogations planifiées de l'historique.

• Une plateforme d'automatisation où un appel entrant d'un numéro client connu doit déclencher une recherche et transmettre le contexte du client à l'agent avant qu'il ne décroche.

Comment fonctionnent les webhooks dans Voxbi

1. Préparez un endpoint dans votre système. Votre système doit exposer une URL capable de recevoir une requête HTTP POST et de traiter le contenu JSON envoyé par Voxbi. Cet endpoint doit être accessible depuis internet et renvoyer un code de réponse approprié pour que Voxbi sache que la livraison a réussi.

2. Configurez le webhook dans Voxbi Cockpit. Dans Voxbi Cockpit, accédez aux paramètres de webhook ou d'automatisation et ajoutez l'URL de votre endpoint. Sélectionnez les événements d'appels auxquels vous souhaitez vous abonner : appel commencé, appel terminé, appel manqué, etc.

3. Recevez l'événement et agissez. Lorsque l'événement abonné se produit, Voxbi envoie les données de l'appel à votre endpoint. Votre système traite le contenu et exécute la logique que vous avez définie : écriture en base de données, envoi d'une notification, création d'un enregistrement ou déclenchement d'un processus aval.

4. Combinez avec l'API pour des workflows bidirectionnels. Les webhooks transmettent les événements de Voxbi vers vous. L'API Voxbi vous permet d'aller dans l'autre sens : consulter l'historique des appels, récupérer les enregistrements, envoyer des SMS et piloter la téléphonie par programmation. Les deux combinés offrent une automatisation complète dans les deux sens entre Voxbi et votre stack. La documentation de l'API est disponible sur docs.voxbi.com.

Questions fréquentes

Quelle est la différence entre un webhook et l'API Voxbi ?

Un webhook est piloté par les événements : Voxbi envoie des données à votre endpoint quand quelque chose se passe, sans que vous ayez à demander. L'API est pilotée par les requêtes : c'est votre système qui appelle un endpoint Voxbi quand il a besoin d'une information. La plupart des intégrations utilisent les deux : les webhooks pour les déclencheurs en temps réel, l'API pour la récupération de données à la demande.

Faut-il un développeur pour utiliser les webhooks ?

La mise en place d'un endpoint webhook nécessite des compétences techniques, car votre système doit être capable de recevoir et d'interpréter des requêtes HTTP. Si votre équipe utilise une plateforme d'automatisation qui prend en charge les webhooks comme déclencheur entrant, cette plateforme peut gérer l'endpoint à votre place, ce qui réduit la quantité de code personnalisé à écrire.

Quelles données Voxbi inclut-il dans un payload webhook ?

Les payloads contiennent les données de l'événement d'appel. Les champs précis dépendent du type d'événement, mais incluent généralement le numéro de l'appelant, la destination, l'horodatage, la durée de l'appel le cas échéant, et un identifiant d'appel. Consultez la documentation de l'API Voxbi sur docs.voxbi.com pour la spécification à jour des payloads.

Peut-on utiliser les webhooks pour router des appels en fonction de données issues de mon propre système ?

Les webhooks peuvent alimenter vos systèmes en événements d'appels. La façon dont les décisions de routage remontent dans les flux d'appels Voxbi dépend de la conception de votre intégration. Si vous souhaitez un workflow de routage qui dépend de données externes renvoyées en temps réel, contactez l'équipe Voxbi à hello@voxbi.com pour discuter de votre cas d'usage avant de vous lancer.