La distribución inteligente al último agente garantiza que las personas que vuelven a llamar se conecten automáticamente con el agente que las contactó por última vez. Al usar el widget Ring-to (via API) de Aircall en Smartflows, puedes mejorar tus esfuerzos de llamadas salientes y ofrecer una experiencia más fluida a tus clientes recurrentes.

Importante: El widget Ring-to (via API) debe habilitarse mediante una feature flag. Ponte en contacto con tu representante de Aircall para habilitarlo antes de continuar.
Nota: Es posible que el videotutorial muestre la versión anterior de la sección Test Response. Consulta siempre los pasos escritos de este artículo para obtener la guía más actualizada.

¿Por qué usar la distribución inteligente al último agente?

Usar el widget Ring-to (via API) para configurar la distribución al último agente ofrece varias ventajas:

  • Mejora de la experiencia de la persona que llama al conectar a los clientes recurrentes con el agente que conoce su caso
  • Reducción del abandono de llamadas ya que las llamadas van directamente a un punto de contacto conocido
  • Mayor eficiencia, evitando que todo el equipo sea interrumpido por llamadas entrantes no relacionadas
  • Mejor gestión de leads ya que los agentes se centran en sus propios prospectos

Crea tu clave API de Aircall

Para empezar, necesitas una clave API de Aircall. Esto permitirá que el widget Ring-to (via API) se autentique y obtenga el historial de llamadas.

Pasos

  1. En el panel de Aircall, ve a Integrations & API > API Keys.
  2. Haz clic en Generate an API Key.
Screenshot 2025-09-16 at 6.51.05 PM.png
Screenshot 2025-09-16 at 6.52.20 PM.png
  1. Asigna un nombre a tu clave y luego copia el API ID y el API token.
Screenshot 2025-09-16 at 6.55.35 PM.png
  1. Guárdalos de forma segura, ya que esta es la única vez que el token será visible.
  2. Haz clic en Confirm.
Nota: Si pierdes el token, tendrás que generar uno nuevo.

Configura el widget Ring-to (via API) en Smartflows

Ahora, configura tu Smartflow usando la clave API para habilitar el enrutamiento dinámico.

Pasos

  1. En el panel de Aircall, ve al número de Smartflows que quieres configurar.

  2. Inserta el widget Ring-to (via API) en la posición deseada dentro del flujo de llamadas.

Nota: Los usuarios dirigidos mediante la API no necesitan estar asignados a la distribución de llamadas de Smartflows. Sin embargo, si están asignados, recibirán notificaciones de llamadas perdidas en su lista de tareas pendientes.
  1. Configura la Request en el editor del widget:
    • URL: Copia y pega la siguiente URL: https://api.aircall.io/v1/calls/search?direction=outbound&order=desc&phone_number={{callerNumber}}
      • Esta URL buscará la llamada saliente más reciente realizada al número de la llamada entrante actual y devolverá el Usuario de Aircall correspondiente.
    • Method: En el menú desplegable Method, POST y GET estarán disponibles como opciones. Asegúrate de haber seleccionado GET

    • Authentication: En el menú desplegable Authentication, estarán disponibles las siguientes opciones: Basic Auth (User & Password), Bearer token, API Key, OAuth y None. Asegúrate de haber seleccionado Basic Auth (User & Password)

    • Credentials: Selecciona Set credentials e introduce la siguiente información:
      • Username = tu API ID
      • Password = tu API token
  1. Desplázate hacia abajo y configura la Response:
    • Response type: En el menú desplegable Response type, estarán disponibles como opciones User (ID or email), Team (ID), Aircall number (internal), External number y Dynamic Target (ID). Asegúrate de haber seleccionado User (ID or email)

    • Path: Copia y pega lo siguiente en el campo Path: calls[0].user.id

    • Para terminar, debes ejecutar una prueba de la respuesta en el campo específico Test response. Este campo acepta un objeto JSON que contiene una o más variables de entrada utilizadas en la URL o el cuerpo de tu solicitud.
    • Para este ejemplo, deberás proporcionar callerNumber en formato E.164, aunque también puedes incluir otras variables si tu configuración lo requiere.
    • Ejemplo:
      {
        "callerNumber": "+15551234567"
      }
    • Cuando ejecutes la prueba, el widget sustituirá la(s) variable(s) de tu solicitud por los valores del JSON y mostrará el resultado analizado en función de la ruta configurada (calls[0].user.id). Asegúrate de que la carga devuelta contiene los datos esperados para que el widget pueda dirigir la llamada correctamente.
  1. Ajusta la configuración de timbrado debajo del campo de prueba según sea necesario para adaptarla a tus preferencias operativas.
Consejo: Ejecuta siempre una prueba para validar que la ruta devuelve un ID de Usuario de Aircall correcto.

Opcional: Añade un equipo de respaldo

Considera añadir un equipo de respaldo después del widget Ring-to (via API) para garantizar que no se pierda ninguna llamada si el último agente no está disponible.

Nota: Todos los destinos de enrutamiento (usuarios, equipos, números) deben existir antes de configurar el widget Ring-to (via API).
help?
Consejo: Si te interesa aprovechar esta función pero no cuentas con conocimientos técnicos, ponte en contacto con nuestro equipo de Account Management, que te pondrá en contacto con nuestro equipo técnico para ofrecerte soporte y orientación en la implementación.