Коды ошибок

В этой статье описаны ошибки, которые могут произойти при отправке сообщений или получении статусов сообщений.

Список ошибок может быть расширен. Учитывайте это при настройке интеграции.

Коды ошибок при отправке сообщений

Коды ошибок после вызова метода schedule.

Код ошибкиОшибкаОписание
400RequestId is not uniqueТакой идентификатор запроса уже использовался. Используйте новый идентификатор для каждого запроса.
400Content not specifiedНе указан тип контента и его свойства. Например, smsContent, viberContent или whatsappContent.
400ContentType not specifiedНе указан тип контента. Например, text или image.
400Text not specifiedНе заполнено текстовое поле.
400Caption not specifiedНе заполнено текстовое поле подписи.
400Action not specifiedНе указано действие для кнопки.
400AttachmentName not specifiedНе указано имя прикрепляемого документа.
400AttachmentName is too longИмя прикрепляемого документа слишком длинное. Максимальная длина — 70 символов.
400Latitude not specifiedНе задана широта при указании координат.
400Longitude not specifiedНе задана долгота при указании координат.
400Cascade not foundУказан неверный идентификатор каскада. Запросите список всех каскадов вашего аккаунта и проверьте корректность указанного вами идентификатора.
400Request doesn’t contain content for all cascade stagesКаскад содержит много каналов. Добавьте еще один канал в объект content запроса.
400Matched template not foundСхема тела запроса не соответствует схеме шаблона. Проверьте взаимное расположение и наличие всех свойств запроса.
400Cascade scheduling request is not validПереданный контент для каскада не соответствует настройкам каскада. Программа edna Pulse выполняет дополнительную проверку каскада при поступлении запроса на отправку сообщения методом cascade/schedule.
Если поступивший запрос не соответствует параметрам каскада, возвращается ошибка с пояснениями в поле detail. Прочитайте пояснения, чтобы выявить и устранить несоответствие или отправьте запрос в службу технической поддержки support@edna.ru.
Примеры ошибок с пояснениями смотрите в разделе.
401Auth errorОшибка авторизации. Проверьте правильность написания и срок действия ключа API.
404Not foundЗапрошенный URL-адрес не найден. Проверьте корректность указанного вами адреса.
405Method not allowedМетод HTTP-запроса не разрешен. Используйте POST, GET и другие запросы согласно документации.
500System errorОшибка сервера. Отправьте запрос в службу технической поддержки support@edna.ru. Ошибка может возникать при некорректном запросе. Проверьте взаимное расположение, наличие и заполненность всех свойств запроса согласно документации.

Примеры ошибок при проверке каскада

Пример 1. В объекте content есть параметры канала, которого нет в каскаде

В запросе ниже ошибку вызывает параметр smscontent, так как каскад с cascadeId = 31634 включает в себя только каналы Viber и WhatsApp.

curl --location 'http://app.edna.ru/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.ru/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.ru/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 минут.