This is your complete troubleshooting guide for Wolkvox APIs.

Error Code Reference

Find the error code you received, identify the cause, and apply the recommended solution.

Bad Request (2)

CODE
MESSAGE
EXPLANATION
400
BAD REQUEST
THE API YOU WANT TO CONSULT DOES NOT EXIST
The requested API does not exist. Check the URL and endpoint.
400
BAD REQUEST
SOME PARAMETERS ARE REQUIRED
Required parameters are missing from the request.

Token (6)

CODE
MESSAGE
EXPLANATION
401
UNAUTHORIZED
PLEASE ENTER THE WOLKVOX-TOKEN
Token missing. Send token in the 'wolkvox-token' header.
401
FORBIDDEN
TOKEN LIMIT EXCEEDED
Daily token limit exceeded.
401
FORBIDDEN
EXCEEDS THE LIMIT OF SIMULTANEOUS REQUESTS PER TOKEN (2)
More than 2 simultaneous requests with the same token. Limit to a maximum of 2.
401
FORBIDDEN
PLEASE VALIDATE TOKEN
Invalid token. Verify that it is correct and has not expired.
401
FORBIDDEN
INVALID TOKEN
Incorrect, expired, or malformed token.
401
FORBIDDEN
The APIs cannot be consumed at this time, try again later.
Server busy creating backups. Try again later.

Not Found (18)

CODE
MESSAGE
EXPLANATION
404
NOT FOUND
VALIDATE DATES ENTERED
No records found for the specified dates.
404
NOT FOUND
NO DATA FOUND
No data available for the provided date range.
404
NOT FOUND
CANNOT CREATE A NEW AGENT, THERE ARE SOME AGENTS WITHOUT INFORMATION
Existing agents have incomplete information. Complete their data before creating a new one.
404
NOT FOUND
AGENTS EXCEED ASSIGNED LICENSES
License limit reached. Increase available licenses.
404
NOT FOUND
THIS AGENT DOES NOT EXIST IN YOUR OPERATION, TRY AGAIN
The agent does not exist in the operation.
404
NOT FOUND
THIS CODE ALREADY EXISTS
The code already exists. Use a unique code.
404
NOT FOUND
REVIEW THE ERROR MESSAGE TO CORRECT POSSIBLE PROBLEMS
Invalid parameter or incorrectly submitted.
404
NOT FOUND
ERROR NO FOUND MOBIL WHATSAPP
The ID is not a valid mobile connector.
404
NOT FOUND
SKILL_ID X DOES NOT EXIST IN YOUR OPERATION.
The skill does not exist in the operation.
404
NOT FOUND
CAMPAING_ID X DOES NOT EXIST IN YOUR OPERATION.
The campaign does not exist in the operation.
404
NOT FOUND
THE CAMPAIGN HAS NOT BEEN STARTED, PLEASE VALIDATE THE DATA
The campaign has already been started. Please validate the status before continuing.
404
NOT FOUND
THE CAMPAIGN HAS NOT BEEN STOPPED, PLEASE VALIDATE THE DATA
The campaign has already been stopped. Please validate the status before continuing.
404
NOT FOUND
THE CAMPAIGN HAS NOT BEEN UPDATED, PLEASE VALIDATE THE DATA
The changes have already been made. Please validate the data status.
404
NOT FOUND
THIS ACTION IS ALLOWED ONLY IN PEDICTIVE CAMPAIGNS
This action is only permitted for predictive campaigns.
404
NOT FOUND
NO RECORD HAS BEEN CODED, PLEASE VALIDATE THE DATA
No coded record was found. Please validate the submitted data.
404
Limit
YOU ARE UPLOADING (X) RECORDS TO THE SYSTEM. ACCORDING TO QUANTITY ACTIVE LICENSES, YOU CAN UPLOAD X. TRY AGAIN.
Attempting to upload more records than allowed. Increase licenses or reduce records.
404
NOT FOUND
X RECORDS HAS BEEN ADDED, PLEASE VALIDATE THE DATA
The record could not be added. Please validate the data.
404
NOT FOUND
THE CAMPAIGN RECORDS HAVE NOT BEEN DELETED, PLEASE VALIDATE THE DATA
The changes have already been made. No action was taken.

Method Not Allowed (4)

CODE
MESSAGE
EXPLANATION
405
METHOD NOT ALLOWED
ONLY THE USE OF THE GET METHOD IS ALLOWED IN THIS REQUEST
The resource only accepts the GET method.
405
METHOD NOT ALLOWED
ONLY THE USE OF THE POST METHOD IS ALLOWED IN THIS REQUEST
The resource only accepts the POST method.
405
METHOD NOT ALLOWED
ONLY THE USE OF THE PUT METHOD IS ALLOWED IN THIS REQUEST
The resource only accepts the PUT method.
405
METHOD NOT ALLOWED
ONLY THE USE OF THE DELETE METHOD IS ALLOWED IN THIS REQUEST
The resource only accepts the DELETE method.

Limits (4)

