Posibles códigos de error al consumir las APIs de wolkvox CRM

Updated at May 29th, 2026

Table of Contents

Introducción ¿Qué significa el código 400 – BAD REQUEST? ¿Qué significa el código 401 – UNAUTHORIZED? ¿Qué significa el código 403 – FORBIDDEN? ¿Qué significa el código 404 – NOT FOUND? ¿Qué significa el código 405 – METHOD NOT ALLOWED? ¿Qué significa el código 412 – PRECONDITION FAILED? ¿Qué significa el código 416 – REQUESTED RANGE NOT SATISFIABLE? ¿Qué significa el código 417 – EXPECTATION FAILED?

Introducción

Al integrar sistemas externos con wolkvox CRM mediante sus APIs, es posible recibir respuestas con códigos de error HTTP que indican qué salió mal durante la solicitud. Conocer el significado de cada código permite identificar y corregir problemas de forma rápida, ya sea en la autenticación, los parámetros enviados, el método utilizado o los límites del sistema.

A continuación encontrarás todos los posibles códigos de error organizados por categoría, con su mensaje de respuesta y una explicación en español de la causa más probable.

¿Qué significa el código 400 – BAD REQUEST?

Este código indica que la solicitud enviada no pudo ser procesada. Puede deberse a que el endpoint consultado no existe o a que faltan parámetros obligatorios en la URL o en el cuerpo de la solicitud.

CÓDIGO	MENSAJE	EXPLICACIÓN
400 – BAD REQUEST	THE API YOU WANT TO CONSULT DOES NOT EXIST	El endpoint de API que intenta consultar no existe. Verifique la URL utilizada.
400 – BAD REQUEST	SOME PARAMETERS ARE REQUIRED	Pueden faltar parámetros obligatorios en la URL o en el cuerpo de la solicitud. Revise la documentación del endpoint para asegurarse de enviar todos los campos requeridos.

¿Qué significa el código 401 – UNAUTHORIZED?

Este código indica que la solicitud no incluye credenciales de autenticación. Es necesario enviar el token de wolkvox en el encabezado de cada solicitud.

CÓDIGO	MENSAJE	EXPLICACIÓN
401 – UNAUTHORIZED	PLEASE ENTER THE WOLKVOX-TOKEN	No se incluyó el token de autenticación en la solicitud. Asegúrese de enviar el encabezado Wolkvox-Token en cada petición a la API.

¿Qué significa el código 403 – FORBIDDEN?

Este código indica que el token enviado no tiene permiso para ejecutar la acción solicitada. Puede deberse a un token inválido, a que se superó el límite diario de uso o a que se están realizando demasiadas solicitudes simultáneas con el mismo token.

CÓDIGO	MENSAJE	EXPLICACIÓN
403 – FORBIDDEN	TOKEN LIMIT EXCEEDED	Se superó el límite de uso permitido del token durante el día. Espere al reinicio del contador o revise su plan de consumo.
403 – FORBIDDEN	EXCEEDS THE LIMIT OF SIMULTANEOUS REQUESTS PER TOKEN (2)	El mismo token está siendo utilizado en más de 2 solicitudes de forma simultánea. Solo se permiten hasta 2 peticiones concurrentes por token.
403 – FORBIDDEN	PLEASE VALIDATE TOKEN	El token enviado no es válido. Verifique que el valor del encabezado Wolkvox-Token sea correcto y esté activo.
403 – FORBIDDEN	INVALID TOKEN	El token enviado no es válido. Verifique que corresponda a la operación correcta y que no haya expirado o sido revocado.

¿Qué significa el código 404 – NOT FOUND?

Este código puede indicar varias situaciones: que no se encontraron registros para los filtros aplicados, que un recurso referenciado (agente, skill, campaña, conector) no existe en la operación, que ya se realizaron los cambios solicitados con anterioridad, o que se está intentando superar el límite de registros permitidos según las licencias activas.

