Интеграция с 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"

 

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

 
 

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

 

 

Ошибка "Не удалось отправить сообщение в интеграцию. Ответ сервера Telegram: Connection timed out after 10000 milliseconds"

 
 

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

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

При возникновении ошибки подождите некоторое время и попробуйте отправить сообщение еще раз.

 

 

Ошибка "Не удалось отправить сообщение в интеграцию. Ответ сервера Telegram: Forbidden: bot was blocked by the user"

 
 

Такая ошибка может возникнуть при отправке сообщения в интеграцию, если пользователь заблокировал вашего бота.

Для исправления ошибки пользователю нужно разблокировать бота. Это можно сделать нажав на кнопку "Перезапустить" в окне чата с выбранным ботом.

7824 просмотра

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

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