En palabras, el widget "Llamar a (vía API)" de Enrutamiento Inteligente utiliza una respuesta de la API para saber a qué equipo, usuario, número interno o externo de Aircall llamar, basándose en datos externos a Aircall.
Si Llamar a (vía API) es un widget flexible que permite lograr diversos flujos trabajo según diversas plataformas externas, en este tutorial veremos un ejemplo uso de la API Llamar a (vía API) en su editor de Smartflows.
⚠️ Necesitas tener el Plan Profesional para acceder al widget "Llamar a" (vía API) en tu editor de Smartflows. Si deseas actualizar, contacta con tu gestor de cuenta.
Requisitos previos
Antes de configurar el widget Ring to (vía API), asegúrese de tener lo siguiente:
Credenciales de autenticación
El método de autenticación dependerá de la plataforma externa cuyos datos planee recuperar. Ring to (vía API) actualmente admite autenticación básica, token de portador, clave de API y OAuth.
En este ejemplo, usando la API de Aircall como ejemplo, usaremos el método de autenticación básica. Generaremos una clave API navegando a la sección "Integraciones & API" 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 estableceremos el ID de la clave API como nombre de usuario y el token como contraseña.
Conocimiento de la API de la plataforma
Según la plataforma desde la que desee obtener los datos, es importante comprender bien lo que se incluye en la API pública de esa plataforma.
Esta documentación usará la API de Aircall como ejemplo, pero los usuarios pueden usar otras plataformas de socios 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 la API) también usa JSON o notación de objetos JavaScript, un formato estándar basado en texto que se usa comúnmente para transmitir datos entre aplicaciones web.
Le recomendamos que se familiarice con los conceptos básicos de JSON antes de intentar configurar el widget Ring to (via API).
Si necesita ayuda para configurar el widget Ring to (via API), el equipo de Servicios profesionales de Aircall puede proporcionar consultoría técnica e implementación práctica para garantizar el éxito.
Consideraciones de uso
El widget Ring to (via API) ofrece potentes capacidades al habilitar el enrutamiento de llamadas dinámico ("inteligente") basado en 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 web y métodos de autenticación estándar) y, lo más importante, enrutar la llamada entrante en 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 usar para el enrutamiento. Los tipos de respuesta admitidos incluyen:
- Usuario : Enruta a un agente específico según el ID de usuario o correo electrónico de Aircall
- Equipo : Enruta a un equipo específico según el ID de equipo de Aircall
- Número de Aircall : Enruta internamente a otro número de Aircall según el ID de número de Aircall
- Número externo : Enruta externamente a un número de teléfono especificado (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? (p. ej., ramificación condicional, bucles, etc.)?
En esencia, debe gestionar la lógica avanzada de a quién o dónde enrutar la llamada entrante fuera de Aircall . Solo cuando se tome la decisión final, debe presentar una de las opciones anteriores como parte de la carga útil de la respuesta de la API.
En otras palabras, es un widget simple que pregunta: " A quién o dónde debo enrutar la llamada entrante? . No considera ninguna lógica compleja (p. ej., si esto, entonces aquello, pero comprobar esto primero, etc.). La lógica compleja debe gestionarse/procesarse primero fuera de Aircall; después, la respuesta a la pregunta es lo que debe presentarse 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, un equipo de Aircall, un número de Aircall o 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 Llamar a (a través de API). En este caso, como utilizaremos el punto final "Buscar llamadas" de la API de Aircall, elegiremos GET como
. Para la URL, usaremos el siguiente ejemplo:
& phone_number= {{callerNumber}} Con en esta URL, Ring to (a través de la API buscará números
teléfono en orden descendente es decir, comenzando por las llamadas más recientes. Aircall casi siempre usa números
o direcciones de correo electrónico
identificador único en las plataformas asociadas, por lo que esta es una URL común que se puede usar 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 de llamadas de búsqueda .
Configuración de respuesta
Ahora veremos la sección "Configuración de respuesta" del widget Llamar a (a través de 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 Llamar a, 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 "Buscar llamadas" de la API de Aircall, podemos ver la respuesta en la documentación de la API de Aircall.
Usemos lo siguiente como ejemplo:
calls[0].user.id
Al observar la documentación de la API de Aircall, podemos ver que la ruta hace referencia a la sección "llamadas" de la respuesta, y cada punto hace referencia a una subsección de la sección "llamadas" (en este caso, el valor "usuario" e "id"). El valor, 0, contenido entre corchetes, es una matriz que indica que la respuesta comenzará con la primera llamada de la lista.
Luego, podemos asegurarnos de que la ruta que hemos elegido sea correcta a través de la sección "Probar respuesta" del widget Llamar a (a través de la API) ingresando un número de teléfono en el que nos gustaría ejecutar la consulta.
Asegúrate de que el número ingresado en el campo "Respuesta de prueba" esté en formato E.164 .
Si hay un error, consulta la sección Errores de la documentación de la API de Aircall , que indica el motivo del error y ayuda con la solución de problemas.
Finalmente, podemos configurar los ajustes de timbre, que son idénticos a los ajustes de timbre en el widget Ring to estándar. Para obtener más información sobre la configuración de timbre, consulte nuestro artículo del Centro de ayuda sobre enrutamiento de llamadas .
Si necesita ayuda para configurar el widget Ring to (vía API), el equipo de Servicios Profesionales de Aircall puede brindarle consultoría técnica e implementación práctica para garantizar el éxito.