Webhooks

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.

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

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

Accédez à Plan de routage, sélectionnez le numéro
Cliquez sur le plus, ajoutez une étape
Choisissez Webhook comme type, sélectionnez votre webhook
Vous obtenez automatiquement deux chemins : HTTP et menu réussis et HTTP ou menu échoués

Dans les deux chemins, vous pouvez utiliser vos étapes habituelles du plan de routage, ainsi que deux options supplémentaires : nom de l'appelant variable et destination variable (voir ci-dessous).

Ce que vous renvoyez

Votre serveur répond au format application/x-www-form-urlencoded. Obligatoire : status. Facultatif : destination et callername.

Status :

ACK   input/request is valid
NAK   input is invalid
ERR   something went wrong

Simple accusé de réception :

status=ACK

Router vers un autre numéro :

status=ACK&destination=%2B31502102544
status=ACK&destination=215

(destination peut être un numéro externe ou un poste interne)

Modifier le nom de l'appelant :

status=ACK&callername=VoysPartners

Nom de l'appelant variable, trois variantes

Webhook — prend le nom de la réponse de votre serveur
Préfixer — ajoute votre texte devant le nom existant
Remplacer — remplace entièrement le nom par votre texte

(Préfixer / Remplacer fonctionne également sans webhook, au passage.)

Destination variable

Votre serveur renvoie une destination ? Sélectionnez « Destination variable » dans l'étape de routage et l'appel s'y dirige automatiquement.

Exemples par cas d'usage

1. Intégration GRC

Lors d'un appel entrant, Voys envoie callerid et did à votre GRC. Vous recherchez le client et renvoyez le nom qui doit s'afficher sur le combiné.

URL template:
https://crm.yourcompany.com/webhook?callerid={callerid}&did={did}

Response from your server:
status=ACK&callername=Marieke%20de%20Boer

2. Routage basé sur une base de données externe

Décidez vous-même où diriger un appel, en fonction de l'appelant, du numéro composé ou d'un code PIN.

URL template:
https://routing.yourcompany.com/lookup?callerid={callerid}&did={did}

Response from your server:
status=ACK&destination=%2B31502102544

3. Suivi des appels dans Google Analytics

Chaque campagne dispose de son propre numéro issu d'un bloc. Voys appelle votre URL avec la campagne (did) et l'appelant (callerid) ; vous enregistrez la conversion, puis Voys redirige l'appel vers le véritable numéro de l'entreprise. À noter : l'appel lui-même n'exécute pas de JS, le suivi doit donc s'effectuer côté serveur.

URL template:
https://analytics.yourcompany.com/call-tracking?campaign={did}&callerid={callerid}

Response from your server:
status=ACK&destination=020123456

4. E-mail / Slack en cas d'appel manqué

Généralement via Zapier : votre webhook publie vers un hook Zapier, qui le transmet par e-mail, SMS ou Slack.

URL template (Zapier catch hook):
https://hooks.zapier.com/hooks/catch/123456/abcdef?callerid={callerid}&did={did}

What Zapier receives:
{
  "callerid": "+31612345678",
  "did": "0502102544",
  "timestamp": "2026-08-18T09:41:02+02:00"
}

5. Code PIN VIP

Menu activé, l'appelant saisit un code, vous vérifiez s'il est valide.

URL template:
https://vip.yourcompany.com/check?code={code}&callerid={callerid}

Valid code:
status=ACK&destination=210

Invalid code:
status=NAK

6. Via Zapier vers plus de 300 applications

Même principe que ci-dessus, mais comme déclencheur générique. Vous pouvez transmettre les quatre variables et laisser Zapier décider quoi en faire, vers Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox, et bien d'autres.

URL template:
https://hooks.zapier.com/hooks/catch/123456/xyz789?callerid={callerid}&did={did}&callername={callername}

What Zapier receives:
{
  "callerid": "+31612345678",
  "did": "0502102544",
  "callername": "Voys Partners"
}