Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact Us
Spanish (Colombia)
CO Spanish (Colombia)
US English (US)
  • Home
  • wvx Control Interactions

¿Por qué aparece el error 412 (Precondition Failed) al consumir API de tipificación en Agent Script?

Written by Sandra Ocaña

Updated at July 22nd, 2026

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

Table of Contents

Síntoma o Necesidad Contexto / Escenarios Respuesta / Solución Posibles Causas

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:

  1. Ingresa a la Configuración desde el perfil administrador de wolkvox Manager.
  2. Dirígete a la ruta Integraciones.
  3. Ve a la pestaña Integración web.
  4. 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.

api v2 error manager tipificación agent scripting rest api api v2 agentbox precondition failed error 412

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • ¿Por qué no aparece el estado ACW al tipificar por Agent script?
  • ¿Por qué no se visualizan los códigos de tipificación en Agent Script?
  • Posibles códigos de error al consumir las APIs de wolkvox CRM

2026 Wolkvox

Information security policy | Privacy Policy

Expand