# Bot 2.0 - отправляйте сообщения пользователям вашего чат-бота

## Принципы работы Telegram чат-бота 2.0

Рассылки через Telegram становятся всё более популярными благодаря их эффективности и низкой стоимости по сравнению с другими каналами связи, такими как SMS. Сервис рассылок i-Digital Direct предлагает решение для автоматизации и оптимизации взаимодействия с клиентами, используя Telegram. Если у вас уже есть разработанный чат-бот с реализованной логикой и базой подписчиков, Telegram Bot 2.0 будет идеальным выбором для расширения ваших возможностей.

### Основные возможности и преимущества Telegram Bot 2.0

1. **Экономичность**: Рассылки через Telegram значительно дешевле, чем через другие каналы связи, такие как SMS. Это делает Telegram отличным выбором для бизнеса, стремящегося к оптимизации затрат на коммуникации с клиентами.
2. **Интеграция с вашим существующим чат-ботом и легкая загрузка данных пользователей**: Bot 2.0 идеально подходит для пользователей, у которых уже есть Telegram чат-бот с реализованными сценариями работы и базой подписчиков. Для начала использования Bot 2.0 вам нужно будет загрузить связки пар UserID/Телефон существующих пользователей вашего Telegram чат-бота в систему i-Digital Direct. После этого вы сможете легко и быстро начинать делать рассылки.
3. **Сохранение логики работы чат-бота**: При подключении вашего готового чат-бота к i-Digital Direct его логика работы не нарушается. Это гарантирует, что все функциональные возможности и сценарии взаимодействия, которые были настроены ранее, будут работать без изменений, что исключает необходимость дополнительной настройки.
4. **Возможность каскадных рассылок**: Вы сможете создавать каскадные рассылки, используя несколько каналов, включая Telegram. Если в вашем списке получателей не будет подписчика вашего Telegram чат-бота, сообщение будет доставлено ему следующим каналом, указанном в настройках каскадной рассылки, например SMS. Таким образом, вы обеспечиваете максимальный охват вашей аудитории и надёжность доставки сообщений.&#x20;

### Пример успеха: кейс сети магазинов "Хорошая связь"&#x20;

