# 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**, нажмите **Запустить** внизу окна приложения:

    ![Начала диалога с Telegram BotFather](https://webim.ru/kb/img/channels/social-network-messengers/telegram/botfather-starting.webp)

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

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

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

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

    ![Создание бота и получение его токена API](https://webim.ru/kb/img/channels/social-network-messengers/telegram/bot-creating-1.webp)

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

    ??? Warning "Работа в групповых чатах"
        Интеграция с **Telegram** не подразумевает использование созданного бота в групповых чатах **Telegram**! Это означает, что при попытке добавить привязанный к **Webim** бот в групповой чат, будут наблюдаться серьёзные нарушения в работе бота. Чтобы предупредить возможные неполадки, отключите возможность добавления в группы для бота. Для этого в чате с **BotFather** выполните команду `/mybots` и выберите нужный вам бот, далее выберите **Bot Settings -> Allow Groups** и убедитесь, что эта функциональность выключена. Если нет, то выключите её, нажав **Turn Groups off**:

          ![Отключение добавления бота в группы в BotFather](https://webim.ru/kb/img/channels/social-network-messengers/telegram/tg-allow-groups.webp)

     О других вопросах, связанных с работой каналов общения, вы можете посмотреть в [этой статье](https://webim.ru/kb/faq/integration.html).

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

  1. Выберите в меню [Общие настройки](https://login.webim.ru/agent/settings), там найдите раздел **Настройки**, пункт **Каналы общения**. Откроется интерфейс для подключения каналов, в том числе **Telegram**:

    ![Настройка канала общения через Telegram](https://webim.ru/kb/img/channels/social-network-messengers/telegram/tg-in-menu.webp)

     Если Вы не наблюдаете такого раздела в **Панели управления**, то вернитесь к проверке версии **Webim** (пункты 1-3).

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

  1. Когда функциональность будет подключена, в разделе каналов **Telegram** появится кнопка **Добавить бот** (см. иллюстрацию выше). Нажмите её. Откроется форма **Добавление бота Telegram**:

    ![Форма для подключения бота Telegram к Webim](https://webim.ru/kb/img/channels/social-network-messengers/telegram/tg-form.webp)

    * В поле **Название бота** введите наименование этого нового канала, под которым он будет фигурировать на **Рабочем месте оператора**.

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

    * В поле **Ответное сообщение на /start** можно указать текст сообщения, которое будет выводиться посетителю в чате с ботом после того, как тот нажмёт `/start`, если соответствующая функция включена (см. следующий пункт).

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

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

    * Если вы хотите, чтобы системные сообщения передавались в чаты из **Telegram**, активируйте чек-бокс **Системные сообщения**.

    * Укажите, обязателен ли **Выбор отдела** посетителем.

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

    * В поле **URL сервера Telegram Bot API** при необходимости укажите адрес кастомного сервера Bot API. Если оставить поле пустым, будет использована настройка аккаунта или глобальная.

    * Если хотите, чтобы ваш бот-оператор общался через прокси, активируйте чек-бокс **Использовать прокси** либо оставьте его без изменений. Подробнее про использование и настройку прокси см. в статье [Использование прокси](https://webim.ru/kb/devops/proxy.html).

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

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

    ![Сохранение настроек бота Telegram в Webim](https://webim.ru/kb/img/channels/social-network-messengers/telegram/tg-filled-form.webp)

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

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

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

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

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

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

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

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

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

Выберите этого пользователя в очереди и начните с ним диалог:

![Начало диалога оператора Webim с пользователем Telegram](https://webim.ru/kb/img/channels/social-network-messengers/telegram/tg-agent-chat.webp)

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

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

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

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

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

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

![Пользователь Telegram отвечает оператору Webim](https://webim.ru/kb/img/channels/social-network-messengers/telegram/tg-chat.webp)

---

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