Стандартные ошибки#
HTTP Ошибки#
| Код HTTP | Идентификатор ошибки | Описание |
|---|---|---|
| 204 | No Content | Использован метод запроса OPTIONS, измените метод запроса на GET |
| 400 | instance in starting process try later | Инстанс находится в процессе запуска/перезапуска. Попробуйте повторить попытку спустя несколько секунд |
| 400 | instance is starting or not authorized | Инстанс не авторизован. Для авторизации инстанса перейдите в личный кабинет и считайте QR-код из приложения WhatsApp Business на телефоне |
| 400 | Instance account is expired. Renew your instance from personal area | Срок действия инстанса истек. Продлите свой инстанс из личного кабинета |
| 400 | bad request data | Данные запроса не валидны. Исправьте ошибку в параметрах запроса и повторите попытку |
| 400 | Instance is deleted | Инстанс был удалён |
| 400 | Bad Request Validation failed | Ошибка валидации, подробнее в таблице |
| 400 | Validation failed. Details: 'chatId' is required | Обязательный параметр chatId идентификатор чата не указан. |
| 400 | Unexpected token _ in JSON at position ХХ | Ошибка в структуре JSON |
| 401 | Unauthorized | Проблема с авторизацией, проверьте корректность указания apiTokenInstance, partnerToken |
| 403 | Forbidden | Проблема с аутентификацией, проверьте корректность указания idInstance и адрес запроса |
| 404 | Not Found | Некорректный метод запроса |
| 429 | Too Many Requests | Пользователь отправил слишком много запросов за заданный промежуток времени. Уменьшите частоту запросов. Рекомендации по частоте запросов |
| 466 | correspondentsStatus | Исчерпан лимит, подробнее в теле ошибки. Пример тела ошибки |
| 499 | Client Closed Request | Пользователь закрыл соединение, пока сервер обрабатывал запрос. Требуется увеличить время ожидания ответа от сервера и повторить запрос с задержкой. Если ошибка повториться, то информировать оператора и дать возможность повторить отправку |
| 500 | File from url exceeded max upload size. Size: XXXXmb Limit: 100mb Url: | Попытка отправки файла размером более 100 МБайт |
| 500 | request entity too large | Превышение допустимой длины json (>100кб) |
| 502 | Bad Gateway | Сервер не способен получить ответ от целевого сервера. Требуется 3 раза повторить запрос с задержкой. Если ошибка повторится, то информировать оператора и дать возможность повторить отправку |
Ошибки в теле уведомлений и журналах#
| Код Ошибки | Поле | Описание | Решение |
|---|---|---|---|
| {{SWE001}} | textMessage | Ошибка получения первого входящего сообщения в чате при отправке на дополнительные устройства со стороны WhatsApp, наблюдается так же в нативных веб и десктоп версии. Фактически на все дополнительные устройства сообщение приходит пустое. Пример тела уведомления | Отлавливать текст-маркер {{SWE001}} в теле сообщения и настроить бота на повторный запрос сообщения у отправителя с текстом: "Пожалуйста, отправьте сообщение еще раз, я не смогла увидеть ваш ответ" |
| {{SWE002}} | downloadUrl | Ошибка получения большого файла более 100 МБайт. Пример тела уведомления | Отлавливать текст-маркер {{SWE002}} в теле сообщения и проверить сообщение в телефоне |
| {{SWE003}} | textMessage | Ошибка расшифровки сообщений, вызванная потерей актуальности ключей авторизации. Пример тела уведомления | Отлавливать текст-маркер {{SWE003}}. При появлении таких сообщений необходимо удалить все авторизации в телефоне и заново считать QR - код |
| {{SWE004}} | textMessage | Ошибка работы с групповыми чатами, вызванная превышением состава участников 1024 контактов в группе. Пример тела уведомления | Отлавливать текст-маркер {{SWE004}}. При появлении таких сообщений необходимо удалить группы, в которых количество участников превышает 1024 контактов или удалить контакты из групп |
| {{SWE999}} | textMessage | Ошибка получения входящего сообщения без ключей шифрования в чате со стороны WhatsApp. Фактически на все дополнительные устройства сообщение приходит пустое. Пример тела уведомления | Отлавливать текст-маркер {{SWE999}} в теле сообщения и настроить бота на повторный запрос сообщения у отправителя с текстом: "Пожалуйста, отправьте сообщение еще раз, я не смогла увидеть ваш ответ" |
Ошибки валидации (400: Validation failed)#
| Идентификатор ошибки | Описание |
|---|---|
'chatId' must be one of the next formats: 'phone_number@c.us' or 'group_id@g.us | Неверный формат поля chatId, поле указывается в формате phone_number@c.us либо group_id@g.us |
'wrongFieldName' is not allowed | Недопустимое поле в теле запроса |
'{{field}}' is not allowed | Недопустимое поле в теле запроса |
'{{field}}' is required | Отсутствует обязательное поле в теле запроса |
'{{field}}' is not allowed to be empty | Обязательное поле не может быть пустым |
'message id' must be at least 16 symbols | iD цитируемого сообщения должно быть не меньше 16 символов, проверьте правильность указанного idmessage или quotedMessageId |
'XXX' must be a string | Неверный тип данных поля XXX - поле должно быть типа string. Поля данного типа: message, idMessage,quotedMessageId, groupId, groupName, participantChatId, options[X].optionName, urlFile |
'XXX' must be a boolean | Неверный тип данных поля XXX - поле должно быть типа boolean. Поля данного типа: linkPreview, multipleAnswers |
'XXX' must be an array | Неверный тип данных поля XXX - поле должно быть типа array. Поля данного типа: chatIds, options, messages |
