¿Por qué aparece el error 412 (Precondition Failed) al consumir API de tipificación en Agent Script?
Table of Contents
Síntoma o Necesidad
Cuando intentas configurar el Agent Scripting para tipificar llamadas usando la API de Wolkvox Colgar, Tipificar y Ready, el sistema el error 412 (Precondition Failed) con el mensaje: "Please you must activate API v2 in wolkvox manager to use this service".
Contexto / Escenarios
Este escenario se presenta en operaciones que implementan procesos de automatización y tipificación desde Agent Scripting mediante REST API. Una característica de este escenario es que la API para consulta de códigos funciona correctamente, pero la API específica de tipificación es la que devuelve el error de bloqueo.
Respuesta / Solución
Este es un caso de configuración que se puede resolver de la siguiente manera:
- Ingresa a la Configuración desde el perfil administrador de wolkvox Manager.
- Dirígete a la ruta Integraciones.
- Ve a la pestaña Integración web.
- Habilita la opción "Activar API v2 AgentBox".

Siempre que se realicen ajustes en la Configuración de wolkvox Manager, se deben guardar los cambios realizados.
Validaciones adicionales
Si tras activar la opción persiste algún fallo, revisa que el método de envío (post, get,delete ) esté correcto según la documentación de la API y que las IPs públicas desde donde se consume el API, estén en el firewall de la operación y cuenten con los permisos correspondientes para el token.
Posibles Causas
El error se debe a que la API V2 para los servicios del AgentBox no viene habilitada por defecto y requiere una activación manual en la plataforma para permitir su consumo.