CÓDIGO	MENSAJE	EXPLICACIÓN
404 – NOT FOUND	VALIDATE DATES ENTERED	El endpoint es correcto, pero no existen registros para el rango de fechas consultado. Verifique las fechas ingresadas.
404 – NOT FOUND	NO DATA FOUND	El endpoint es correcto, pero no se encontraron datos para los filtros aplicados en el rango de fechas indicado.
404 – NOT FOUND	CANNOT CREATE A NEW AGENT, THERE ARE SOME AGENTS WITHOUT INFORMATION	Existen uno o más agentes en la operación sin información completa. Complete los datos faltantes antes de intentar crear un nuevo agente.
404 – NOT FOUND	AGENTS EXCEED ASSIGNED LICENSES	No es posible crear más agentes porque se alcanzó el límite de licencias asignadas a la operación. Es necesario aumentar el número de licencias.
404 – NOT FOUND	THIS AGENT DOES NOT EXIST IN YOUR OPERATION, TRY AGAIN	El agente referenciado no existe en la operación. Verifique el identificador del agente enviado en la solicitud.
404 – NOT FOUND	THIS CODE ALREADY EXISTS	El código que intenta registrar ya existe dentro de la operación. Utilice un código diferente.
404 – NOT FOUND	REVIEW THE ERROR MESSAGE TO CORRECT POSSIBLE PROBLEMS	Es posible que alguno de los parámetros enviados esté mal escrito o tenga un formato incorrecto. Revise cuidadosamente el nombre y el valor de cada parámetro.
404 – NOT FOUND	ERROR NO FOUND MOBIL WHATSAPP	El ID enviado no corresponde a un conector de WhatsApp móvil. Verifique que el identificador del conector sea correcto y del tipo adecuado.
404 – NOT FOUND	SKILL_ID X DOES NOT EXIST IN YOUR OPERATION.	El skill referenciado no existe en la operación. Verifique el identificador del skill enviado en la solicitud.
404 – NOT FOUND	CAMPAING_ID X DOES NOT EXIST IN YOUR OPERATION.	La campaña referenciada no existe en la operación. Verifique el identificador de campaña enviado en la solicitud.
404 – NOT FOUND	THE CAMPAIGN HAS NOT BEEN STARTED, PLEASE VALIDATE THE DATA	La campaña ya se encontraba iniciada. No se realizó ningún cambio porque el estado solicitado coincide con el estado actual.
404 – NOT FOUND	THE CAMPAIGN HAS NOT BEEN STOPPED, PLEASE VALIDATE THE DATA	La campaña ya se encontraba detenida. No se realizó ningún cambio porque el estado solicitado coincide con el estado actual.
404 – NOT FOUND	THE CAMPAIGN HAS NOT BEEN UPDATED, PLEASE VALIDATE THE DATA	Los cambios que intenta aplicar sobre la campaña ya estaban efectuados con anterioridad. Valide los datos enviados.
404 – NOT FOUND	THIS ACTION IS ALLOWED ONLY IN PEDICTIVE CAMPAIGNS	La acción solicitada solo está disponible para campañas de tipo predictivo. Verifique el tipo de campaña antes de ejecutar esta operación.
404 – NOT FOUND	NO RECORD HAS BEEN CODED, PLEASE VALIDATE THE DATA	No se codificó ningún registro. Valide que los datos enviados sean correctos y que el registro exista en el sistema.
404 – NOT FOUND	YOU ARE UPLOADING (X) RECORDS TO THE SYSTEM. ACCORDING TO QUANTITY ACTIVE LICENSES, YOU CAN UPLOAD X. TRY AGAIN.	La cantidad de registros que intenta cargar supera el límite permitido según las licencias activas de la operación. Reduzca el número de registros o aumente las licencias disponibles.
404 – NOT FOUND	X RECORDS HAS BEEN ADDED, PLEASE VALIDATE THE DATA	No todos los registros fueron añadidos correctamente. Algunos pueden haberse omitido por errores en los datos. Valide la información enviada.
404 – NOT FOUND	THE CAMPAIGN RECORDS HAVE NOT BEEN DELETED, PLEASE VALIDATE THE DATA	Los registros de la campaña que intenta eliminar ya habían sido eliminados con anterioridad o no existen. Valide los datos enviados.

