Telefonía Voys

Con la integración con Voys, Tillor sabe quién llama y muestra de inmediato los datos del cliente. Las llamadas, las grabaciones y las transcripciones acaban después en Llamadas telefónicas. Voys es un proveedor de telefonía para empresas.

Antes de empezar:

• Necesitas una cuenta VoIP de Voys activa y acceso a los ajustes del plan de llamadas en Voys.
• Necesitas el permiso Gestionar integraciones.
• El número de teléfono de quien llama debe constar en el perfil del cliente o en una persona de contacto. De lo contrario, Tillor no vincula la llamada con ningún cliente.

Configurar VoysCopiar el enlace a esta sección

1. Ve a Ajustes (barra lateral, en Soporte)

2. Elige Integraciones y abre Voys en la lista
3. En la página de detalle, rellena tus datos de Voys (username, password, client_uuid, token) y haz clic en Instalar

Necesitas una cuenta VoIP de Voys activa.

Encontrar las URL para VoysCopiar el enlace a esta sección

Tillor y Voys se comunican mediante direcciones (URL). En algunos pasos, Voys pide una respuesta a Tillor, por ejemplo si estás abierto. Esa respuesta es ACK (sí, continuar) o NAK (no, sigue el otro camino). Un webhook es una dirección de este tipo que Voys llama durante una llamada.

Para los webhooks, la búsqueda del nombre de quien llama y los códigos de acceso, usas las URL que Tillor genera para ti.

1. Ve a Ajustes > Integraciones y abre Voys
2. Tras la instalación, en la página de detalle, bajo Ajustes, está el bloque URLs para configurar. Copia ahí la URL correcta para cada finalidad

Allí encontrarás, entre otras:

• Notificaciones de conversación - URL del webhook para los eventos de la llamada
• Webhook para identificación de llamadas - URL para la búsqueda del nombre de quien llama en tu plan de llamadas de Voys
• Agenda telefónica XML - URL para que los teléfonos VoIP descarguen la agenda telefónica
• Códigos de acceso - URL para controlar el punto de acceso (barrera, puerta de entrada o puerta) desde el plan de llamadas
• Webhook de horario de apertura - ACK si Tillor está abierto, NAK si Tillor está cerrado
• Webhook de llamante permitido - ACK si se puede pasar la llamada, NAK si la llamada debe ir al buzón de voz
• Webhook de enrutamiento - ACK con un destino, NAK si no hay ningún destino configurado

En el plan de llamadas de Voys, usa las mismas variables que indica Tillor (como {callerid}, {did}, {callername}, {callid} y {code}).

Configurar las notificaciones de conversación en VoysCopiar el enlace a esta sección

1. En Voys, abre el módulo Notificaciones de conversación
2. Haz clic en Añadir
3. En paquete/servicio, elige Personalizado
4. Pega la URL de Tillor de Notificaciones de conversación
5. Guarda

Documentación de Voys:

• Notificaciones de conversación

Configurar los nombres de quien llama (caller lookup) en el plan de llamadasCopiar el enlace a esta sección

Para buscar el nombre de quien llama, usas en Voys un paso de webhook en el plan de llamadas.

1. En Tillor, abre la URL Webhook para identificación de llamadas (en Ajustes > Integraciones > Voys, bajo URLs para configurar) y cópiala
2. En Voys, abre el módulo Webhooks y crea un webhook con esta plantilla de URL
3. Activa ese webhook en tu plan de llamadas mediante el paso de webhook
4. En la plantilla de URL, usa las variables que admite Voys ({callerid}, {did}, {callername} y, si hace falta, {code})
5. En el enrutamiento del webhook, configura Variabele bellernaam para que el nombre devuelto se muestre en los teléfonos

Los webhooks de horario de apertura y de enrutamiento no buscan el nombre de quien llama. Para eso usa este paso aparte.

Más información:

• Webhooks
• Qué son las notificaciones de conversación (diferencia con los webhooks)

Horario de apertura y destinos en el plan de llamadasCopiar el enlace a esta sección

Tillor es la fuente del horario de apertura, las vacaciones y las excepciones por festivos. Voys ya no necesita conocer ese calendario.

1. En Ajustes > Integraciones > Voys, elige el teléfono de Voys para abierto y, opcionalmente, para cerrado
2. Copia el Webhook de horario de apertura o el Webhook de enrutamiento desde URLs para configurar
3. En Voys, crea un webhook con esa plantilla de URL
4. Coloca ese webhook como paso del plan de llamadas, por encima de cualquier menú de opciones
5. Deja Menu gebruiken desactivado

Dos patrones:

• Webhook de horario de apertura - status=ACK sigue el camino HTTP en menu gelukt (abierto), status=NAK sigue HTTP of menu mislukt (cerrado). Si hay un destino configurado para abierto, va con ACK como destination.
• Webhook de enrutamiento - Tillor elige el destino. En el paso correcto, configura Variabele eindbestemming. ACK + destination si hay destino; si no, NAK.

En caso de error o de tiempo de espera agotado, Voys toma el camino fallido. Trátalo como cerrado.

Documentación de Voys: Webhooks.

Enviar automáticamente a quien llama al buzón de vozCopiar el enlace a esta sección

Con el Webhook de llamante permitido, Voys decide para cada llamante si la llamada se pasa o no. Tillor comprueba si el número de quien llama pertenece a un cliente que tiene activado el buzón de voz automático.

Primero, configura el plan de llamadas:

1. Copia el Webhook de llamante permitido desde URLs para configurar en Ajustes > Integraciones > Voys
2. En Voys, crea un webhook con esa plantilla de URL
3. Coloca ese webhook como paso del plan de llamadas, por encima de los pasos que pasan la llamada
4. Deja Menu gebruiken desactivado
5. Dirige el camino HTTP en menu gelukt a tu enrutamiento normal y el camino HTTP of menu mislukt al buzón de voz
6. En Ajustes > Integraciones > Voys, bajo Enrutamiento de llamadas, marca Buzón automático en Voys

Mientras esa opción esté desactivada, no verás Enviar llamadas al buzón de voz en el perfil del cliente.

Después, activa el buzón de voz automático para cada cliente:

1. Abre el perfil del cliente y ve a la pestaña Comunicaciones
2. En Ajustes de comunicación, marca la opción Enviar llamadas al buzón de voz
3. Haz clic en Guardar

Así funciona la respuesta:

• ACK - la llamada puede pasar. Esto también vale para números desconocidos y para llamadas con número oculto.
• NAK - el número pertenece a un cliente con buzón de voz automático. Voys sigue el camino fallido.

Tillor compara el número de quien llama con el número de teléfono del perfil del cliente, sin importar los espacios ni el formato del prefijo del país. Los números de teléfono de las personas de contacto no cuentan.

Este webhook no tiene en cuenta el horario de apertura. Combínalo con el webhook de horario de apertura o de enrutamiento poniendo ambos como pasos separados en el plan de llamadas.

Documentación de Voys: Webhooks.

Enrutamiento fijo por llamanteCopiar el enlace a esta sección

El mismo Webhook de enrutamiento puede dirigir de inmediato a quien llama a un teléfono de Voys concreto, a una extensión o a un número de teléfono. Esto solo vale para los clientes para los que hayas elegido un destino, y solo si Enrutamiento fijo en Voys está activado.

1. Coloca el Webhook de enrutamiento en el plan de llamadas, como en el horario de apertura
2. En el paso correcto, configura Variabele eindbestemming
3. En Ajustes > Integraciones > Voys, bajo Enrutamiento de llamadas, marca Enrutamiento fijo en Voys

Mientras esa opción esté desactivada, no verás Enrutamiento fijo de llamadas en el perfil del cliente. El webhook solo usa entonces el teléfono para abierto o cerrado.

Después, configura el destino para cada cliente:

1. Abre el perfil del cliente y ve a la pestaña Comunicaciones
2. En Enrutamiento fijo de llamadas, elige un teléfono de Voys, u Otro para un número de teléfono o una extensión (por ejemplo, 411)
3. Elige Ninguno para desactivar el enrutamiento fijo
4. Haz clic en Guardar

Así elige el destino el webhook de enrutamiento:

• Si hay un destino fijo para este llamante, ese es el destination.
• Si no, destination es el teléfono de Voys para abierto o cerrado.
• NAK - no hay destino fijo ni teléfono para el estado actual. Esto también vale para números desconocidos y para llamadas con número oculto, mientras no haya teléfono para abierto o cerrado.

Tillor compara el número de quien llama con el número de teléfono del perfil del cliente, sin importar los espacios ni el formato del prefijo del país. Los números de teléfono de las personas de contacto no cuentan.

En caso de error o de tiempo de espera agotado, Voys toma el camino fallido.

Documentación de Voys: Webhooks.

¿Qué ocurre después?Copiar el enlace a esta sección

• Cada llamada que entra o sale aparece en ComunicacionesLlamadas telefónicas, con el cliente si el número coincide. Consulta Llamadas telefónicas.
• En una llamada entrante, quien llama aparece como una tarjeta abajo a la derecha en Tillor, con los datos del cliente.
• Las grabaciones y las transcripciones llegan en cuanto termina la llamada, si las grabaciones de llamadas están activadas en tu cuenta de Voys.

¿Problemas?Copiar el enlace a esta sección

Ver tambiénCopiar el enlace a esta sección