Exemples de webhooks

Avec un webhook, Voys envoie une requête HTTP vers une URL que vous indiquez dès qu'un appel arrive. La suite vous appartient : votre serveur traite la demande, renvoie une réponse, et l'appel se poursuit en fonction de celle-ci. Par exemple : router automatiquement les appels selon vos propres données, rechercher le nom du correspondant et l'afficher sur le combiné, ou simplement déclencher une action sur Zapier.

<aside> <img src="notion://custom_emoji/07b2df3c-633e-4ee0-816f-6107921e0ea9/3b840e6d-8f97-8098-87bd-007abda27eb4" alt="notion://custom_emoji/07b2df3c-633e-4ee0-816f-6107921e0ea9/3b840e6d-8f97-8098-87bd-007abda27eb4" width="40px" />

N'hésitez pas à consulter Notifications d'appel pour exploiter pleinement les capacités de votre service téléphonique.

</aside>

Version courte : un appel arrive → Voys envoie une requête vers votre URL → votre serveur répond avec un statut (et éventuellement des données supplémentaires) → Voys poursuit l'appel en fonction de la réponse.

Champs du formulaire

• Nom — pour le retrouver facilement dans votre plan de routage
• Description — uniquement pour vous, sans effet sur le fonctionnement
• Transmission de l'identifiant du correspondant — quel numéro voit le destinataire : celui de l'appelant, le numéro composé, ou masqué
• Modèle d'URL — l'URL qui sera appelée, voir ci-dessous pour les variables
• Utiliser un menu — activez cette option si l'appelant doit d'abord saisir un code (type SVI). Ajoute 5 champs supplémentaires : délai d'attente, nombre de tentatives, message de démarrage, message d'erreur, message de dépassement de délai

Variables pour votre modèle d'URL

{code}        the entered code (only relevant if the menu is on)
{did}         the number that was dialed
{callerid}    the caller's number
{callername}  caller's name, if known

Exemple :

<http://webrouting.voys.nl/test.py?code={code}&callerid={callerid}>

Voys remplit automatiquement ces quatre variables avant d'envoyer la requête.

Configuration dans votre plan de routage

1. Accédez à Plan de routage, sélectionnez le numéro