# Модуль интеграции с Telegram-ботом для рассылок из карт коммуникаций

> [HTML Version](telegram-for-journey-maps.html)

В рамках исполнения сценариев [карт коммуникаций](customer-journey-maps.md) можно отправлять рассылки в мессенджер Telegram. Сообщения будут приходить клиентам в персональные чаты с Telegram-ботом. 

Для этого [администратор системы](360006871932.md#administrators) устанавливает решение **Telegram**. В его состав входит модуль **Telegram** для настройки интеграции с чат-ботом. 

````
Начало внимание

````
Работа с картами коммуникаций доступна только в поставке ELMA365 On‑Premises.

````
Конец внимание

````
Используя решение **Telegram**, вы можете:

- выполнять триггерные рассылки, созданные в разделе **Карты коммуникаций**, с помощью блока [Мессенджер](newsletters-in-journey-maps.md#messenger);

- формировать статистические данные о рассылках в отчёте [Вовлечённость](marketing-report.md).

Обратите внимание, нужно использовать разных ботов для работы с рассылками через модуль **Telegram**, сервис [Sendsay](sendsay.md#telegram) и в разделе [Линии](telegrambot.md). 

## Настроить интеграцию с Telegram-ботом

1. В мессенджере Telegram перейдите в чат с официальным бот-аккаунтом **@BotFather** и задайте команду **/start**. Создайте бота, следуя инструкции, и скопируйте полученный токен. 

2. В ELMA365 перейдите в раздел **Администрирование** **> Решения** и в правом верхнем углу нажмите кнопку **+** **Решение**. Установите решение **Telegram** из [официального каталога ELMA365 Store](https://store.elma365.ru/component/telegram-841).

3. В состав решения входит модуль **Telegram**. С его помощью настройте интеграцию с чат-ботом. Для этого перейдите в раздел **Администрирование > Модули**. Откройте карточку модуля и нажмите **+** **Бот**.

4. В открывшемся окне введите название бота, которое будет отображаться на странице и в блоке **Мессенджер** карт коммуникаций, вставьте токен, скопированный на первом шаге. Нажмите кнопку **Добавить**.   
(telegram-for-journey-maps-1.png)

5. Напротив названия бота нажмите значок шестерёнки. В открывшемся окне вы можете задать:

- шаблон письма для клиентов с кодом подтверждения подписки на чат-бота — выберите нужную запись из раздела [Маркетинг > Шаблоны писем](templates.md).  
  
Обратите внимание, в шаблон с помощью [персонализации](templates.md#personalization) нужно добавить переменную **Код подтверждения**. При отправке письма на электронную почту клиента в переменную запишется код для активации подписки на чат с ботом;

- реакции бота на команды — в поле для каждой команды введите текст. Например, в качестве ответа на неизвестную команду бот может предложить клиенту обратиться в канал техподдержки.   
  
Сохраните настройки. 

6. Нажмите **+ Вебхук для отладки** и в появившемся поле укажите URL-адрес, куда будут поступать сообщения об ошибках в работе модуля. 

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

После этого вы можете указать бота при создании сценария карты коммуникаций в блоке **Мессенджер**. 

Для триггерных рассылок можно подключить нескольких ботов. 

## Как клиенту получить рассылку в Telegram

Чтобы клиент получил сообщение из триггерной рассылки в мессенджер Telegram, ему нужно подписаться на чат с ботом. 

Для этого:

1. Передайте клиенту ссылку на чат-бота, например, отправив письмо-приглашение по электронной почте. 

2. В чате клиент пишет команду **/start**. Бот присылает приветственное сообщение и просит указать электронную почту для отправки проверочного кода. Адрес почты должен совпадать с адресом, указанным в карточке [контакта](360012584960.md). 

3. После отправки кода подтверждения клиент получит от бота сообщение о подписке. 

Теперь клиент может получать письма из триггерной рассылки в Telegram-чат с ботом. 

Чтобы отписаться от рассылки, клиент вводит в чате с ботом команду **/stop**. Для повторной подписки — команду **/start**, при этом снова указывать код подтверждения не нужно.