Загрузка абонентов для Telegram Bot 2.0

Запрос позволяет добавить telegram-абонентов вашего бота в соответствующий сегмент абонентов в ЛК для дальнейшей отправки рассылок. Необходимо, чтобы telegram-бот был создан в ЛК с типом 2.0.

Подробнее о telegram-ботах и их типах – Direct FAQ

Загрузка абонентов для отправки Telegram

POST https://direct.i-dgtl.ru/api/v1/telegram/subscriber

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <TOKEN> Подходит токен любого типа

Body

Name	Type	Description
botUsername	string	Username вашего telegram-бота типа 2.0
subscribers	array of objects	Массив объектов телеграм--абонентов

Объект телеграм-абонента

Name	Type	Description
msisdn	string	Номер телефона абонента
chatId	integer	Идентификатор абонента в Telegram от вашего бота

Response

200

[
    {
        "msisdn": "79099349978",
        "chatId": 6975384182,
        "status": "ADDED"
    },
    {
        "msisdn": "79219347938",
        "chatId": 42,
        "status": "MSISDN_UPDATED"
    },
    {
        "msisdn": "79119348962",
        "chatId": 32,
        "status": "DUPLICATE"
    }
]

В случае ответа с кодом 200 возвращается массив с данными по переданным абонентам, в каждый объект добавлен статус операции – status

status	описание
ADDED	абонент добавлен
MSISDN_UPDATED	для абонента с данным chatId изменен msisdn
DUPLICATE	дубликат
BOTUSERNAME_DOES_NOT_EXIST	бот с указанным юзернеймом не найден – в таком случае все абоненты будут иметь данный статус

Пример объекта запроса

{
  "botUsername": "company_bot",
  "subscribers": [
    {
      "msisdn": "79099349978",
      "chatId": 6975384182
    },
    {
      "msisdn": "79219347938",
      "chatId": 6975384181
    },
    {
      "msisdn": "79119348962",
      "chatId": 69753841123
    }
  ]
}