# Telegram

[Telegram](https://telegram.org/) появился в 2013 году и вскоре завоевал заслуженную популярность как один из наиболее безопасных, быстрых и удобных мессенджеров. Сервис онлайн-консультирования **Webim** поддерживает возможность интеграции с **Telegram** на уровне каналов общения (communication channels).

## Зачем нужна интеграция

Используя интеграцию сервисов **Telegram** и **Webim**, можно создать бот в мессенджере **Telegram**, который будет представлять Вашу организацию в этом сервисе, а все диалоги, которые Ваши пользователи ведут с ним, будут отображаться и обслуживаться операторами и администраторами в привычной **Панели управления Webim**.

Таким образом, те клиенты, которые предпочитают использовать мессенджер **Telegram**, добавят новый контакт в адресной книге и продолжат использовать привычный и комфортный для них коммуникатор, а Вашим операторам не придётся параллельно мониторить чаты в сервисах **Telegram** и **Webim**, все диалоги будут попадать в общую очередь и в общий интерфейс.

## Инструкция по настройке

Чтобы включить интеграцию c **Telegram** на Вашем аккаунте **Webim**, выполните следующие шаги:

  1. Убедитесь, что Вы являетесь зарегистрированным пользователем Telegram. Если нет, то скачайте клиентское приложение (или зайдите в [веб-версию Telegram](https://web.telegram.org/)).

  1. Сначала нужно создать бот **Telegram** для своего проекта, с которым будут общаться Ваши клиенты. У **Telegram** есть подробная [инструкция по созданию бота](https://core.telegram.org/bots#3-how-do-i-create-a-bot). Здесь мы лишь перечисляем действия, необходимые для настройки интеграции. Вы можете использовать инструкцию **Telegram** для получения дополнительной информации.

  1. Откройте приложение **Telegram** и наберите `BotFather` в строке поиска.

  1. Сервис найдёт **BotFather**. Выберите его в списке результатов поиска, чтобы начать общение с ним.

  1. Когда откроется экран чата с **BotFather**, нажмите **Запустить** внизу окна приложения.

  1. **BotFather** пришлёт приветственное сообщение. Чтобы создать бот, используйте команду `/newbot`.

  1. **BotFather** запросит имя бота. Особых требований к имени бота нет, но учтите, что под этим именем бота будут видеть все пользователи!

  1. Далее введите короткое имя (`Username`) бота. Требования: от 5 до 32 символов, принимаются латиница, цифры и знак подчёркивания. Невосприимчиво к регистру. На конце обязательно должно быть слово "bot".

  1. **BotFather** проверит ввод и, если всё корректно и имя не занято, создаст бот. Вам **BotFather** пришлёт сообщение, в котором будут две важные вещи: ссылка для доступа к боту и токен для работы с ботом по Telegram API:

    ![Создание бота и получение его токена API](https://webim.ru/kb/11.0/img/channels/social-network-messengers/telegram/bot-creating-1.webp){ style="width: 811px; max-width: 100%" }

  1. Скопируйте полученный токен в буфер обмена. Мы рекомендуем сохранить токен в надёжном месте, защищённом от доступа посторонних.

    ??? Note "Групповые чаты"
        Бот можно использовать в группах. Приём включается в форме канала, блок **Групповые чаты**. Пока он выключен, бот сообщения групп не обрабатывает. Чек-бокс **Выходить из групп, в которые добавили бота** заставляет бота покидать такую группу.

        Пока приём выключен, в BotFather можно дополнительно запретить добавление бота в группы: `/mybots` → нужный бот → **Bot Settings** → **Allow Groups** → **Turn groups off**.

  1. Перейдите в [Панель управления сервиса Webim](https://login.webim.ru).

  1. В левом меню откройте **Настройки** → **Каналы общения**. В списке есть группа **Telegram**.

  1. Если в этом разделе отображается сообщение **Недоступно на Вашем тарифе**, то это означает, что функциональность каналов общения **Telegram** ещё не включена в Вашей конфигурации. Нажмите кнопку **Заказать**.

  1. Когда функциональность будет подключена, в группе **Telegram** нажмите **Добавить**. Откроется форма **Добавление Telegram-бота**.

    * В поле **Название канала** введите имя, под которым канал будет виден оператору.

    * Вставьте токен из буфера обмена в поле **Токен авторизации бота**.

    * В поле **Ответное сообщение на /start** можно указать текст, который бот отправит на команду `/start`, если поле заполнено.

    * Чек-бокс **Начинать диалог на /start** начинает диалог вместе с командой `/start`. Если чек-бокс выключен, диалог начнётся с первого сообщения посетителя.

    * Чек-бокс **Измененная ссылка на кнопке** меняет ссылку кнопки с `https://t.me/<bot>` на `tg://resolve?domain=<bot>`. По такой ссылке открывается приложение **Telegram**.

    * Чек-бокс **Системные сообщения** передаёт в **Telegram** системные сообщения Webim.

    * Чек-бокс **Предложить оценить оператора** отправляет запрос оценки после того, как оператор закрыл диалог.

    * Чек-бокс **Режим опроса (polling)** заставляет бота забирать обновления опросом `getUpdates`. Вебхук при этом снимается. Режим нужен, когда у **Telegram** нет доступа к публичному адресу **Webim**.

    * В блоке **Групповые чаты** чек-бокс **Принимать сообщения из групп** включает сообщения групп и супергрупп. Группа или тема форума становится одним посетителем, автор сообщения показывается в скобках. Пока диалог открыт, в него попадают все сообщения группы. Пока диалог не начат или уже закрыт оператором, новое обращение открывает только сообщение, выбранное в поле **На какие сообщения реагировать**: **На любые** или **Только на упоминание бота или ответ боту**.

    * **Разрешённые ID групп** — идентификаторы чатов через запятую, например `-1001234567890`. Пустое поле разрешает все группы. Из группы, которой нет в списке, бот выходит.

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

    * **Отправлять опросы в группы** — ответить может любой участник группы.

    * Пока **Принимать сообщения из групп** выключен, доступен чек-бокс **Выходить из групп, в которые добавили бота**.

    * Чтобы бот видел все сообщения группы, а не только упоминания, ответы и команды, в BotFather отключите privacy mode командой `/setprivacy` или назначьте бота администратором группы.

    * **Выбор отдела**: **Не нужен** или **Обязателен**. Если выбор не нужен, укажите отдел в поле **Обращение для отдела**. Если обязателен — отметьте отделы в поле **Доступные для выбора отделы**.

    * Блок **Общие настройки** содержит **URL API бота Telegram**. Пустое поле оставляет адрес аккаунта или сервера. Свой адрес нужен, когда официальный `https://api.telegram.org` недоступен. Чек-бокс **Пропустить проверку SSL для Bot API** включает работу с самоподписанным сертификатом этого сервера.

    * **Внешний идентификатор** — идентификатор канала для бота **ЦРТ**. Подробнее — в разделе [Каналы общения](https://webim.ru/kb/11.0/channels/#external-id).

    * **Автоотключение при ошибках** — сколько подряд невосстановимых ошибок допускается до отключения канала. `0` оставляет канал включённым.

    * Чек-бокс **Использовать прокси** включает блок прокси.

    !!! Note "Скрытие данных при редактировании"
        При повторном открытии сохранённого канала часть полей отображается частично скрытой: **URL API бота Telegram**, адрес (хост) прокси и **URL прокси вебхука**, а также токен авторизации бота и пароль прокси. Полные значения из интерфейса скопировать нельзя — чтобы задать новое, введите его заново. Подробнее о виде маски см. в разделе [Каналы общения](https://webim.ru/kb/11.0/channels/).

  1. Проверьте все поля формы и нажмите кнопку **Сохранить**.

  1. Сервис **Webim** сохранит введённые настройки бота. Проверьте, что новый бот появится в списке каналов.

  1. Перейдите обратно в клиентское приложение **Telegram**. Найдите в последнем сообщении от **BotFather** ссылку на только что созданный бот.

  1. Откроется экран чата с ботом. Нажмите кнопку **Запустить** внизу экрана.

Интеграция **Telegram** и **Webim** закончена.

Теперь любой посетитель Вашего сайта, который предпочитает общаться через **Telegram**, сможет воспользоваться ею и появится в очереди пользователей в личном кабинете сервиса **Webim**.

## Как использовать интеграцию

После успешной настройки канала в **Панели управления** в сервисе **Webim** появился новый посетитель, представляющий собой Вашего пользователя в мессенджере **Telegram**. Вы можете найти его, как и посетителей сайта, на странице [Рабочее место оператора](https://login.webim.ru/agent/chat) в очереди пользователей, ожидающих ответа, либо в случае, если включено **Автоназначение**, он может быть назначен на Вас.

Обращение будет перемещено в раздел **В диалоге с Вами** после того, как оператор возьмёт его в обработку. В качестве точки входа в карточке предпросмотра диалога, а также в разделе **РМО Информация о посещении** будет указана страница **Telegram**.

Вместо сведений о геолокации, браузере и адресе IP у этого посетителя выводится информация о его учётной записи **Telegram**.

Выберите этого пользователя в очереди и начните с ним диалог. Информация о посетителе будет отображена в **РМО** в одноимённом разделе. **Telegram** передаёт следующие поля о посетителе:

  * **Имя**. Здесь отобразится имя, указанное пользователем в **Telegram**. Если данное имя не соответствует настоящему имени посетителя и Вы хотите его поменять, это можно сделать при помощи кнопки **Изменить информацию о посетителе**. После введения нового имени оно заменит имя, переданное **Telegram**, в соответствующем поле.

  * **ID пользователя в канале**. Данное поле отображает уникальный 9-значный численный ID пользователя в **Telegram**, который присваивается профилю в момент регистрации. Данный ID в профиле не отображается, его можно узнать при помощи специального бота в **Telegram**.

Указанные выше поля передаются по умолчанию.

Если же оператор воспользуется функцией **Запрос контактов**, то посетитель увидит соответствующее сообщение в чате, а также кнопки **Send a phone number** и **Cancel**. Если он выберет первое, то его номер будет отправлен в чат, а также отобразится в дополнительном поле **Телефон** в разделе **Информация о посетителе**.

Сообщения, которые вводит оператор **Webim**, будут сразу появляться у пользователя **Telegram**.

---

Источник: https://webim.ru/kb/11.0/channels/social-network-messengers/telegram.html
