Qu'est-ce qu'un Webhook ?
Le module Webhooks permet une personnalisation approfondie en autorisant des requêtes HTTP vers des URL externes, déclenchant diverses actions selon les données retournées. Qu'il s'agisse d'ouvrir une barrière pour des appels spécifiques, d'envoyer des e-mails pour des contacts clients ou de s'intégrer à des systèmes CRM et des campagnes marketing, les possibilités sont vastes. Configurez l'URL et les options pour adapter les fonctionnalités telles que la redirection d'appel ou les recherches dans les bases de données selon vos besoins.
N'hésitez pas à consulter Notifications d'appel pour maximiser les capacités de votre service téléphonique.
Comment créer un Webhook ?
- Accédez à Webhooks.
- Cliquez sur Ajouter.
- Donnez un nom à votre Webhook.
- Vous pouvez également fournir des informations supplémentaires dans le champ description. Cela n'est pas nécessaire au fonctionnement du webhook.
- Sous Transmission de l'identifiant du correspondant, choisissez quel numéro le destinataire de l'appel verra comme identifiant du correspondant :
- Numéro de l'appelant.
- Numéro appelé.
- Masqué (anonyme).
- Dans le champ Modèle d'URL, saisissez l'URL qui doit être déclenchée lors d'un appel entrant. Le texte d'aide dans le formulaire fournit plus de détails. Ce champ spécifie comment l'URL appelée par le webhook doit être formatée. Quatre variables peuvent être utilisées dans le modèle d'URL :
- {code} : Le code numérique saisi par l'appelant (voir « Utilisation de l'IVR » ci-dessous).
- {did} : Le numéro appelé.
- {callerid} : L'identifiant du correspondant de l'appelant.
- {callername} : Le nom de l'appelant, s'il est disponible.
Un exemple simple de modèle d'URL pourrait être :
http://webrouting.companyname.com/test.py?code={code}&callerid={callerid}
Utiliser l'IVR (Interactive Voice Response)
Cochez cette case si vous souhaitez que l'appelant saisisse un code numérique pour continuer. Après avoir sélectionné cette option, cinq champs supplémentaires apparaîtront :
- Délai d'attente : Saisissez le nombre de secondes dont dispose l'appelant pour entrer son code numérique.
- Nombre de tentatives : Saisissez le nombre de fois où l'appelant peut essayer de saisir correctement le code numérique.
- Message de démarrage : Sélectionnez le Son à diffuser lorsque l'appelant est dirigé vers ce webhook.
- Message d'erreur : Sélectionnez le Son à diffuser si l'appelant saisit un code numérique incorrect.
- Message de délai dépassé : Sélectionnez le Son à diffuser si le délai d'attente est dépassé.
- Cliquez sur Enregistrer.
Si tout est configuré correctement, un lien sera maintenant établi entre votre plateforme de téléphonie et votre script, package CRM, Zapier ou autre programme. Il vous suffit d'activer ce Webhook dans votre plan de routage.
Configurer les Webhooks dans le plan de routage
- Accédez à Plans de routage.
- Cliquez sur le numéro de téléphone où vous souhaitez utiliser le webhook.
- Cliquez sur Modifier le plan de routage.
- Cliquez sur Ajouter une étape à l'endroit où vous souhaitez insérer le webhook.
- Vous verrez deux sous-étapes :
- Succès HTTP et SVI : Ces sous-étapes sont exécutées si le webhook retourne les valeurs correctes (l'URL est connectée) et que l'appelant a potentiellement saisi une option SVI valide.
- Échec HTTP ou SVI : Ces sous-étapes sont exécutées en cas de problème, par exemple si l'appelant fait un choix invalide ou si l'URL ne fonctionne pas, éventuellement en raison d'un problème de serveur.
Que peut-on intégrer dans votre Webhook
Vous pouvez intégrer divers éléments dans votre webhook comme vous le feriez dans votre plan de routage. Voici quelques options et leurs utilisations :
Variable du nom de l'appelant
Le nom de l'appelant — le nom que le destinataire voit sur son écran — peut être ajusté de trois manières :
- Webhook: Set the caller name to the value returned by the webhook.
- Prefix: Enter text in the routing step that will be prefixed to the caller's name.
- Replace: Enter text in the routing step that will replace the caller's name entirely.
Remarque : Le nom d'appelant variable peut également être utilisé en dehors du webhook. Dans ce cas, seules les options Ajouter en préfixe et Remplacer peuvent être utilisées.
Destination variable
Si le webhook fournit une destination, vous pouvez rediriger l'appel vers cette destination en sélectionnant « Destination variable » dans l'étape de routage (sous la section webhook).
Retour d'information que vous pouvez fournir au système
Fournissez le retour d'information suivant pour indiquer le statut de l'interaction du webhook.
Status
- ACK: Input is good.
- NAK: Input is not valid.
- ERR: An error occured.
Destination
Used for forwarding to another destination.
Caller Name
Use this if you want to display the caller's name or the status of the call (such as IVR choice) on a VoIP device.
Feedback interpretation
status=ACK
The request was successfully received and processed with valid input.
status=ACK&destination=%2B31502102544
The request was successfully processed, and the call should be forwarded to the destination number +31 50 210 2544.
status=ACK&destination=215
The request was successfully processed, and the call should be forwarded to the destination number 215.
status=ACK&callername=VoIPGRID
The request was successfully processed, and the caller's name should be set to "VoIPGRID."
Explorer d'autres utilisations possibles des Webhooks
Intégration CRM
Lors d'un appel entrant, nous envoyons une requête au système CRM. Cette requête inclut le numéro du correspondant (s'il est connu) et le numéro composé. Le CRM renvoie ensuite le nom à afficher, que nous affichons sur l'écran du téléphone VoIP.
Le CRM peut également ouvrir un profil client en fonction de l'appel entrant, mais cette logique doit être gérée directement dans le CRM.
Routage basé sur une base de données externe
Nous pouvons rediriger les appels entrants vers un numéro de téléphone renvoyé par un système externe. Cela peut être basé sur :
- Le numéro du correspondant
- Le numéro composé
- Un code PIN saisi
Suivre les appels téléphoniques dans Google Analytics
Pour suivre les appels téléphoniques, vous avez besoin d'un bloc de numéros. Attribuez un numéro unique à chaque campagne. Avec un bloc de 10 numéros, vous pouvez suivre jusqu'à 10 campagnes simultanément.
Lorsqu'un client appelle l'un des numéros du bloc, nous envoyons une URL contenant le numéro composé (représentant la campagne) et le numéro du correspondant (si disponible). Veuillez noter que notre système ne traite pas JavaScript ou scripts similaires. Un morceau de code doit donc être exécuté après l'appel de l'URL pour mesurer correctement la conversion.
Une fois l'URL appelée, nous redirigeons l'appel vers le numéro principal de l'entreprise et la campagne est suivie.
Recevoir un e-mail pour les appels manqués
Lorsqu'un appel est manqué, il peut être utile de recevoir le numéro du correspondant par e-mail, SMS ou via Slack, par exemple, avec la date, l'heure et le numéro composé. Consultez Exemples de Webhooks pour un exemple détaillé via une connexion Zapier avec webhooks.
Code PIN VIP
Vous pouvez utiliser un webhook pour attribuer un code PIN VIP spécifique aux clients, par exemple pour une ligne d'assistance dédiée. Pour savoir comment le configurer, consultez la page Code PIN VIP.
Connexion à plus de 300 applications web via Zapier
Vous pouvez connecter facilement votre webhook à Zapier, similaire à IFTTT (If This Then That). Zapier vous permet d'intégrer différents systèmes, de sorte qu'une action dans un service web peut déclencher des actions dans d'autres, créant ainsi une réaction en chaîne. Zapier prend en charge l'intégration avec des services comme Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox et bien d'autres.
FAQ
Les webhooks sont déclenchés à un point précis du plan de routage et ne fonctionnent que pour les appels entrants. Si nécessaire, une URL différente peut être utilisée pour chaque webhook configuré. Un webhook est appelé à un moment unique.
Les notifications d'appel fonctionnent aussi bien pour les appels entrants que sortants. Pour plus de détails, consultez :
Avec les notifications d'appel, l'URL peut être sollicitée à cinq moments différents du cycle de vie de l'appel.
- Pour les webhooks, utilisez une requête GET.
- Pour les notifications d'appel, utilisez une requête POST.