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


 

 

Особенности работы

 

Интеграция с Telegram работает только с Telegram-ботами. Личные аккаунты, привязанные к номерам телефонов, интегрировать не получится.

 

Интеграция с Telegram работает по принципу один токен (один бот) - одна интеграция.

Это значит, что вы не сможете интегрировать одного бота Telegram с несколькими сервисами. Для каждого сервиса нужен отдельный токен (бот).

 

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

Например, для работы трех сайтов вам потребуется три токена (три бота).

 

Максимальная длина текстового сообщения составляет 4096 символов.

 

В Telegram имеется ограничение на размер файлов, которые можно передать через бота. Оно составляет 20 Мб для одного файла.

 

Telegram не присылает информацию о прочтении сообщения клиентом.

 

 

Данные о клиенте

 

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

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

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

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

 

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

 

Telegram не передает номер мобильного телефона и адрес электронной почты пользователя.

 

 

Как подключить интеграцию

 

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

О том, как создать проект, рассказано в данной статье.

 

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

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

 
 

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

 
 

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

 
 

 

Где взять токен

 

Откройте Telegram.

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

 
 

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

 
 

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

 
 

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

 
 

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

 
 

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

 
 

Если у вас уже есть интеграция с другим сервисом, но вы хотите подключить наш, вам нужно отправить команду "/revoke" пользователю @BotFather и выбрать бота, для которого будет сгенерирован новый токен. Используйте полученный токен для подключения интеграции с 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-бота

 

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

 

Взять ссылку на своего Telegram-бота можно из Личного кабинета в разделе "Каналы связи". Наведите курсор на имя вашего Telegram-бота, кликните на него правой кнопкой мыши и выберите "Копировать ссылку".

 
 

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

 

О том, как разместить ссылку в меню кнопки или в меню виджета, вы можете прочитать в данной статье.

 

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

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

 
 

 

Дополнительные настройки

 

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

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

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

 

Данная опция работает только когда пользователь пишет вашему боту в чат напрямую.

Имя оператора будет указано перед текстом ответного сообщения.

 
 

 

Частые ошибки

 

Подписка на события Telegram не оформлена

 

Интеграция с Telegram работает по принципу один токен (один бот) - одна интеграция.

Это значит, что вы не сможете интегрировать одного бота Telegram с несколькими сервисами. Для каждого сервиса нужен отдельный токен (бот).

 

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

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

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

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

 
 

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

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

 
 

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

 
 

 

Ошибка "Unauthorized"

 

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

 
 

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

286 просмотров

Другие статьи по этой теме


Общая информация для интеграций
Интеграции позволяют вам получать информацию из различных источников и отвечать клиентам в одном приложении без необходимости заходить в различные мес...
Интеграция с Viber
Особенности работы Интеграция с Viber работает только с публичными аккаунтами. Личные аккаунты, привязанные к номерам телефонов, интегрировать не пол...
Интеграция с WhatsApp
Особенности работы Контент Данные о клиенте Контент Как подключить интеграцию Для создания интеграции вам необходимо зарегистрироваться и создать...
Интеграция с ВКонтакте
Особенности работы Максимальная длина текстового сообщения составляет 4096 символов. Если вы хотите, чтобы наши чат-боты работали с ВК, нужно произв...
Интеграция с Одноклассники
Особенности работы Одноклассники не присылает информацию о прочтении сообщения клиентом. Данные о клиенте При использовании интеграции ОК передает ...
Интеграция с Email
Особенности работы Чат-бот не работает с данной интеграцией. Максимальный размер письма, который может обработать наш сервис составляет 20 Мб. Данн...
Интеграция с Avito
Особенности работы На данный момент через интеграцию можно отправить только текстовое сообщение. Все остальные типы сообщения (изображение, видео и ...
Интеграция с Юла
Особенности работы Для подключения интеграции нужен бизнес-аккаунт. Обычный аккаунт подключить нельзя. Сообщения, отправленные вами из Личного кабин...
Интеграция с Дром
Особенности работы Интеграция работает только для диалогов по объявлениям из разделов "Легковые авто" и "Грузовики и спецтехника". Для остальных разд...
Интеграция с Auto.ru
Особенности работы Для подключения интеграции необходим действующий аккаунт дилера. Для обычного пользовательского аккаунта подключить интеграцию не...
Интеграция с AliExpress
Особенности работы Подключить интеграцию можно только для аккаунта продавца. На данный момент через интеграцию можно отправить только текстовое сооб...