Webhooks

Ejemplos de webhooks

Con un webhook, Voys envía una petición HTTP a una URL que usted proporciona en cuanto alguien llama. Lo que ocurra después depende de usted: su servidor procesa la petición y envía una respuesta, y la llamada continúa en función de eso. Piense en: enrutar llamadas automáticamente según sus propios datos, buscar el nombre de quien llama y mostrarlo en el terminal, o simplemente enviar una señal a Zapier.

No olvide consultar

Notificaciones de llamada para aprovechar al máximo las capacidades de su servicio telefónico.

Versión corta: alguien llama → Voys envía una petición a su URL → su servidor responde con un estado (y opcionalmente algunos datos extra) → Voys continúa la llamada en función de eso.

Campos del formulario

Nombre — cómo lo encontrará después en su plan de marcado
Descripción — solo para usted, no afecta a nada
Traspaso de identificador de llamadas — qué número ve el destinatario: número de quien llama, número marcado u oculto
Plantilla de URL — la URL que se llama, vea más abajo las variables
Usar menú — actívelo si quien llama necesita introducir un código primero (estilo IVR). Añade 5 campos extra: tiempo de espera, número de intentos, mensaje de inicio, mensaje de error, mensaje de tiempo agotado

Variables para su plantilla de 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

Ejemplo:

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

Voys rellena estas cuatro variables automáticamente antes de realizar la petición.

Configurarlo en su plan de marcado

Vaya a Plan de marcado, elija el número
Haga clic en el más, añada un paso
Elija Webhook como tipo, seleccione su webhook
Obtendrá automáticamente dos rutas: HTTP y menú exitosos y HTTP o menú fallidos

En ambas rutas puede usar sus pasos normales del plan de marcado, además de dos opciones extra: nombre de quien llama variable y destino variable (vea más abajo).

Qué enviar de vuelta

Su servidor responde en formato application/x-www-form-urlencoded. Obligatorio: status. Opcional: destination y callername.

Status:

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

Solo confirmar:

status=ACK

Enrutar a un número diferente:

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

(destination puede ser un número externo o una extensión interna)

Cambiar el nombre de quien llama:

status=ACK&callername=VoysPartners

Nombre de quien llama variable, tres opciones

Webhook — toma el nombre de la respuesta de su servidor
Anteponer — añade su texto delante del nombre existente
Reemplazar — reemplaza el nombre completamente con su texto

(Anteponer / Reemplazar también funcionan sin webhook, por cierto.)

Destino variable

¿Su servidor devuelve un destination? Seleccione "Destino variable" en el paso de enrutamiento y la llamada irá automáticamente allí.

Ejemplos por caso de uso

1. Integración CRM

En una llamada entrante, Voys envía callerid y did a su CRM. Usted busca el cliente y devuelve el nombre que debería mostrarse en el terminal.

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

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

2. Enrutamiento basado en una base de datos externa

Decida usted mismo dónde debería ir una llamada, según quien llama, el número marcado o un código pin.

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

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

3. Seguimiento de llamadas en Google Analytics

Cada campaña obtiene su propio número de un bloque. Voys llama a su URL con la campaña (did) y quien llama (callerid); usted registra la conversión, luego Voys enruta la llamada al número real de la empresa. Nota: la llamada en sí no ejecuta JS, por lo que el seguimiento tiene que ocurrir del lado del servidor.

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

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

4. Email / Slack en una llamada perdida

Normalmente vía Zapier: su webhook publica en un catch hook de Zapier, que lo reenvía a email, SMS o 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. Código pin VIP

Menú activado, quien llama introduce un código, usted comprueba si es válido.

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

Valid code:
status=ACK&destination=210

Invalid code:
status=NAK

6. Vía Zapier a más de 300 aplicaciones

Misma idea que arriba, pero como disparador genérico. Puede pasar las cuatro variables y dejar que Zapier decida qué hacer con ellas, hacia Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox, etc.

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"
}