ARGENTINA
Buenos Aires +54 (11) 5217 5933
BRAZIL
Sao Paulo +55 (11) 521 75 933
CHILE
Santiago de Chile +56 (2) 240 533 89
Our APIs feature standardized response codes in accordance with the HTTP protocol. Depending on the API consumed, an explanatory message will be provided with the next steps to take.
| Error Type | Explanation | Code | Error | Message |
|---|---|---|---|---|
| NOT FOUND | The error occurs because the requested API does not exist in the system. Check the URL and endpoint you are using to ensure they are correct. It is possible that the endpoint has been modified or is not available in the current version. | 400 | BAD REQUEST | THE API YOU WANT TO CONSULT DOES NOT EXIST |
| PARAMETERS | The error occurs because necessary parameters are missing in the URL or in the body of the request. Make sure all required parameters are correctly included in the request, as specified in the API documentation. | 400 | BAD REQUEST | SOME PARAMETERS ARE REQUIRED |
| TOKEN | The error occurs because the authentication token was not included in the request. Make sure to send a valid token in the ‘wolkvox-token’ header to authenticate correctly and access the API. | 401 | UNAUTHORIZED | PLEASE ENTER THE WOLKVOX-TOKEN |
| TOKEN | The error occurs because the daily allowed limit of token usage has been exceeded. This may be due to multiple requests in a short period of time. | 403 | FORBIDDEN | TOKEN LIMIT EXCEEDED |
| TOKEN | The error occurs because more than two simultaneous requests are being made using the same token. Ensure that the number of concurrent requests per token is limited to a maximum of two to comply with the API usage policies. | 403 | FORBIDDEN | EXCEEDS THE LIMIT OF SIMULTANEOUS REQUESTS PER TOKEN (2) |
| TOKEN | The error occurs because the provided token is invalid. Verify that the token is correct, has not expired, and is associated with the corresponding account. | 403 | FORBIDDEN | PLEASE VALIDATE TOKEN |
| TOKEN | The error occurs because the provided token is invalid. This may be due to an incorrect, expired, or malformed token. Ensure you are using a valid and authorized token to access the API. | 403 | FORBIDDEN | INVALID TOKEN |
| NOT FOUND | The error indicates that the API is correct, but no records were found for the specified dates in the search. Verify that the entered dates are valid and that there is data within the provided time range. | 404 | NOT FOUND | VALIDATE DATES ENTERED |
| NOT FOUND | The error indicates that the API is correct, but no data was found for the specified dates in the request. Verify that the entered dates are correct and that there are records available within the provided range. | 404 | NOT FOUND | NO DATA FOUND |
| NOT FOUND | It is not possible to create a new agent because there are previously created agents in the operation who do not have complete basic information. | 404 | NOT FOUND | CANNOT CREATE A NEW AGENT, THERE ARE SOME AGENTS WITHOUT INFORMATION |
| NOT FOUND | You cannot create more agents, as the limit of licenses assigned to the operation has been reached. Please increase the available licenses. | 404 | NOT FOUND | AGENTS EXCEED ASSIGNED LICENSES |
| NOT FOUND | The agent does not exist in the operation. | 404 | NOT FOUND | THIS AGENT DOES NOT EXIST IN YOUR OPERATION, TRY AGAIN |
| NOT FOUND | The code already exists in the operation. | 404 | NOT FOUND | THIS CODE ALREADY EXISTS |
| NOT FOUND | The provided parameter is invalid or is being sent incorrectly. Please review the error message to resolve possible issues. | 404 | NOT FOUND | REVIEW THE ERROR MESSAGE TO CORRECT POSSIBLE PROBLEMS |
| NOT FOUND | The provided ID does not correspond to a valid mobile connector. Please verify the ID and try again. | 404 | NOT FOUND | ERROR NO FOUND MOBIL WHATSAPP |
| NOT FOUND | The skill does not exist in the operation. | 404 | NOT FOUND | SKILL_ID X DOES NOT EXIST IN YOUR OPERATION. |
| NOT FOUND | The campaign does not exist in the operation. | 404 | NOT FOUND | CAMPAING_ID X DOES NOT EXIST IN YOUR OPERATION. |
| NOT FOUND | The action could not be completed because the campaign has already been started. Please validate the data before continuing. | 404 | NOT FOUND | THE CAMPAIGN HAS NOT BEEN STARTED, PLEASE VALIDATE THE DATA |
| NOT FOUND | The action could not be completed because the campaign had already been stopped. Please validate the data before continuing. | 404 | NOT FOUND | THE CAMPAIGN HAS NOT BEEN STOPPED, PLEASE VALIDATE THE DATA |
| NOT FOUND | The requested action could not be applied because the changes had already been made previously. Please validate the status of the data. | 404 | NOT FOUND | THE CAMPAIGN HAS NOT BEEN UPDATED, PLEASE VALIDATE THE DATA |
| NOT FOUND | This action is only allowed for campaigns configured as predictive. Check the campaign type and adjust the configuration if necessary. | 404 | NOT FOUND | THIS ACTION IS ALLOWED ONLY IN PREDICTIVE CAMPAIGNS |
| NOT FOUND | No coded record has been found. Please validate the submitted data and confirm that the record is correctly encoded. | 404 | NOT FOUND | NO RECORD HAS BEEN CODED, PLEASE VALIDATE THE DATA |
| LIMIT | An attempt is being made to upload more records than allowed based on the number of active licenses. Please increase the number of licenses or reduce the number of records sent. | 404 | NOT FOUND | YOU ARE UPLOADING (X) RECORDS TO THE SYSTEM. ACCORDING TO QUANTITY ACTIVE LICENSES, YOU CAN UPLOAD X. TRY AGAIN. |
| NOT FOUND | The record could not be added. Please validate the data and try again. | 404 | NOT FOUND | X RECORDS HAS BEEN ADDED, PLEASE VALIDATE THE DATA |
| NOT FOUND | The changes had already been made previously. No action has been applied. Please validate the status of the data. | 404 | NOT FOUND | THE CAMPAIGN RECORDS HAVE NOT BEEN DELETED, PLEASE VALIDATE THE DATA |
| METHOD | The requested resource can only be consumed using the GET method. Please adjust the request and try again. | 405 | METHOD NOT ALLOWED | ONLY THE USE OF THE GET METHOD IS ALLOWED IN THIS REQUEST |
| METHOD | The requested resource can only be consumed using the POST method. Please adjust the request and try again. | 405 | METHOD NOT ALLOWED | ONLY THE USE OF THE POST METHOD IS ALLOWED IN THIS REQUEST |
| METHOD | The requested resource can only be consumed using the PUT method. Please adjust the request and try again. | 405 | METHOD NOT ALLOWED | ONLY THE USE OF THE PUT METHOD IS ALLOWED IN THIS REQUEST |
| METHOD | The requested resource can only be consumed using the DELETE method. Adjust the request to use this method. | 405 | METHOD NOT ALLOWED | ONLY THE USE OF THE DELETE METHOD IS ALLOWED IN THIS REQUEST |
| LIMIT | The query exceeds the allowed size limit (200 MB). Reduce the date range and try again. | 412 | PRECONDITION FAILED | YOUR QUERY EXCEEDS THE SIZE LIMIT (200 MB), PLEASE DECREASES THE RANGE OF DATES |
| LIMIT | The query exceeds the allowed record limit (60000). Reduce the date range or the records and try again. | 412 | PRECONDITION FAILED | YOUR QUERY EXCEEDS THE RECORDS LIMIT (60000), PLEASE DECREASES THE RANGE OF DATES |
| LIMIT | You are attempting to upload more than 10000 records in a single request. Reduce the number of records and try again. | 412 | PRECONDITION FAILED | YOUR QUERY EXCEEDS THE RECORDS LIMIT (10000), PLEASE DECREASES THE RECORDS NUMBERS |
| LIMIT | The execution time of the query has exceeded the 60-second limit. Reduce the date range of the query to decrease the amount of processed data and try again. | 412 | PRECONDITION FAILED | YOUR QUERY EXCEEDS THE TIME LIMIT (60 SECS), PLEASE DECREASES THE RANGE OF DATES |
| DATE | The start date (date_ini) does not have a valid format. The expected format is YYYYMMDDHHIISS (e.g., 20231103164009). | 416 | REQUESTED RANGE NOT SATISFIABLE | THE VALID FORMAT FOR THE (DATE_INI) IS YYYYMMDDHHIISS (20211103164009) |
| DATE | The end date (date_end) does not have a valid format. The expected format is YYYYMMDDHHIISS (e.g., 20231103164009). | 416 | REQUESTED RANGE NOT SATISFIABLE | THE VALID FORMAT FOR THE (DATE_END) IS YYYYMMDDHHIISS (20211103164009) |
| DATE | The start date (date_ini) cannot be greater than the end date (date_end). Review the provided dates. | 416 | REQUESTED RANGE NOT SATISFIABLE | DATE_INI CANNOT BE GREATER THAN DATE_END |
| DATE | The recall date (recall_date) does not have a valid format. The expected format is YYYYMMDDHHIISS (e.g., 20231103164009). | 416 | REQUESTED RANGE NOT SATISFIABLE | THE VALID FORMAT FOR THE (RECALL_DATE) IS YYYYMMDDHHIISS (20211103164009) |
| LIMIT | Queries are only allowed for a maximum range of 31 days. Reduce the date range and try again. | 416 | REQUESTED RANGE NOT SATISFIABLE | YOU CAN ONLY MAKE INQUIRIES FOR A MAXIMUM OF 31 DAYS |
| LIMIT | Queries are only allowed for a maximum range of 1 day for this API. Reduce the date range and try again. | 416 | REQUESTED RANGE NOT SATISFIABLE | YOU CAN ONLY MAKE INQUIRIES FOR A MAXIMUM OF 1 DAY FOR THIS API |
| The specified template does not exist. | 417 | EXPECTATION FAILED | ERROR NO FOUND TEMPLATE WHATSAPP | |
| The message cannot be sent because interaction with the customer has not been initiated. Check the interaction status before proceeding. | 417 | EXPECTATION FAILED | UNABLE TO SEND THE MESSAGE NO INTERACTION HAS BEEN INITIATED | |
| The message cannot be sent because there is no prior chat with the customer. It is necessary to initiate the conversation using a pre-configured and approved WhatsApp template. | 417 | EXPECTATION FAILED | UNABLE TO SEND THE MESSAGE THERE IS NO CHAT WITH THE CUSTOMER | |
| The message cannot be sent because the customer has not responded to a previous message sent. To continue the conversation, the customer must first interact by responding to the initial message. | 417 | EXPECTATION FAILED | UNABLE TO SEND THE MESSAGE THE CLIENT HAS NOT RESPONDED YET | |
| The message cannot be sent because more than 24 hours have passed since the last template was sent to the customer. WhatsApp restricts sending messages outside this period unless a new pre-approved template is used. | 417 | EXPECTATION FAILED | IT WAS NOT POSSIBLE TO SEND THE MESSAGE MORE THAN 24 HOURS HAVE PASSED | |
| The message cannot be sent because the provided phone number has fewer than 7 digits. Make sure to enter a valid number that meets the required format for WhatsApp numbers. | 417 | EXPECTATION FAILED | NUMBER LESS THAN 7 DIGITS | |
| It was not possible to process the message submission due to a database connection issue. This error is temporary; it is recommended to try again later or check the system status. | 417 | EXPECTATION FAILED | UNABLE TO CONNECT | |
| The message cannot be sent because a template has not been used previously to initiate the conversation with the customer. Make sure to send an approved template before attempting to send other messages. | 417 | EXPECTATION FAILED | COULD NOT SEND TEMPLATE | |
| The message cannot be sent because it was not possible to connect to the database to register the necessary information. This error is temporary; it is recommended to try again later or check the system status. | 417 | EXPECTATION FAILED | NO RECORD INSERTED | |
| The message cannot be sent due to a server connection issue. This error may be temporary; it is recommended to try again later or contact technical support if the problem persists. | 417 | EXPECTATION FAILED | MESSAGE COULD NOT BE SENT | |
| The message cannot be sent due to a server connection issue. Additionally, the error indicates that the number of variables provided is incorrect or insufficient. Make sure to include the correct number of variables required by the template and check the connection before trying again. | 417 | EXPECTATION FAILED | NOT SENT MESSAGE: THE NUMBER OF VARIABLES IS: X | |
| The message could not be sent due to a general error. This may be caused by various factors, such as connection or configuration problems. It is recommended to try again later and verify the request parameters before retrying. | 417 | EXPECTATION FAILED | MESSAGE HAS NOT BEEN SENT | |
| SERVER | An internal server error occurred. | 500 | INTERNAL SERVER ERROR | AN UNEXPECTED ERROR OCCURRED |
| SERVER | The server received an invalid response from another server. | 502 | BAD GATEWAY | INVALID RESPONSE FROM UPSTREAM SERVER |
| SERVER | Service wait time exhausted for the request. | 503 | SERVICE UNAVAILABLE | SERVER IS TEMPORARILY UNAVAILABLE |
| TIME | Request timeout. | 504 | GATEWAY TIMEOUT | REQUEST TIMED OUT |
Sao Paulo +55 (11) 521 75 933
Santiago de Chile +56 (2) 240 533 89
Medellín +57 (604) 322 98 80
Ciudad de Guatemala +502 (2) 3141344
Ciudad de México +52 (55) 8526 36 34
Copyright © 2023 MICROSYSLABS. 1820 N Corporate Lakes Blvd, unit 205. Weston, FL 33326
Copyright © 2023 MICROSYSLABS S.A.S.
Cra 30 # 4A – 45 Of. 205 Ed. FOREVER W&L, Medellín, Colombia