Esta es tu guía completa de troubleshooting para las APIs de Wolkvox.
Referencia de códigos de error
Encuentra el código de error que recibiste, identifica la causa y aplica la solución recomendada.
Bad Request (2)
CÓDIGO
MENSAJE
EXPLICACIÓN
400
BAD REQUEST
THE API YOU WANT TO CONSULT DOES NOT EXIST
La API solicitada no existe. Verifica la URL y el endpoint.
400
BAD REQUEST
SOME PARAMETERS ARE REQUIRED
Faltan parámetros requeridos en la solicitud.
Token (6)
CÓDIGO
MENSAJE
EXPLICACIÓN
401
UNAUTHORIZED
PLEASE ENTER THE WOLKVOX-TOKEN
No se incluyó el token. Enviar token en el encabezado 'wolkvox-token'.
401
FORBIDDEN
TOKEN LIMIT EXCEEDED
Límite diario de tokens excedido.
401
FORBIDDEN
EXCEEDS THE LIMIT OF SIMULTANEOUS REQUESTS PER TOKEN (2)
Más de 2 solicitudes simultáneas con el mismo token. Limitar a máximo 2.
401
FORBIDDEN
PLEASE VALIDATE TOKEN
Token no válido. Verificar que sea correcto y no haya expirado.
401
FORBIDDEN
INVALID TOKEN
Token incorrecto, expirado o malformado.
401
FORBIDDEN
The APIs cannot be consumed at this time, try again later.
Servidor ocupado creando copias de seguridad. Intentar más tarde.
Not Found (18)
CÓDIGO
MENSAJE
EXPLICACIÓN
404
NOT FOUND
VALIDATE DATES ENTERED
No se encontraron registros para las fechas especificadas.
404
NOT FOUND
NO DATA FOUND
No hay datos disponibles en el rango de fechas proporcionado.
404
NOT FOUND
CANNOT CREATE A NEW AGENT, THERE ARE SOME AGENTS WITHOUT INFORMATION
Agentes existentes sin información completa. Completar datos antes de crear uno nuevo.
404
NOT FOUND
AGENTS EXCEED ASSIGNED LICENSES
Límite de licencias alcanzado. Ampliar licencias disponibles.
404
NOT FOUND
THIS AGENT DOES NOT EXIST IN YOUR OPERATION, TRY AGAIN
El agente no existe en la operación.
404
NOT FOUND
THIS CODE ALREADY EXISTS
El código ya existe. Usar un código único.
404
NOT FOUND
REVIEW THE ERROR MESSAGE TO CORRECT POSSIBLE PROBLEMS
Parámetro no válido o enviado incorrectamente.
404
NOT FOUND
ERROR NO FOUND MOBIL WHATSAPP
El ID no corresponde a un conector móvil válido.
404
NOT FOUND
SKILL_ID X DOES NOT EXIST IN YOUR OPERATION.
El skill no existe en la operación
404
NOT FOUND
CAMPAING_ID X DOES NOT EXIST IN YOUR OPERATION.
La campaña no existe en la operación.
404
NOT FOUND
THE CAMPAIGN HAS NOT BEEN STARTED, PLEASE VALIDATE THE DATA
La campaña ya fue iniciada. Validar estado antes de continuar.
404
NOT FOUND
THE CAMPAIGN HAS NOT BEEN STOPPED, PLEASE VALIDATE THE DATA
La campaña ya fue detenida. Validar estado antes de continuar.
404
NOT FOUND
THE CAMPAIGN HAS NOT BEEN UPDATED, PLEASE VALIDATE THE DATA
Los cambios ya fueron realizados. Validar estado de datos.
404
NOT FOUND
THIS ACTION IS ALLOWED ONLY IN PEDICTIVE CAMPAIGNS
Acción solo permitida para campañas predictivas.
404
NOT FOUND
NO RECORD HAS BEEN CODED, PLEASE VALIDATE THE DATA
No se encontró registro codificado. Validar datos enviados.
404
LIMITE
YOU ARE UPLOADING (X) RECORDS TO THE SYSTEM. ACCORDING TO QUANTITY ACTIVE LICENSES, YOU CAN UPLOAD X. TRY AGAIN.
Intentando subir más registros de los permitidos. Aumentar licencias o reducir registros.
404
NOT FOUND
X RECORDS HAS BEEN ADDED, PLEASE VALIDATE THE DATA
No se pudo añadir el registro. Validar datos.
404
NOT FOUND
THE CAMPAIGN RECORDS HAVE NOT BEEN DELETED, PLEASE VALIDATE THE DATA
Los cambios ya fueron realizados. No se aplicó ninguna acción.
Method Not Allowed (4)
CÓDIGO
MENSAJE
EXPLICACIÓN
405
METHOD NOT ALLOWED
ONLY THE USE OF THE GET METHOD IS ALLOWED IN THIS REQUEST
El recurso solo acepta método GET.
405
METHOD NOT ALLOWED
ONLY THE USE OF THE POST METHOD IS ALLOWED IN THIS REQUEST
El recurso solo acepta método POST.
405
METHOD NOT ALLOWED
ONLY THE USE OF THE PUT METHOD IS ALLOWED IN THIS REQUEST
El recurso solo acepta método PUT.
405
METHOD NOT ALLOWED
ONLY THE USE OF THE DELETE METHOD IS ALLOWED IN THIS REQUEST
El recurso solo acepta método DELETE.
Límites (4)
CÓDIGO
MENSAJE
EXPLICACIÓN
412
PRECONDITION FAILED
YOUR QUERY EXCEEDS THE SIZE LIMIT (200 MB), PLEASE DECREASES THE RANGE OF DATES
La consulta supera 200 MB. Reducir rango de fechas.
412
PRECONDITION FAILED
YOUR QUERY EXCEEDS THE RECORDS LIMIT (60000), PLEASE DECREASES THE RANGE OF DATES
La consulta supera 60,000 registros. Reducir rango de fechas.
412
PRECONDITION FAILED
YOUR QUERY EXCEEDS THE RECORDS LIMIT (10000), PLEASE DECREASES THE RECORDS NUMBERS
Intentando subir más de 10,000 registros. Reducir cantidad.
412
PRECONDITION FAILED
YOUR QUERY EXCEEDS THE TIME LIMIT (60 SECS), PLEASE DECREASES THE RANGE OF DATES
Ejecución supera 60 segundos. Reducir rango de fechas.
Fechas (6)
CÓDIGO
MENSAJE
EXPLICACIÓN
416
REQUESTED RANGE NOT SATISFIABLE
THE VALID FORMAT FOR THE (DATE_INI) IS YYYYMMDDHHIISS (20211103164009)
Formato de date_ini inválido. Usar YYYYMMDDHHIISS.
416
REQUESTED RANGE NOT SATISFIABLE
THE VALID FORMAT FOR THE (DATE_END) IS YYYYMMDDHHIISS (20211103164009)
Formato de date_end inválido. Usar YYYYMMDDHHIISS.
416
REQUESTED RANGE NOT SATISFIABLE
DATE_INI CANNOT BE GREATER THAN DATE_END
La fecha inicial no puede ser mayor que la final.
416
REQUESTED RANGE NOT SATISFIABLE
THE VALID FORMAT FOR THE (RECALL_DATE) IS YYYYMMDDHHIISS (20211103164009)
Formato de recall_date inválido. Usar YYYYMMDDHHIISS.
416
REQUESTED RANGE NOT SATISFIABLE
YOU CAN ONLY MAKE INQUIRIES FOR A MAXIMUM OF 31 DAYS
Solo se permiten consultas de máximo 31 días.
416
REQUESTED RANGE NOT SATISFIABLE
YOU CAN ONLY MAKE INQUIRIES FOR A MAXIMUM OF 1 DAY FOR THIS API
Esta API solo permite consultas de máximo 1 día.
WhatsApp (12)
CÓDIGO
MENSAJE
EXPLICACIÓN
417
EXPECTATION FAILED
ERROR NO FOUND TEMPLATE WHATSAPP
La plantilla especificada no existe.
417
EXPECTATION FAILED
UNABLE TO SEND THE MESSAGE NO INTERACTION HAS BEEN INITIATED
La interacción con el cliente no ha sido iniciada.
417
EXPECTATION FAILED
UNABLE TO SEND THE MESSAGE THERE IS NO CHAT WITH THE CUSTOMER
No existe chat previo. Iniciar conversación con plantilla aprobada.
417
EXPECTATION FAILED
UNABLE TO SEND THE MESSAGE THE CLIENT HAS NOT RESPONDED YET
El cliente no ha respondido al mensaje previo.
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 la última plantilla. Enviar nueva plantilla.
417
EXPECTATION FAILED
NUMBER LESS THAN 7 DIGITS
El número tiene menos de 7 dígitos. Ingresar número válido.
417
EXPECTATION FAILED
UNABLE TO CONNECT
Problema de conexión con la base de datos. Error temporal.
417
EXPECTATION FAILED
COULD NOT SEND TEMPLATE
No se usó plantilla para iniciar. Enviar plantilla aprobada primero.
417
EXPECTATION FAILED
NO RECORD INSERTED
No se pudo registrar en la base de datos. Error temporal.
417
EXPECTATION FAILED
MESSAGE COULD NOT BE SENT
Problema de conexión con el servidor. Intentar más tarde o contactar soporte.
417
EXPECTATION FAILED
NOT SENT MESSAGE: THE NUMBER OF VARIABLES IS: X
Cantidad de variables incorrecta. Incluir el número correcto de variables.
417
EXPECTATION FAILED
MESSAGE HAS NOT BEEN SENT
Error general de envío. Verificar parámetros e intentar nuevamente.
Servidor (4)
CÓDIGO
MENSAJE
EXPLICACIÓN
500
INTERNAL SERVER ERROR
AN UNEXPECTED ERROR OCCURRED
Error interno del servidor.
500
BAD GATEWAY
INVALID RESPONSE FROM UPSTREAM SERVER
El servidor recibió respuesta inválida de otro servidor.
500
SERVICE UNAVAILABLE
SERVER IS TEMPORARILY UNAVAILABLE
Servicio temporalmente no disponible.
500
GATEWAY TIMEOUT
REQUEST TIMED OUT
Tiempo de espera agotado.
503
SERVICE UNAVAILABLE
SERVICE UNAVAILABLE
El servicio no está disponible en este momento. Espera unos instantes y reintenta. Si el error persiste en horario normal, contacta a soporte indicando hora y operación afectada.