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
English (US)
CO Spanish (Colombia)
US English (US)
  • Home
  • wvx Control Interactions

Why does error 412 (Precondition Failed) appear when consuming typing APIs in 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.

  • wvx Digital Interaction
  • wvx Voice Interaction
  • wvx Conversational AI
  • wvx Control Interactions
  • wvx CRM
  • wvx Agent
  • wvx Studio
  • Cibersecurity and Compliance
  • Release
    wolkvox Manager release wolkvox Agent release wolkvox CRM release
+ More

Table of Contents

Symptom or Need Context / Scenarios Answer / Solution Possible Causes

Symptom or Need

When you try to configure Agent Scripting to type calls using the Wolkvox Hang Up, Type and Ready API, the system gives error 412 (Precondition Failed) with the message: "Please you must activate API v2 in wolkvox manager to use this service."

Context / Scenarios

This scenario occurs in operations that implement automation and typing processes from Agent Scripting using the REST API. A characteristic of this scenario is that the API for querying codes works correctly, but the specific typing API is the one that returns the blocking error.

Answer / Solution

This is a configuration case that can be resolved as follows:

  1. Access the Settings from the administrator profile of wolkvox Manager.
  2. Go to the Integrations route.
  3. Go to the Web Integration tab.
  4. Enable the " Activate API v2 AgentBox " option.

 

Whenever adjustments are made to the Wolkvox Manager settings, the changes should be saved.

Additional validations

If after activating the option any errors persist, check that the sending method ( post, get, delete) is correct according to the API documentation and that the public IPs from which the API is consumed are in the operation's firewall and have the corresponding permissions for the token.
 

Possible Causes

The error occurs because the V2 API for AgentBox services is not enabled by default and requires manual activation on the platform to allow its consumption.

api error precondition api v2 agentbox error 412 api codificación codificr tipificar agent scripting

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • What is wolkvox Storage and How to Activate and Use It
  • What Is the '4. Calls and Service Level by Hour' Report in Skills & Services in wolkvox Manager?
  • What is the '3. Negative Ratings Detail' Report in Copilot in wolkvox Manager?
  • What is the "8. CDR TTS" Report in Diagram Reports under wolkvox Manager

2026 Wolkvox

Information security policy | Privacy Policy

Expand