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

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

Подробнее о telegram-ботах и их типах – [Direct FAQ](https://faq.docs.direct.i-dgtl.ru/kanaly-otpravki/messendzhery-i-soc.-seti/telegram)

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

<mark style="color:green;">`POST`</mark> `https://direct.i-dgtl.ru/api/v1/telegram/subscriber`

**Headers**

| Name          | Value                                                                 |
| ------------- | --------------------------------------------------------------------- |
| Content-Type  | `application/json`                                                    |
| Authorization | <p><code>Bearer &#x3C;TOKEN></code><br>Подходит токен любого типа</p> |

**Body**

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

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

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

**Response**

::::{tab-set}

:::{tab-item} 200

```json
[
    {
        "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
    }
  ]
}
```