En pocas palabras, el widget de enrutamiento inteligente “Llamar a (a través de API)” utiliza una respuesta de API para saber a qué equipo de Aircall, usuario, número interno o número externo llamar en función de datos que se encuentran fuera de Aircall.
Si bien Ring to (a través de API) es un widget flexible que se puede usar para lograr una serie de flujos de trabajo deseados en función de una serie de plataformas externas, en este tutorial veremos un ejemplo que utiliza la API de Aircall para enrutar dinámicamente llamadas a un usuario de Aircall.
Requisitos previos
Antes de configurar el widget Ring to (a través de API), asegúrese de tener lo siguiente:
Credenciales de autenticación
El método de autenticación dependerá de la plataforma externa cuyos datos planea recuperar. Ring to (a través de API) actualmente admite autenticación básica, token de portador, clave API y OAuth.
En este ejemplo, utilizando la API de Aircall como ejemplo, utilizaremos el método de autenticación básica. Generaremos una clave API navegando a la sección “Integraciones & ” del Panel de control, haciendo clic en la pestaña “Claves API” y generando la clave.
📚 Dónde encontrar mi clave API de Aircall
Ahora guardaremos el ID y el token de la clave API, luego, en la configuración del widget Ring to (via API), iremos a “Credenciales” y configuraremos el ID de la clave API como nombre de usuario y el token como contraseña.
Conocimiento de la API de la plataforma
Dependiendo de la plataforma desde la cual desea obtener datos, es importante tener una buena comprensión de lo que se incluye en la API pública de esa plataforma.
Esta documentación utilizará la API de Aircall como ejemplo, pero los usuarios pueden utilizar otras plataformas asociadas como HubSpot, Salesforce, Zendesk, Intercom, Pipedrive o CRM internos como plataformas donde se solicitan datos para tomar decisiones de enrutamiento.
Conocimiento de JSON
Ring to (a través de API) también utiliza JSON, o Notación de objetos JavaScript, un formato estándar basado en texto que se utiliza comúnmente para transmitir datos entre aplicaciones web.
Recomendamos familiarizarse con los conceptos básicos de JSON antes de intentar configurar el widget Ring (a través de API).
Si necesita ayuda para configurar el widget Ring to (a través de API), el equipo de Servicios profesionales Aircall puede brindarle asesoramiento técnico e implementación práctica para garantizar el éxito.
Consideraciones de uso
El widget Ring to (via API) ofrece potentes capacidades al permitir el enrutamiento dinámico ("inteligente") de llamadas en función de los datos recuperados de su sistema externo. El widget puede consultar prácticamente cualquier sistema externo o base de datos que defina (siempre que admita una API REST basada en la web y métodos de autenticación estándar) y, lo más importante, enrutar al interlocutor entrante en función de la respuesta a la solicitud/consulta de API : esto es clave.
La respuesta de la API debe devolver datos en un formato que Aircall pueda interpretar y utilizar para el enrutamiento. Los tipos de respuesta admitidos incluyen:
- Usuario : se dirige a un agente específico según el ID de usuario o el correo electrónico de Aircall
- Equipo : se dirige a un equipo específico según el ID del equipo de Aircall
- Número de Aircall : se enruta internamente a otro número de Aircall según el ID del número de Aircall
- Número externo : enruta externamente a un número de teléfono específico (debe estar en formato internacional E.164)
Bueno, ¿qué sucede si necesita agregar lógica avanzada adicional al enrutamiento antes de transferir la llamada entrante al usuario, equipo o número necesario (por ejemplo, ramificación condicional, bucles, etc.)?
Básicamente, debes manejar la lógica avanzada de a quién o a dónde dirigir la llamada entrante fuera de Aircall . Solo cuando se toma la decisión final, debes presentar una de las opciones anteriores como parte de la carga útil de respuesta de la API.
En otras palabras, es un widget simple que plantea la pregunta: " ¿A quién o a dónde debo dirigir la llamada entrante? ". No tiene en cuenta ninguna lógica compleja (por ejemplo, si esto, entonces aquello, pero verifique esto primero, etc.). La lógica compleja debe gestionarse/procesarse fuera de Aircall primero; después, la respuesta a la pregunta es lo que debe presentarse nuevamente al widget.
Pasos de configuración
El comportamiento final del widget Llamar a (a través de API) es que elegirá llamar a un usuario de Aircall, a un equipo de Aircall, a un número de Aircall o a un número externo fuera de Aircall.
En este ejemplo, veremos cómo llamar a un usuario de Aircall utilizando el punto final de llamadas de búsqueda de la API de Aircall .
La API, o la sección de la API, que elijamos utilizar determinará si seleccionamos GET o POST como el “Método” en la configuración de Ring to (a través de API). En este caso, como utilizaremos el punto final de Search Calls de la API de Aircall, elegiremos GET como el método.
Para la URL, utilizaremos lo siguiente como ejemplo:
https://api.aircall.io/v1/calls/search?order=des & phone_number= {{callerNumber}}
En función de esta URL, Ring to (a través de la API) buscará números de teléfono en orden descendente, es decir, buscará a partir de las llamadas más recientes. Aircall casi siempre utiliza números de teléfono o direcciones de correo electrónico como identificador único en las plataformas asociadas, por lo que esta es una URL común que se puede utilizar para buscar un número de teléfono relevante.
Otras variables que podrían incluirse en esta URL se enumeran en los parámetros de consulta en la documentación de la API de Aircall sobre llamadas de búsqueda .
Configuración de respuesta
Ahora veremos la sección “Configuración de respuesta” del widget Ring to (vía API).
Los tipos de respuesta admitidos son:
- Usuario (ID o correo electrónico)
- Equipo (ID)
- Número de Aircall (interno)
- Número externo
Al igual que el widget estándar Ring to, el tipo de respuesta determinará a quién se dirigen las llamadas entrantes. “Usuario” llamará a un agente individual de Aircall, “Equipo” llamará a un equipo de Aircall, “Número de Aircall” llamará a otro número de Aircall y “Número externo” llamará a un número fuera de Aircall.
La sección “Ruta” analizará la respuesta proporcionada por la API. Dado que estamos aprovechando el punto final “Llamadas de búsqueda” de la API de Aircall, podemos ver la respuesta en la documentación de la API de Aircall.
Utilicemos lo siguiente como ejemplo:
calls[0].user.id
Si observamos la documentación de la API de Aircall, podemos ver que la ruta hace referencia a la sección “llamadas” de la respuesta, y que cada punto hace referencia a una subsección de la sección “llamadas” (en este caso, el valor “usuario” e “id”). El valor, 0, que se encuentra entre corchetes, es una matriz que indica que la respuesta comenzará con la primera llamada de la lista.
Podemos entonces asegurarnos de que la ruta que hemos elegido sea correcta a través de la sección “Respuesta de prueba” del widget Ring to (vía API) ingresando un número de teléfono en el que nos gustaría ejecutar la consulta.
Asegúrese de que el número ingresado en el campo “Respuesta de prueba” esté en formato E.164 .
Si hay un error, consulte la sección Errores de la documentación de la API de Aircall que indica el motivo del error y ayuda a solucionar el problema.
Finalmente, podemos configurar los ajustes de timbre, que son idénticos a los ajustes de timbre del widget Ring to estándar. Para obtener más información sobre los ajustes de timbre, consulte nuestro artículo del Centro de ayuda sobre el enrutamiento de llamadas .
Si necesita ayuda para configurar el widget Ring to (a través de API), equipo de Servicios profesionales de Aircall puede brindarle asesoramiento técnico e implementación práctica para garantizar el éxito.