Для наглядного примера вы можете изучить кейс одного из пользователей i-Digital Direct – сети магазинов "Хорошая связь". Они успешно подключили Telegram чат-бота и использовали возможности каскадных рассылок, чтобы улучшить взаимодействие с аудиторией, обеспечить более гибкий и персонализированный подход к каждому клиенту и таким образом увеличить показатели возврата маркетинговых инвестиций (ROMI). Управление рассылками стало проще, а затраты на коммуникацию значительно снизились. Подробнее об этом кейсе можно прочитать в статье [Рассылка для сети магазинов "Хорошая связь"](https://i-dgtl.ru/cases/rassylki-dlya-horoshej-svyazi/).

## Подключение Telegram чат-бота в Личном кабинете i-Digital Direct

{% hint style="info" %}

* Если у вас еще нет Telegram чат-бота, создайте его по инструкции в разделе [Создание чат-бота в Telegram](/kanaly-otpravki/messendzhery-i-soc.-seti/telegram/upravlenie-chat-botami-v-telegram.md#sozdanie-chat-bota-v-telegram).
* Если у вас уже есть Telegram чат-бот, но вы не помните его API-токен, вы можете найти его по инструкции в разделе [Поиск API Token созданного чат-бота в Telegram](/kanaly-otpravki/messendzhery-i-soc.-seti/telegram/upravlenie-chat-botami-v-telegram.md#poisk-api-token-sozdannogo-chat-bota-v-telegram).
  {% endhint %}

Чтобы подключить существующего чат-бота к вашему Личному кабинету i-Digital Direct, выполните следующие шаги:

1. В левом меню Личного кабинета выберите пункт **Настройки** и выберите раздел **Боты Telegram.**

<figure><img src="/files/ulKYqvfgShZ98GRu1Qiw" alt=""><figcaption></figcaption></figure>

2. На открывшейся странице нажмите кнопку **Добавить**.

<figure><img src="/files/vG4fRxzGMlKJFMchToxC" alt=""><figcaption></figcaption></figure>

3. В открывшемся диалоговом окне в поле **Тип** выставите значение 2.0, в поле **Telegram API-токен** вставьте **token**, полученный при создании Telegram чат-бота.
4. Нажмите кнопку **Добавить**.

   <figure><img src="/files/qjxCnvMYlIRjyFmLrpuJ" alt="" width="375"><figcaption></figcaption></figure>

<br>

5. В открывшемся диалоговом окне нажмите на кнопку **Прикрепить**, чтобы загрузить файл со связками UserID/Телефон пользователей вашего бота.

<figure><img src="/files/iDjLmX4tUK5RmHoBKrhK" alt="" width="563"><figcaption></figcaption></figure>

6. В следующем окне настройте соответствие полей в вашем файле с импортируемыми данными (Телефон и Telegram ID).

<figure><img src="/files/rAiRXUUJdLKsGKlmuN7e" alt="" width="563"><figcaption></figcaption></figure>

7. Нажмите кнопку **Импорт**.

После этого ваш Telegram чат-бот будет подключен к личному кабинету i-Digital Direct и отобразится в разделе [Telegram-боты](https://direct.i-dgtl.ru/settings/telegram) в настройках.

<figure><img src="/files/8M8WVdO2jcc9bJOQNJuc" alt=""><figcaption></figcaption></figure>

Пользователи вашего Telegram чат-бота будут загружены в раздел [Получатели ](https://direct.i-dgtl.ru/recipients)в Личном кабинете i-Digital Direct. Для них автоматически будет создан отдельный сегмент c именем подключенного чат-бота. Подробнее о работе с сегментами вы можете прочитать в статье [Как работать с сегментами?](/rabota-s-rassylkami/rabota-s-bazoi-abonentov/kak-rabotat-s-segmentami.md).

<figure><img src="/files/MNC7FkrUYKnzlObikIvI" alt=""><figcaption></figcaption></figure>

## Запуск Telegram-рассылки

После того, как вы подключите Telegram чат-бота в Личном кабинете i-Digital Direct и загрузите связки UserID/Телефон пользователей вашего бота, вы сможете делать Telegram-рассылки из Личного кабинета или через API. Подробные инструкции как это сделать читайте в следующих статьях:

* [Запуск Telegram-рассылки из Личного кабинета](/kanaly-otpravki/messendzhery-i-soc.-seti/telegram/zapusk-telegram-rassylki-iz-lichnogo-kabineta.md)
* [Запуск Telegram-рассылки через API](/kanaly-otpravki/messendzhery-i-soc.-seti/telegram/zapusk-telegram-rassylki-cherez-api.md)

## Загрузка дополнительных получателей к Telegram чат-боту

После первоначального подключения Telegram чат-бота и загрузки связок UserID/Телефон пользователей вашего бота вы можете загрузить дополнительных пользователей через Личный кабинет i-Digital Direct или через API.

### Загрузка дополнительных получателей через Личный кабинет

1. В левом меню Личного кабинета выберите пункт **Получатели** и перейдите на вкладку **Сегменты**.
2. Найдите название бота, к которому хотите загрузить пользователей, и нажмите на **три точки** в конце строки с ним.
3. Выберите пункт **Загрузить связку**.

<figure><img src="/files/a7JJtCo3mE8CmAwNdBwa" alt=""><figcaption></figcaption></figure>

4. Повторите шаги инструкции по [подключению Telegram чат-бота](#podklyuchenie-telegram-chat-bota-v-lichnom-kabinete-i-digital-direct), начиная с **шага 5**.

### Загрузка дополнительных получателей через API

Чтобы загрузить дополнительных пользователей к Telegram чат-боту через API, выполните следующие шаги:

1. Создайте API-ключ в Личном кабинете i-Digital Direct с методом **Отправка сообщений и рассылок, получение статистики.** Подробную инструкцию смотрите в разделе [Генерация API-ключа для рассылок](/kanaly-otpravki/messendzhery-i-soc.-seti/telegram/zapusk-telegram-rassylki-cherez-api.md#generaciya-api-klyucha-dlya-rassylok).
2. Отправьте HTTP запрос к нашему API на загрузку Telegram-абонентов вашего бота в соответствующий сегмент абонентов в Личном кабинете. Подробное описание метода смотрите в API-документации в разделе [Загрузка абонентов для Telegram Bot 2.0](https://api.docs.direct.i-dgtl.ru/recipients/telegram_bot_2).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://faq.docs.direct.i-dgtl.ru/kanaly-otpravki/messendzhery-i-soc.-seti/telegram/bot-2.0-otpravlyaite-soobsheniya-polzovatelyam-vashego-chat-bota.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