¿Qué significa el código 405 – METHOD NOT ALLOWED?

Este código indica que el método HTTP utilizado en la solicitud no es el correcto para el endpoint consultado. Cada API de wolkvox CRM admite únicamente el método HTTP definido en su documentación.

CÓDIGO	MENSAJE	EXPLICACIÓN
405 – METHOD NOT ALLOWED	ONLY THE USE OF THE GET METHOD IS ALLOWED IN THIS REQUEST	Este endpoint solo acepta solicitudes con el método GET. Cambie el método HTTP en su solicitud.
405 – METHOD NOT ALLOWED	ONLY THE USE OF THE POST METHOD IS ALLOWED IN THIS REQUEST	Este endpoint solo acepta solicitudes con el método POST. Cambie el método HTTP en su solicitud.
405 – METHOD NOT ALLOWED	ONLY THE USE OF THE PUT METHOD IS ALLOWED IN THIS REQUEST	Este endpoint solo acepta solicitudes con el método PUT. Cambie el método HTTP en su solicitud.
405 – METHOD NOT ALLOWED	ONLY THE USE OF THE DELETE METHOD IS ALLOWED IN THIS REQUEST	Este endpoint solo acepta solicitudes con el método DELETE. Cambie el método HTTP en su solicitud.

¿Qué significa el código 412 – PRECONDITION FAILED?

Este código indica que la consulta supera los límites máximos permitidos por el sistema, ya sea en peso de la respuesta, en número de registros retornados o en número de registros enviados en una sola carga. Para resolverlo, reduzca el rango de fechas consultado o divida la carga en lotes más pequeños.

CÓDIGO	MENSAJE	EXPLICACIÓN
412 – PRECONDITION FAILED	YOUR QUERY EXCEEDS THE SIZE LIMIT (200 MB), PLEASE DECREASES THE RANGE OF DATES	La consulta genera una respuesta que supera el límite de 200 MB. Reduzca el rango de fechas para obtener un resultado de menor tamaño.
412 – PRECONDITION FAILED	YOUR QUERY EXCEEDS THE RECORDS LIMIT (60000), PLEASE DECREASES THE RANGE OF DATES	La consulta retorna más de 60.000 registros, lo cual supera el límite permitido. Reduzca el rango de fechas para obtener menos resultados por solicitud.
412 – PRECONDITION FAILED	YOUR QUERY EXCEEDS THE RECORDS LIMIT (10000), PLEASE DECREASES THE RECORDS NUMBERS	Está intentando cargar más de 10.000 registros en una sola solicitud. Divida la carga en lotes de máximo 10.000 registros.

¿Qué significa el código 416 – REQUESTED RANGE NOT SATISFIABLE?

Este código indica que el rango de fechas enviado en la solicitud tiene algún problema: puede estar en un formato incorrecto, la fecha de inicio puede ser mayor que la fecha de fin, o el rango supera el máximo de días permitidos para ese endpoint.

CÓDIGO	MENSAJE	EXPLICACIÓN
416 – REQUESTED RANGE NOT SATISFIABLE	THE VALID FORMAT FOR THE (DATE_INI) IS YYYYMMDDHHIISS (20211103164009)	La fecha de inicio (DATE_INI) no tiene el formato correcto. El formato requerido es YYYYMMDDHHIISS. Ejemplo: 20211103164009.
416 – REQUESTED RANGE NOT SATISFIABLE	THE VALID FORMAT FOR THE (DATE_END) IS YYYYMMDDHHIISS (20211103164009)	La fecha de fin (DATE_END) no tiene el formato correcto. El formato requerido es YYYYMMDDHHIISS. Ejemplo: 20211103164009.
416 – REQUESTED RANGE NOT SATISFIABLE	DATE_INI CANNOT BE GREATER THAN DATE_END	La fecha de inicio es mayor que la fecha de fin. Corrija el rango para que DATE_INI sea anterior a DATE_END.
416 – REQUESTED RANGE NOT SATISFIABLE	THE VALID FORMAT FOR THE (RECALL_DATE) IS YYYYMMDDHHIISS (20211103164009)	La fecha de rellamada (RECALL_DATE) no tiene el formato correcto. El formato requerido es YYYYMMDDHHIISS. Ejemplo: 20211103164009.
416 – REQUESTED RANGE NOT SATISFIABLE	YOU CAN ONLY MAKE INQUIRIES FOR A MAXIMUM OF 31 DAYS	El rango de fechas enviado supera el máximo permitido de 31 días para este endpoint. Ajuste el rango para que no exceda ese límite.
416 – REQUESTED RANGE NOT SATISFIABLE	YOU CAN ONLY MAKE INQUIRIES FOR A MAXIMUM OF 1 DAY FOR THIS API	Este endpoint solo permite consultar un máximo de 1 día por solicitud. Ajuste el rango de fechas en consecuencia.

