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

Содержание

Загрузка абонентов для 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
    }
  ]
}