Webhooks

Exemples de webhooks

Avec un webhook, Voys envoie une requête HTTP à l'URL que vous indiquez dès que quelqu'un appelle. La suite vous appartient : votre serveur traite la requête et renvoie une réponse, puis 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 notifier Zapier.

N'hésitez pas à consulter

Notifications d'appel pour exploiter pleinement les possibilités de votre service téléphonique.

Version courte : le correspondant appelle → Voys envoie une requête à votre URL → votre serveur répond avec un statut (et éventuellement quelques données supplémentaires) → Voys poursuit l'appel en fonction de cette réponse.

Champs du formulaire

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

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 au 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éussi et HTTP ou menu échoué

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

Ce que vous renvoyez

Votre serveur répond au format application/x-www-form-urlencoded. Requis : status. Optionnel : 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 une extension interne)

Modifier le nom du correspondant :

status=ACK&callername=VoysPartners

Nom de correspondant variable, trois variantes

Webhook — récupère le nom depuis la réponse de votre serveur
Préfixe — ajoute votre texte devant le nom existant
Remplacer — remplace entièrement le nom par votre texte

(Préfixe et Remplacer fonctionnent également sans webhook, d'ailleurs.)

Destination variable

Votre serveur renvoie-t-il une destination ? Sélectionnez « Destination variable » dans l'étape de routage et l'appel y sera automatiquement dirigé.

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 devrait 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ù un appel doit aboutir, selon le correspondant, le numéro composé ou 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 reçoit son propre numéro d'une série. Voys appelle votre URL avec la campagne (did) et le correspondant (callerid) ; vous enregistrez la conversion, puis Voys route l'appel vers le véritable numéro de l'entreprise. Note : l'appel lui-même ne peut pas exécuter de JS, le suivi doit donc se faire côté serveur.

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

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

4. Email / Slack lors d'un appel manqué

Généralement via Zapier : votre webhook envoie une notification à un webhook Zapier, qui la transmet par email, 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é, le correspondant entre 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"
}