CODE
MESSAGE
EXPLANATION
412
PRECONDITION FAILED
YOUR QUERY EXCEEDS THE SIZE LIMIT (200 MB), PLEASE DECREASES THE RANGE OF DATES
The query exceeds 200 MB. Reduce date range.
412
PRECONDITION FAILED
YOUR QUERY EXCEEDS THE RECORDS LIMIT (60000), PLEASE DECREASES THE RANGE OF DATES
The query exceeds 60,000 records. Reduce date range.
412
PRECONDITION FAILED
YOUR QUERY EXCEEDS THE RECORDS LIMIT (10000), PLEASE DECREASES THE RECORDS NUMBERS
Attempting to upload more than 10,000 records. Reduce quantity.
412
PRECONDITION FAILED
YOUR QUERY EXCEEDS THE TIME LIMIT (60 SECS), PLEASE DECREASES THE RANGE OF DATES
Execution exceeds 60 seconds. Reduce date range.

Dates (6)

CODE
MESSAGE
EXPLANATION
416
REQUESTED RANGE NOT SATISFIABLE
THE VALID FORMAT FOR THE (DATE_INI) IS YYYYMMDDHHIISS (20211103164009)
Invalid date_ini format. Use YYYYMMDDHHIISS.
416
REQUESTED RANGE NOT SATISFIABLE
THE VALID FORMAT FOR THE (DATE_END) IS YYYYMMDDHHIISS (20211103164009)
Invalid date_end format. Use YYYYMMDDHHIISS.
416
REQUESTED RANGE NOT SATISFIABLE
DATE_INI CANNOT BE GREATER THAN DATE_END
The start date cannot be greater than the end date.
416
REQUESTED RANGE NOT SATISFIABLE
THE VALID FORMAT FOR THE (RECALL_DATE) IS YYYYMMDDHHIISS (20211103164009)
Invalid recall_date format. Use YYYYMMDDHHIISS.
416
REQUESTED RANGE NOT SATISFIABLE
YOU CAN ONLY MAKE INQUIRIES FOR A MAXIMUM OF 31 DAYS
Only queries for a maximum of 31 days are allowed.
416
REQUESTED RANGE NOT SATISFIABLE
YOU CAN ONLY MAKE INQUIRIES FOR A MAXIMUM OF 1 DAY FOR THIS API
This API only allows queries for a maximum of 1 day.

WhatsApp (12)

CODE
MESSAGE
EXPLANATION
417
EXPECTATION FAILED
ERROR NO FOUND TEMPLATE WHATSAPP
The specified template does not exist.
417
EXPECTATION FAILED
UNABLE TO SEND THE MESSAGE NO INTERACTION HAS BEEN INITIATED
Customer interaction has not been initiated.
417
EXPECTATION FAILED
UNABLE TO SEND THE MESSAGE THERE IS NO CHAT WITH THE CUSTOMER
No prior chat exists. Initiate conversation with an approved template.
417
EXPECTATION FAILED
UNABLE TO SEND THE MESSAGE THE CLIENT HAS NOT RESPONDED YET
The customer has not responded to the previous message.
417
EXPECTATION FAILED
IT WAS NOT POSSIBLE TO SEND THE MESSAGE MORE THAN 24 HOURS HAVE PASSED
More than 24 hours have passed since the last template. Send a new template.
417
EXPECTATION FAILED
NUMBER LESS THAN 7 DIGITS
The number has fewer than 7 digits. Enter a valid number.
417
EXPECTATION FAILED
UNABLE TO CONNECT
Database connection problem. Temporary error.
417
EXPECTATION FAILED
COULD NOT SEND TEMPLATE
No template was used to start. Send an approved template first.
417
EXPECTATION FAILED
NO RECORD INSERTED
Failed to save to the database. Temporary error.
417
EXPECTATION FAILED
MESSAGE COULD NOT BE SENT
Connection problem with the server. Try again later or contact support.
417
EXPECTATION FAILED
NOT SENT MESSAGE: THE NUMBER OF VARIABLES IS: X
Incorrect number of variables. Include the correct number of variables.
417
EXPECTATION FAILED
MESSAGE HAS NOT BEEN SENT
General sending error. Verify parameters and try again.

Server (4)

CODE
MESSAGE
EXPLANATION
500
INTERNAL SERVER ERROR
AN UNEXPECTED ERROR OCCURRED
Internal server error.
500
BAD GATEWAY
INVALID RESPONSE FROM UPSTREAM SERVER
The server received an invalid response from another server.
500
SERVICE UNAVAILABLE
SERVER IS TEMPORARILY UNAVAILABLE
Service temporarily unavailable.
500
GATEWAY TIMEOUT
REQUEST TIMED OUT
Request timed out.
503
SERVICE UNAVAILABLE
SERVICE UNAVAILABLE
The service is currently unavailable. Please wait a moment and try again. If the error persists during normal operating hours, please contact support, indicating the time and affected operation.


Start transforming your interactions into Power Conversations today

‍
Schedule a demo