Интеграция с Telegram

При использовании интеграции Telegram передает следующие данные о пользователе:

User name. Это уникальный идентификатор пользователя. С помощью него вы можете начать личный диалог с пользователем (без использования нашей интеграции) перейдя по ссылке t.me/[userName].

Имя и фамилия пользователя. Если у пользователя указаны имя и фамилия, они будут отображены.

Аватар пользователя. Отображает аватар пользователя.

Зайдите в Личный кабинет и откройте список подключенных сайтов.

Кликните на кнопку "Настройки" в контейнере с нужным вам сайтом и в появившемся слева списке меню выберите раздел "Каналы связи". В открывшемся окне вы увидите список подключенных интеграций.

Для создания новой интеграции нажмите кнопку "Добавить интеграцию" и выберите Telegram.

После клика на иконку Telegram откроется окно с пустым полем, в котором нужно указать токен для вашего телеграм-бота.

Откройте Telegram.

Начните диалог с пользователем @botfather и в нижней части чата нажмите "Запустить". Вы увидите список различных команд.

Если у вас нет телеграм-бота, вам нужно будет создать его с помощью команды "/newbot". Кликните на данную команду в списке или напишите ее и нажмите "Отправить". Далее вам нужно будет придумать для бота название и пользовательское имя (оно должно обязательно заканчиваться на "bot"). После этих действий бот будет создан, и в чате отобразится токен. Скопируйте его и вставьте в поле для токена.

Если у вас уже есть один или несколько телеграм-ботов, вам потребуется команда "/mybots". Кликните на эту команду в списке или напишите ее и нажмите "Отправить". В чат будет выведен список ваших ботов.

Кликните на бота, которого вы хотите использовать для интеграции. В появившемся окошке с действиями выберите "API Token".

Скопируйте токен и вставьте его в поле для токена.

После того, как вы добавили токен и сохранили изменения, в разделе "Каналы связи" появится новая интеграция с Telegram.

Откройте Telegram.

Начните диалог с пользователем @botfather.

Используйте команду "/mybots" для того, чтобы увидеть список ваших ботов.

Кликните на бота, которого вы используете в интеграции. В появившемся окошке с действиями выберите "Bot Settings".

В следующем окошке откроются настройки бота. Здесь вам нужно изменить две опции: доступ бота к группам (кнопка "Allow Groups?") и режим приватности (кнопка "Group Privacy").

Разрешение добавлять бота в группы

Нажмите кнопку "Allow Groups?", чтобы проверить, имеется ли доступ к группам у вашего бота.  

Если доступ есть, вы увидите текст с выделенным словом "enabled". В этом случае ничего менять не надо.

Если у бота был отключен доступ к группам, в сообщении будет текст с выделенным словом "disabled". Для того, чтобы открыть доступ к группам, нужно нажать на кнопку "Turn groups on".

Выключение режима приватности

Вы можете вернуться к настройкам бота кликнув на кнопку "Back to Settings".

В окошке настроек бота нажмите кнопку "Group Privacy" для проверки установленного режима приватности.

Если в тексте сообщения будет выделено слово "enabled" это значит, что режим приватности включен, и вам нужно отключить его, нажав на кнопку "Turn off".

В случае если вы уже меняли настройки режима приватности для бота, убедитесь, что в тексте сообщения выделено слово "disabled". Это значит, что режим приватности отключен.

Добавление бота в группу

Откройте группу, которая подключена к вашему каналу для комментариев и добавьте в нее бота. Для этого выберите группу, нажмите на значок "Меню" и зайдите в "Управление группой".

В открывшемся окне настроек группы кликните на "Администраторы".

Далее нажмите "Добавить администратора" и укажите вашего бота.

Выберите канал, из которого вы хотите получать комментарии, нажмите на значок "Меню" и зайдите в "Управление каналом".

В открывшемся окне редактирования канала кликните на "Обсуждение"

Добавьте группу, в которой вы сделали бота администратором и нажмите на "Привязать группу".

После этих действий вам в приложение оператора станут приходить комментарии к постам, и вы сможете на них отвечать.

Ссылку на Telegram-бота можно разместить на своем сайте, в меню кнопки виджета или в меню виджета. Ссылка должна вести на адрес https://t.me/mybot, где "mybot" - это название вашего Telegram-бота.

Клик на такую ссылку откроет у пользователя приложение Telegram, если оно установлено на его ПК или телефоне.

Для интеграции с Telegram доступны следующие обрабатываемые события:

• входящее сообщение;
• редактирование входящего сообщения;
• исходящее сообщение (комментарий в канале).

Также вы можете включить дополнительную опцию "Указывать имя оператора в ответном сообщении".

Когда вы подписываетесь на различные сервисы не забывайте о том, что токен может быть использован только для одного сервиса.

Если вы примените тот же токен, который используется нашим сервисом для интеграции с другим сервисом, то наша интеграция перестанет работать.

Также причиной ошибки может быть то, что вы обновили токен в Telegram, но не обновили его в настройках интеграции в Личном кабинете.

В Личном кабинете в разделе "Каналы связи" вы увидите уведомление об ошибке в работе интеграции с Telegram.

Для того чтобы восстановить работу интеграции, необходимо обновить токен.

Сделать это можно отправив команду "/revoke" пользователю @BotFather и выбрав бота, для которого будет сгенерирован новый токен.

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

Данная ошибка появляется при неверном вводе токена (например, при копировании были пропущены один или несколько символов).

Для исправления ошибки скопируйте и вставьте токен заново.