Ошибки сообщений

11 апреля 2024

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

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

Ошибки при отправке сообщений

Ошибки после вызова метода 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.Переданный контент для каскада не соответствует настройкам каскада. Примеры с пояснениями смотрите в разделе.
401Auth error.Ошибка авторизации. Проверьте правильность написания и срок действия ключа API.
404Not found.Запрошенный URL-адрес не найден. Проверьте корректность указанного вами адреса.
405Method not allowed.Метод HTTP-запроса не разрешен. Используйте POST, GET и другие запросы согласно документации.
500System 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.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 минут.
In this article
Разделы статьи