GetList

Метод GetList

Примените этот метод для получения списка созданных рассылок по заданным параметрам (если параметры не заданы, выводятся все созданные рассылки). Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/campaign/v1/GetList

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

ПараметрТипОписание
campaign_typeenum CampaignTypeтип (канла) рассылки
campaign_iduint64идентификатор рассылки
namestringнаименование рассылки
statusenum CampaignStatusстатус рассылки
date_fromstringдата создания рассылки в формате RFC-3339 / ISO-8601, от которой начинать выборку
date_tostringдата создания рассылки в формате RFC-3339 / ISO-8601, до которой продолжать выборку

CampaignType

ПараметрТипОписание
1enumтекстовые SMS
2enumголосовые SMS
3enumкаскадная рассылка

CampaignStatus

ПараметрТипОписание
1enumчерновик
2enumрассылка остановлена пользователем
3enumрассылка остановлена из-за нехватки баланса
4enumрассылка в процессе выполнения
5enumрассылка завершена

Выходные параметры

ПараметрТипОписание
itemsCampaignItemсписок найденных рассылок

CampaignItem

ПараметрТипОписание
iduint64идентификатор рассылки
namestringнаименование рассылки
scenario_idstringидентификатор сценария
call_list_iduint64идентификатор списка получателей
call_list_totaluint64количество записей в списке получателей
timezonebooleanпараметр учёта часового пояса. По умолчанию False — рассылка отправляется по московскому времени (UTC+3), True — учитывать часовой пояс, указанный в CallList
typeenum CampaignTypeтип рассылки (канал рассылки)
statusenum CampaignStatusстатус рассылки
created_atдата создания рассылки в формате RFC-3339 / ISO-8601
oneof Channelодин из каналов рассылки (текстовое SMS, голосовое SMS или каскадная рассылка)

Channel

ПараметрТипОписание
smsSmsканал рассылки — текстовое SMS
voice_messageVoiceMessageканал рассылки — голосовое SMS
cascadeCascadeкаскадная рассылка (последовательное уведомление абонентов в разных каналах)

Sms

ПараметрТипОписание
propsSmsPropsатрибуты сценария текстового SMS

SmsProps

ПараметрТипОписание
alpha_namestringимя отправителя (альфа-имя), от которого отправляются текстовые SMS
textstringтекст сообщения

VoiceMessage

ПараметрТипОписание
propsVoiceMessagePropsатрибуты сценария голосового SMS

VoiceMessageProps

ПараметрТипОписание
voice_message_idstringидентификатор ресурса голосового SMS
fromstringномер телефона МТС Exolve, с которого отправляются голосовые SMS

Cascade

ПараметрТипОписание
elementsCascadeElementструктура каскадной рассылки. Один элемент — один канал рассылки (текстовое или голосовое SMS)

CascadeElement

ПараметрТипОписание
smsSmsканал рассылки - текстовое SMS
voice_messageVoiceMessageChannelканал рассылки — голосовое SMS
conditionenum Conditionусловие перехода к следующему каналу рассылки

SmsChannel

ПараметрТипОписание
propsSmsPropsатрибуты сценария текстового SMS
ttlstringпериод времени, по истечении которого будет запрошен статус SMS (от 10 до 300 секунд)

VoiceMessageChannel

ПараметрТипОписание
propsVoiceMessagePropsатрибуты сценария голосового SMS

Condition

ПараметрТипОписание
1enumзвонок не принят/сSMSмс не доставлено
2enumзвонок принят/SMS доставлено
3enumв любом случае

Возможные ошибки

КодСтатусПример сообщенияОписание
404Not FoundNot Foundнекорректный URL-адрес запроса
401Unauthorizedinvalid tokenневалидный API-ключ
400Bad Requesttoken is emptyв запросе не передан API-ключ
400Bad Requestcouldn’t parse incoming jwt token: couldn’t parse token: invalid character ‘[character]’ looking for beginning of valueневалидный API-ключ
400Bad Requestinvalid character ‘[character]’ looking for beginning of valueневалидное или пустое значение в одном из полей
400Bad Requestinvalid value for uint64 type: ‘[value]’невалидное или пустое значение в одном из полей с типом uint64
400Bad Requestinvalid character " after object key:value pairв запросе пропущена запятая в одном из параметров

Примеры

Входные параметры:

{
    "date_from" : "2023-12-01T12:40:23.832213Z",
    "date_to" : "2023-12-28T15:40:23.832213Z"
}

Выходные параметры:

{
    "items": [
        // Текстовая SMS рассылка
        {
            "id": "130366147371216896",
            "name": "SMS Campaign",
            "scenario_id": "e1b9ae25-f36c-44b8-a327-ac46d414e180",
            "call_list_id": "130366147266359296",
            "timezone": true,
            "type": "1",
            "status": "1",
            "created_at": "2023-12-26T17:48:31.619796Z",
            "sms": {
                "props": {
                    "alpha_name": "SHOP",
                    "text": "Приходите к нам!"
                }
            }
        },
        // Голосовая SMS рассылка
        {
            "id": "130334219200901120",
            "name": "Voice Message Campaign",
            "scenario_id": "bb33e01b-9ec3-4d44-955c-c4cac2d23971",
            "call_list_id": "130334219041517568",
            "timezone": true,
            "type": "CAMPAIGN_TYPE_VOICE",
            "status": "CAMPAIGN_STATUS_IS_STOP",
            "created_at": "2023-12-26T15:41:39.350391Z",
            "voice_message": {
                "props": {
                    "voice_message_id": "41117356-c9d5-4c94-8c62-68d7d2dac285",
                    "from": "79991112233"
                }
            }
        },
        // Каскадная рассылка
        {
            "id": "130369523110653952",
            "name": "Cascade",
            "scenario_id": "a466b60e-ca5a-4da8-b60c-bc9cb9e6fd8a",
            "call_list_id": "130369523102265344",
            "type": "CAMPAIGN_TYPE_CASCADE",
            "status": "CAMPAIGN_STATUS_IS_RUN",
            "created_at": "2023-12-26T18:01:56.458047Z",
            "cascade": {
                "elements": [
                    {
                        "sms": {
                            "props": {
                                "alpha_name": "Shop",
                                "text": "Скидка 10% на все товары!"
                            },
                            "ttl": "10s"
                        },
                        "condition": "1"
                    },
                    {
                        "voice_message": {
                            "props": {
                                "voice_message_id": "353b86e0-a62c-47d4-9b94-8dba32c922fc",
                                "from": "79998889900"
                            }
                        }
                    }
                ]
            }
        }
    ]
}