Telegram
Telegram появился в 2013 году и вскоре завоевал заслуженную популярность как один из наиболее безопасных, быстрых и удобных мессенджеров. Сервис онлайн-консультирования Webim поддерживает возможность интеграции с Telegram на уровне каналов общения (communication channels).
Зачем нужна интеграция
Используя интеграцию сервисов Telegram и Webim, можно создать бот в мессенджере Telegram, который будет представлять Вашу организацию в этом сервисе, а все диалоги, которые Ваши пользователи ведут с ним, будут отображаться и обслуживаться операторами и администраторами в привычной Панели управления Webim.
Таким образом, те клиенты, которые предпочитают использовать мессенджер Telegram, добавят новый контакт в адресной книге и продолжат использовать привычный и комфортный для них коммуникатор, а Вашим операторам не придётся параллельно мониторить чаты в сервисах Telegram и Webim, все диалоги будут попадать в общую очередь и в общий интерфейс.
Инструкция по настройке
Чтобы включить интеграцию c Telegram на Вашем аккаунте Webim, выполните следующие шаги:
-
Убедитесь, что Вы являетесь зарегистрированным пользователем Telegram. Если нет, то скачайте клиентское приложение (или зайдите в веб-версию Telegram).
-
Сначала нужно создать бот Telegram для своего проекта, с которым будут общаться Ваши клиенты. У Telegram есть подробная инструкция по созданию бота. Здесь мы лишь перечисляем действия, необходимые для настройки интеграции. Вы можете использовать инструкцию Telegram для получения дополнительной информации.
-
Откройте приложение Telegram и наберите
BotFatherв строке поиска. -
Сервис найдёт BotFather. Выберите его в списке результатов поиска, чтобы начать общение с ним.
-
Когда откроется экран чата с BotFather, нажмите Запустить внизу окна приложения.
-
BotFather пришлёт приветственное сообщение. Чтобы создать бот, используйте команду
/newbot. -
BotFather запросит имя бота. Особых требований к имени бота нет, но учтите, что под этим именем бота будут видеть все пользователи!
-
Далее введите короткое имя (
Username) бота. Требования: от 5 до 32 символов, принимаются латиница, цифры и знак подчёркивания. Невосприимчиво к регистру. На конце обязательно должно быть слово "bot". -
BotFather проверит ввод и, если всё корректно и имя не занято, создаст бот. Вам BotFather пришлёт сообщение, в котором будут две важные вещи: ссылка для доступа к боту и токен для работы с ботом по Telegram API:

Создание бота и получение его токена API -
Скопируйте полученный токен в буфер обмена. Мы рекомендуем сохранить токен в надёжном месте, защищённом от доступа посторонних.
Групповые чаты
Бот можно использовать в группах. Приём включается в форме канала, блок Групповые чаты. Пока он выключен, бот сообщения групп не обрабатывает. Чек-бокс Выходить из групп, в которые добавили бота заставляет бота покидать такую группу.
Пока приём выключен, в BotFather можно дополнительно запретить добавление бота в группы:
/mybots→ нужный бот → Bot Settings → Allow Groups → Turn groups off. -
Перейдите в Панель управления сервиса Webim.
-
В левом меню откройте Настройки → Каналы общения. В списке есть группа Telegram.
-
Если в этом разделе отображается сообщение Недоступно на Вашем тарифе, то это означает, что функциональность каналов общения Telegram ещё не включена в Вашей конфигурации. Нажмите кнопку Заказать.
-
Когда функциональность будет подключена, в группе 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 прокси вебхука, а также токен авторизации бота и пароль прокси. Полные значения из интерфейса скопировать нельзя — чтобы задать новое, введите его заново. Подробнее о виде маски см. в разделе Каналы общения.
-
-
Проверьте все поля формы и нажмите кнопку Сохранить.
-
Сервис Webim сохранит введённые настройки бота. Проверьте, что новый бот появится в списке каналов.
-
Перейдите обратно в клиентское приложение Telegram. Найдите в последнем сообщении от BotFather ссылку на только что созданный бот.
-
Откроется экран чата с ботом. Нажмите кнопку Запустить внизу экрана.
Интеграция 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.