¿Qué es un Webhook?
El módulo Webhooks permite una amplia personalización al permitir solicitudes HTTP a URLs externas, desencadenando diversas acciones basadas en los datos devueltos. Ya sea abrir una barrera para llamadas específicas, enviar correos electrónicos para contactos de clientes o integrarse con sistemas CRM y campañas de marketing, las posibilidades son enormes. Configure la URL y las opciones para adaptar funcionalidades como el desvío de llamadas o búsquedas en bases de datos según sus necesidades.
Asegúrese de consultar Notificaciones de llamada para maximizar las capacidades de su servicio telefónico.
¿Cómo crear un Webhook?
- Vaya a Webhooks.
- Haga clic en Añadir.
- Asigne un nombre a su Webhook.
- Opcionalmente, proporcione información adicional en el campo descripción. Esto no es necesario para que el webhook funcione.
- En Transmisión del identificador de llamadas, elija qué número verá el destinatario de la llamada como identificador:
- Número del llamante.
- Número llamado.
- Suprimido (anónimo).
- En el campo Plantilla de URL, introduzca la URL que debe activarse al recibir una llamada entrante. El texto de ayuda del formulario proporciona más detalles. Este campo especifica cómo debe formatearse la URL que el webhook llamará. Se pueden usar cuatro variables en la plantilla de URL:
- {code}: El código de dígitos introducido por el llamante (consulte "Uso de IVR" más abajo).
- {did}: El número llamado.
- {callerid}: El identificador de llamadas del llamante.
- {callername}: El nombre del llamante, si está disponible.
Un ejemplo sencillo de plantilla de URL podría ser:
http://webrouting.companyname.com/test.py?code={code}&callerid={callerid}
Usar IVR (Respuesta de Voz Interactiva)
Marque esta casilla si desea que el llamante introduzca un código de dígitos para continuar. Tras seleccionar esta opción, aparecerán cinco campos adicionales:
- Tiempo de espera: Introduzca el número de segundos que tiene el llamante para introducir su código de dígitos.
- Número de intentos: Introduzca el número de veces que el llamante puede intentar introducir el código de dígitos correctamente.
- Mensaje de inicio: Seleccione el Sonido que se reproducirá cuando el llamante sea dirigido a este webhook.
- Mensaje de error: Seleccione el Sonido que se reproducirá si el llamante introduce un código de dígitos incorrecto.
- Mensaje de tiempo agotado: Seleccione el Sonido que se reproducirá si se supera el período de tiempo de espera.
- Haga clic en Guardar.
Si todo está configurado correctamente, ahora se establecerá un enlace entre su plataforma de telefonía y su script, paquete CRM, Zapier u otro programa. Solo necesita activar este Webhook en su plan de marcado.
Configuración de Webhooks en el plan de marcado
- Vaya a Planes de marcación.
- Haga clic en el número de teléfono donde desea usar el webhook.
- Haga clic en Editar plan de marcado.
- Haga clic en Añadir paso en la ubicación donde desea insertar el webhook.
- Verá dos subpasos:
- Éxito de HTTP e IVR: Estos subpasos se ejecutan si el webhook devuelve los valores correctos (la URL está conectada) y el llamante ha introducido potencialmente una opción IVR válida.
- Fallo de HTTP o IVR: Estos subpasos se ejecutan si hay un problema, como que el llamante haga una elección no válida o si la URL no funciona, posiblemente debido a un problema del servidor.
Qué incluir en su Webhook
Puede integrar diversos elementos en su webhook tal como lo haría en su plan de marcado. A continuación se muestran algunas opciones y sus usos:
Variable de nombre del llamante
El nombre del llamante (el nombre que el destinatario ve en su pantalla) puede ajustarse de tres formas:
- 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.
Nota: El nombre variable del llamante también puede usarse fuera del webhook. En ese caso, solo se pueden usar las opciones Anteponer y Reemplazar.
Destino variable
Si el webhook proporciona un destino, puede desviar la llamada a este destino seleccionando "Destino variable" en el paso de enrutamiento (en la sección del webhook).
Respuesta que puede proporcionar al sistema
Proporcione la siguiente respuesta para indicar el estado de la interacción del 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."
Explorando usos alternativos para el Webhook
Integración con CRM
Cuando entra una llamada, enviamos una señal al sistema CRM. Esta señal incluye el número del llamante (si se conoce) y el número marcado. El CRM devuelve el nombre que debe mostrarse y nosotros mostramos ese nombre en la pantalla del teléfono VoIP.
Opcionalmente, el CRM también puede abrir un perfil de cliente basándose en la llamada entrante, pero esa lógica debe gestionarse dentro del propio CRM.
Conmutación basada en una base de datos externa
Podemos desviar las llamadas entrantes a un número de teléfono devuelto por un sistema externo. Esto puede basarse en:
- El número del llamante
- El número marcado
- Un código PIN introducido
Seguimiento de llamadas telefónicas en Google Analytics
Para realizar el seguimiento de las llamadas telefónicas, necesita un bloque de números. Asigne un número único a cada campaña. Con un bloque de 10 números, puede realizar el seguimiento de hasta 10 campañas simultáneamente.
Cuando un cliente llama a uno de los números del bloque, enviamos una URL que contiene el número marcado (que representa la campaña) y el número del llamante (si está disponible). Tenga en cuenta que nuestro sistema no procesa JavaScript ni scripts similares, por lo que debe ejecutarse un fragmento de código después de llamar a la URL para medir correctamente la conversión.
Después de llamar a la URL, desviamos la llamada al número principal de la empresa y se registra la campaña.
Recibir un correo electrónico por llamadas perdidas
Cuando se pierde una llamada, puede ser útil recibir el número de teléfono del llamante en un correo electrónico, mensaje SMS o a través de Slack, por ejemplo, que incluya fecha, hora y número marcado. Consulte Ejemplos de Webhooks para ver un ejemplo detallado mediante una conexión Zapier con webhooks.
Código PIN VIP
Puede utilizar un webhook para asignar un código PIN VIP específico a los clientes, por ejemplo, para una línea de soporte dedicada. Para obtener detalles sobre cómo configurarlo, visite la página Código PIN VIP.
Conexión con más de 300 aplicaciones web a través de Zapier
Puede conectar su webhook a Zapier sin problemas, de forma similar a IFTTT (If This Then That). Zapier le permite integrar varios sistemas, de modo que una acción en un servicio web puede desencadenar acciones en otros, creando una reacción en cadena. Zapier admite la integración con servicios como Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox y muchos otros.
Preguntas frecuentes
Los webhooks se activan en un punto específico del plan de marcado y solo funcionan para llamadas entrantes. Si es necesario, se puede utilizar una URL diferente para cada webhook configurado. Un webhook se llama en un único momento.
Las notificaciones de llamada funcionan tanto para llamadas entrantes como salientes. Para obtener más detalles, consulte:
Con las notificaciones de llamada, la URL puede activarse en cinco puntos diferentes del ciclo de vida de la llamada.
- Para webhooks, utilice una solicitud GET.
- Para notificaciones de llamada, utilice una solicitud POST.