¿Qué significa el código 417 – EXPECTATION FAILED?

Este código es exclusivo de operaciones relacionadas con WhatsApp. Indica que el mensaje no pudo enviarse debido a condiciones no cumplidas: la plantilla no existe, no se ha iniciado la interacción con el cliente, han pasado más de 24 horas desde el último mensaje, el número tiene un formato incorrecto, o hubo un problema de conectividad con el servidor o la base de datos.

CÓDIGO	MENSAJE	EXPLICACIÓN
417 – EXPECTATION FAILED	ERROR NO FOUND TEMPLATE WHATSAPP	La plantilla de WhatsApp referenciada no existe. Verifique el identificador de la plantilla antes de enviarla.
417 – EXPECTATION FAILED	UNABLE TO SEND THE MESSAGE NO INTERACTION HAS BEEN INITIATED	No se ha iniciado ninguna interacción con el cliente. Debe enviarse primero una plantilla aprobada para abrir la conversación.
417 – EXPECTATION FAILED	UNABLE TO SEND THE MESSAGE THERE IS NO CHAT WITH THE CUSTOMER	No existe un chat activo con el cliente. Es necesario enviar una plantilla previamente para iniciar la conversación.
417 – EXPECTATION FAILED	UNABLE TO SEND THE MESSAGE THE CLIENT HAS NOT RESPONDED YET	El cliente aún no ha respondido al mensaje enviado anteriormente. No es posible continuar el flujo de mensajería hasta recibir su respuesta.
417 – EXPECTATION FAILED	IT WAS NOT POSSIBLE TO SEND THE MESSAGE MORE THAN 24 HOURS HAVE PASSED	Han transcurrido más de 24 horas desde el último mensaje de plantilla enviado al cliente. La ventana de conversación ha expirado. Envíe una nueva plantilla para reactivarla.
417 – EXPECTATION FAILED	NUMBER LESS THAN 7 DIGITS	El número de teléfono enviado tiene menos de 7 dígitos y no es válido. Verifique el número del destinatario.
417 – EXPECTATION FAILED	UNABLE TO CONNECT	No fue posible establecer conexión con la base de datos. Intente nuevamente más tarde.
417 – EXPECTATION FAILED	COULD NOT SEND TEMPLATE	No se pudo enviar la plantilla porque no se había enviado una previamente al cliente. Asegúrese de iniciar siempre la conversación con una plantilla aprobada.
417 – EXPECTATION FAILED	NO RECORD INSERTED	No fue posible insertar el registro en la base de datos por un problema de conectividad. Intente nuevamente más tarde.
417 – EXPECTATION FAILED	MESSAGE COULD NOT BE SENT	No fue posible enviar el mensaje por un problema de conectividad con el servidor afectado. Intente nuevamente más tarde.
417 – EXPECTATION FAILED	NOT SENT MESSAGE: THE NUMBER OF VARIABLES IS: X	El mensaje no fue enviado porque el número de variables enviadas no coincide con el número de variables que espera la plantilla. Revise la cantidad de parámetros enviados.
417 – EXPECTATION FAILED	MESSAGE HAS NOT BEEN SENT	El mensaje no pudo ser enviado. Verifique el estado del conector de WhatsApp y los datos de la solicitud.