﻿# TelegramBot

> [HTML Version](telegrambot.html)

Вы можете связать с линией TelegramBot, чтобы клиенты и партнёры могли отправлять свои обращения через мессенджер и получать ответ, сформированный в интерфейсе ELMA365 чат-ботом или оператором. 

Для определения логики ответов чат-бота используется low-code конструктор [ELMA Bot](elma-bot.md). Если ELMA Bot не подключён к линии, обрабатывать обращения, пришедшие из TelegramBot, будут операторы. Чтобы использовать ELMA Bot, активируйте его.

При получении сообщения из TelegramBot в разделе [Линии](chat_lines.md) будет создана новая сессия. Если клиент уже обращался, предыдущая сессия возобновится, и сообщение отобразится в ней. Подключённый к линии чат-бот сможет распознать запрос пользователя и отреагировать на него в соответствии с настроенными [сценариями](bot-scripts.md). Определение ответов будет происходить на стороне сервиса ELMA Bot. При этом история переписки с ботом будет отображаться в сессии в разделе **Линии**. 

На случай, если запрос пользователя невозможно решить без участия человека, внутри сценариев бота следует предусмотреть [перевод на оператора](transfer-to-operator.md). В этом случае бот отключится, и операторы смогут взять сессию в работу и [обработать обращение](working_in_chat.md) из интерфейса ELMA365. 

В подключённом TelegramBot операторы могут самостоятельно [создавать новые сессии](create-session.md) только с ранее обратившимися пользователями. 

````
начало внимание

````
Настраивать интеграции с мессенджерами могут только пользователи, входящие в группу [Администраторы](360006871932.md#administrators).

````
конец внимание

## ````
Подключить TelegramBot

Для одной линии можно настроить интеграции с несколькими доступными мессенджерами. Каждый аккаунт TelegramBot можно связать только с одной линией.

Обратите внимание, для интеграции линии с TelegramBot необходимо настроить HTTPS‑подключение. 

Чтобы подключить к линии мессенджер TelegramBot:

1. Перейдите в раздел **Администрирование > Линии**. 

2. Выберите линию из списка или [создайте новую](create_line.md), нажав кнопку **+ Линия** в правом верхнем углу.

3. Перейдите на вкладку **Мессенджеры и почта** и нажмите кнопку **(telegrambot_button.png)**.

4. В открывшемся окне заполните поля:

**(connect_telegrambot-1.png)**

- **Название\*** — введите название канала;

- **Токен\*** — вставьте секретный токен, полученный при создании бота в Telegram;

- **Публичный адрес компании\*** — укажите адрес, по которому TelegramBot обращается к системе для передачи данных. По умолчанию в поле подставляется адрес вашей компании ELMA365;

- **Использовать Inline кнопки **— активируйте опцию, чтобы в диалоге с ботом настроенные пункты меню с вариантами ответа отправлялись пользователю в виде сообщения. При отключённой настройке они располагаются под полем для ввода текста.

5. Нажмите кнопку **Подключить**.

После прохождения процедуры верификации TelegramBot будет связан с линией.

**(connect_telegrambot-2.png)**

Теперь на вкладке **Мессенджеры и почта** вы можете:

- временно отключить канал — нажмите напротив его названия переключатель (on_button.png). Статус изменится с **Активен** на **Разорван**. Для восстановления подключения повторно используйте этот переключатель;

- изменить название канала и отображение пунктов меню в диалоге с ботом — нажмите напротив него значок карандаша;

- безвозвратно удалить мессенджер из настроек линии — нажмите значок корзины.

Подробнее об управлении подключённым каналом читайте в статьях:

- [«Удалить мессенджер или почту из линии»](delete-channel.md);

- [«Восстановить соединение с мессенджером или почтой»](reconnect-channel.md).