Síntoma / Necesidad

El cliente necesita integrar las funciones de wolkvox Agent (Agentbox) en sus aplicaciones externas mediante APIs, optimizando el flujo de trabajo del agente sin depender del acceso directo al aplicativo.

Contexto / Escenarios

Las APIs de agentes permiten realizar tareas habituales de wolkvox Agent (Agentbox) directamente desde aplicaciones externas o desarrollos personalizados. Estas acciones automatizan procesos como marcar, colgar, o cambiar el estado del agente, facilitando la autogestión y aumentando la eficiencia operativa.

Escenarios comunes:

• Automatizar llamadas salientes y colgar sin intervenir directamente en el aplicativo.
• Cambiar el estado del agente (Ready, Logout, ACW) desde una aplicación externa.
• Realizar transferencias y llamadas auxiliares manteniendo la relación con el cliente.
• Manejar la visibilidad del aplicativo wolkvox Agent (Agentbox).

Respuesta (Solución / Recomendación)

Configuración inicial

Para habilitar el uso de las APIs, es necesario que el administrador siga estos pasos en la configuración de integraciones:

1. Ir a Configuración > Integraciones > Pestaña Integración Web.
2. Habilitar los siguientes checks:
   • Activar API wolkvox Agent (Agentbox) puerto: Ingresar el puerto de conexión (por defecto: 80).
   • Activar API v2 wolkvox Agent (Agentbox).
3. Guardar los cambios.

Ejemplo de consumo de API: Marcar

Si el puerto configurado es 80, la URL para realizar una llamada sería:

http://localhost:80/apiagentbox?action=dial&phone=945109000&id_customer=98629699

Desglose de parámetros:

• phone: El número de teléfono del cliente (incluir prefijo si aplica).
• id_customer: La identificación del cliente.

Ejemplo ajustado: Supongamos que el prefijo de las llamadas es 9 y el número del cliente es 3104384735 con identificación 1216716845:

http://localhost:80/apiagentbox?action=dial&phone=93104384735&id_customer=1216716845

Ejecute esta URL mientras el aplicativo wolkvox Agent (Agentbox) del agente esté abierto, y la llamada comenzará automáticamente.

Listado de APIs disponibles

• Marcar: Realiza una llamada desde el wolkvox Agent (Agentbox).
• Colgar: Finaliza una llamada activa.
• Codificar: Asigna un código de gestión a una llamada finalizada.
• Reprogramar llamada predictiva: Configura una nueva llamada desde un predictivo.
• Colgar - Codificar - Ready: Combina las tres acciones en un solo consumo.
• Wolkvox Agent Visible / Invisible: Alterna la visibilidad de wolkvox Agent (Agentbox).
• Ready: Cambia el estado del agente a Ready.
• Logout: Cierra sesión del agente.
• Mute: Silencia el micrófono del agente.
• Hold: Coloca una llamada en espera.
• Realizar llamada auxiliar: Inicia una llamada auxiliar manteniendo la relación con el cliente.
• Presionar teclado DTMF: Ejecuta tonos DTMF desde aplicaciones externas.
• Transferencia: Realiza una transferencia de llamada.
• Marcar con ID y Nombre: Adjunta el ID y nombre del cliente para futuras transferencias.
• Codificar registros en campañas preview: Gestiona registros en campañas preview.
• ACW: Cambia el estado del wolkvox Agent (Agentbox) a ACW.

Nota importante:

Para consumir cualquier otra API, solo debe reemplazar los valores requeridos en la URL correspondiente.

Enlace a la documentación completa de las APIs de agentes: https://www.wolkvox.com/api-agentes/#

Consejo: Mantenga siempre el wolkvox Agent (Agentbox) abierto al consumir las APIs para asegurar que las acciones se ejecuten correctamente.