В этой статье описаны ошибки, которые могут произойти в следующих случаях:
- отправка сообщений;
- проверка каскада;
- получение статусов сообщений.
Список ошибок может быть расширен. Учитывайте это при настройке интеграции.
Ошибки при отправке сообщений
Ошибки после вызова метода schedule
. Подробнее про метод смотрите в статье.
Код ошибки | Ошибка | Описание |
400 | RequestId is not unique. | Такой идентификатор запроса уже использовался. Используйте новый идентификатор для каждого запроса. |
400 | Content not specified. | Не указан тип контента и его свойства. Например, smsContent , viberContent или whatsappContent . |
400 | ContentType not specified. | Не указан тип контента. Например, text или image . |
400 | Text not specified. | Не заполнено текстовое поле. |
400 | Caption not specified. | Не заполнено текстовое поле подписи. |
400 | Action not specified. | Не указано действие для кнопки. |
400 | AttachmentName not specified. | Не указано имя прикрепляемого документа. |
400 | AttachmentName is too long. | Имя прикрепляемого документа слишком длинное. Максимальная длина — 70 символов. |
400 | Latitude not specified. | Не задана широта при указании координат. |
400 | Longitude not specified. | Не задана долгота при указании координат. |
400 | Cascade not found. | Указан неверный идентификатор каскада. Запросите список всех каскадов вашего аккаунта и проверьте корректность указанного вами идентификатора. |
400 | Request doesn’t contain content for all cascade stages. | Каскад содержит много каналов. Добавьте еще один канал в объект content запроса. |
400 | Matched template not found. | Схема тела запроса не соответствует схеме шаблона. Проверьте взаимное расположение и наличие всех свойств запроса. |
400 | Cascade scheduling request is not valid. | Переданный контент для каскада не соответствует настройкам каскада. Примеры с пояснениями смотрите в разделе. |
401 | Auth error. | Ошибка авторизации. Проверьте правильность написания и срок действия ключа API. |
404 | Not found. | Запрошенный URL-адрес не найден. Проверьте корректность указанного вами адреса. |
405 | Method not allowed. | Метод HTTP-запроса не разрешен. Используйте POST, GET и другие запросы согласно документации. |
500 | System error. | Ошибка сервера. Отправьте запрос в службу технической поддержки support@edna.ru. Ошибка может возникать при некорректном запросе. Проверьте взаимное расположение, наличие и заполненность всех свойств запроса согласно документации. |
Ошибки при проверке каскада
Код ошибки | Ошибка | Описание |
400 | Сascade scheduling request not valid. | Программа edna Pulse выполняет дополнительную проверку каскада при поступлении запроса на отправку сообщения методом cascade/schedule .Если поступивший запрос не соответствует параметрам каскада, возвращается ошибка с пояснениями в поле detail . Прочитайте пояснения, чтобы выявить и устранить несоответствие или отправьте запрос в службу технической поддержки support@edna.ru. |
Формат ответа
{ "title": "cascade-scheduling-request-not-valid", "status": 400, "detail": "<Пояснения>" }
Примеры ошибок при проверке каскада
Пример 1. В объекте
content
есть параметры канала, которого нет в каскаде.
В запросе ниже ошибку вызывает параметр smscontent
, так как каскад с cascadeId
= 31634 включает в себя только каналы Viber и WhatsApp.
curl --location 'http://app.edna.io/api/cascade/schedule' \ --header 'Content-Type: application/json' \ --header 'x-api-key: ************' \ --data '{ "requestId": "e62b4736-1278-4119-8816-3f2257eec47c", "cascadeId": 31634, "subscriberFilter": { "address": "+70000000000", "type": "PHONE" }, "content": { "viberContent": { "contentType": "TEXT", "text": "cascade viber --> whatsapp " }, "whatsappContent": { "contentType": "TEXT", "text": "cascade viber --> whatsapp" }, "smsContent": { "contentType": "TEXT", "text": "cascade viber --> whatsapp" } } }'
Ответ:
{ "title": "cascade-scheduling-request-not-valid", "status": 400, "detail": "Cascade scheduling request is not valid. Violations: the cascade template stage was not found for the content [cascadeTemplateId:31,634;contentChannelType:SMS]" }
Пример 2. В объекте
content
нет параметров канала, который есть в каскаде.
В запросе ниже передается только параметр viberContent
, хотя каскад с cascadeId
= 31634 включает в себя каналы Viber и WhAtsapp.
curl --location 'http://app.edna.io/api/cascade/schedule' \ --header 'Content-Type: application/json' \ --header 'x-api-key: ****************' \ --data '{ "requestId": "7c42344c-aeea-41c9-834b-eb627136f400", "cascadeId": 31634, "subscriberFilter": { "address": "+70000000999", "type": "PHONE" }, "content": { "viberContent": { "contentType": "TEXT", "text": "cascade viber --> whatsapp. No whatsapp content" } } }'
Ответ:
{ "title": "cascade-scheduling-request-not-valid", "status": 400, "detail": "Cascade scheduling request is not valid. Violations: the content was not found for the cascade template stage [cascadeTemplateId:31,634;stageUuid:6467a97d-c0b5-486b-9f94-733297b668de;channelType:WHATSAPP]" }
Пример 3. В объекте
content
нет параметров канала, которого нет в каскаде, и нет параметров канала, который есть в каскаде.
В запросе ниже передаются параметр viberContent
и smsContent
, хотя каскад с cascadeId
= 31634 включает в себя каналы Viber и WhatsApp.
curl --location 'http://app.edna.io/api/cascade/schedule' \ --header 'Content-Type: application/json' \ --header 'x-api-key: **********' \ --data '{ "requestId": "8bcb602f-ce61-4bce-a021-5dc52125a194", "cascadeId": 31634, "subscriberFilter": { "address": "+70000008000", "type": "PHONE" }, "content": { "viberContent": { "contentType": "TEXT", "text": "cascade viber --> whatsapp. No whatsapp content" }, "smsContent": { "contentType": "TEXT", "text": "cascade viber --> whatsapp. No whatsapp content" } } }'
Ответ:
{ "title": "cascade-scheduling-request-not-valid", "status": 400, "detail": "Cascade scheduling request is not valid. Violations: the content was not found for the cascade template stage [cascadeTemplateId:31,634;stageUuid:6467a97d-c0b5-486b-9f94-733297b668de;channelType:WHATSAPP]; the cascade template stage was not found for the content [cascadeTemplateId:31,634;contentChannelType:SMS]" }
Ошибки при получении статусов сообщений
Ошибки при неуспешной доставке сообщений и получении статуса undelivered
. Подробнее про получение статусов сообщений смотрите в статье.
Ошибка | Описание |
Not WhatsApp user. | Указанный получатель не зарегистрирован в WhatsApp. Только для канала WhatsApp. |
No match template. | Сообщение не соответствует допустимому шаблону. |
Session not started. | Ошибка начала сессии. |
Daily rate limit. | Превышен суточный лимит WhatsApp на отправку шаблонных сообщений. Только для канала WhatsApp. |
Too long message. | Длина сообщения превышает допустимый лимит. |
Chat window closed. | Ошибка открытия диалогового окна на стороне WhatsApp. Только для канала WhatsApp. |
Media request failed. | Ошибка загрузки файла. |
Error subject unknown. | Указанная подпись не разрешена клиенту. Необходимо предварительно активировать все подписи. |
Error address format. | Неправильный формат номера абонента. |
Duplicated. | Попытка отправки дубликата сообщения в течение 5 минут. |