Перейти к содержанию

Telegram

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

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

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

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

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

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

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

  2. Сначала нужно создать бот Telegram для своего проекта, с которым будут общаться Ваши клиенты. У Telegram есть подробная инструкция по созданию бота. Здесь мы лишь перечисляем действия, необходимые для настройки интеграции. Вы можете использовать инструкцию Telegram для получения дополнительной информации.

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

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

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

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

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

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

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

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

    Групповые чаты

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

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

  11. Перейдите в Панель управления сервиса Webim.

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

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

  14. Когда функциональность будет подключена, в группе 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 включает работу с самоподписанным сертификатом этого сервера.

    • Внешний идентификатор — идентификатор канала для бота ЦРТ. Подробнее — в разделе Каналы общения.

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

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

    Скрытие данных при редактировании

    При повторном открытии сохранённого канала часть полей отображается частично скрытой: URL API бота Telegram, адрес (хост) прокси и URL прокси вебхука, а также токен авторизации бота и пароль прокси. Полные значения из интерфейса скопировать нельзя — чтобы задать новое, введите его заново. Подробнее о виде маски см. в разделе Каналы общения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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