Настройка интеграции с Telegram

Материал из База знаний 5S AUTO
Версия от 06:59, 31 октября 2019; I.kutygina (обсуждение | вклад) (I.kutygina переименовал страницу Настройка интеграции Telegram в Настройка интеграции с Telegram)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

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

Предварительная настройка интеграции

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

Чат для создания t бота.png

Введите команду /start или нажмите кнопку "Запустить" в чате для запуска сессии общения с ботом.

После того как сессия начинается, появляется подсказка со списком возможных команд. Наша цель создать бота для компании и получить авторизационный ключ. Для этого нажимаем на ссылку с командой /newbot или вводим данную команду в сообщении:

Новый t бот.png

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

Имя t бота.png

Придумываем Логин для бота (Логин должен заканчиваться на "bot" и быть уникальным) и также вводим его в сообщении:

Логин t бота.png

После того как Логин будет принят, Бот пришлет короткую ссылку на новый чат и token:

Параметры t бота.png

Помимо создания Бота необходимо запросить настройку и адрес страницы Webhook (php-обработчик поступающих сообщений через API мессенджера с целью сохранения их в Базе 1С) у технической поддержки компании "Пять систем".

Настройка интеграции

Для настройки интеграции перейдем в справочник "Интеграции":

Справочник Интеграции.png

Создадим новую интеграцию:

Создание интеграции.png

В форме создания интеграции заполним наименование и выберем вид интеграции "Telegram":

Интеграция Telegram.png

В качестве обработчика выберем "Telegram (прямое соединение)":

Обработчик Telegram.png

Если сервер 1С находится в России, то напрямую с Telegram не получится соединится, так как данный мессенджер в России заблокирован. В этом случае необходимо выбирать обработчик "Telegram (Прокси-сервер)".

После выбора обработчика отображаются параметры для интеграции:

Параметры интеграции с Telegram.png

Заполним Token и короткую ссылку на созданный Бот, полученный в чате BotFather (см. #Предварительная настройка), в соответствующих параметрах:

Заполнение параметров Telegram.png

Короткие ссылки формата "http://t.me/" на данный момент заблокированы в России, поэтому есть вариант не заполнять параметр. Тогда ссылка будет выглядеть следующим образом: http://cloud2.5-systems/t.me/link.php?bot_name=<Логин бота>. Для сокращения ссылки можно использовать различные сервисы для формирования коротких ссылок. Например, https://bitly.com. В этом случае сформированную короткую ссылку необходимо ввести в параметр "Короткая ссылка на telegram-бота".

Параметр "Шаблон приветствия клиента" используется для задания шаблона текста сообщения, которое будет видеть клиент при получении приглашения в Telegram. Выберем преднастроенный шаблон "Приветствие в Telegram":

Выбор шаблона Telegram.png

Заполним адрес страницы Webhook, предоставленный технической поддержкой компании "Пять систем", в параметр "URL для webhook".

Готово! Все настройки внесены. Теперь запишем изменения, нажав кнопку "Записать", и протестируем соединение. Для теста соединения перейдем на вкладку "Тест подключения" и нажмем кнопку "Тест подключения":

Тест соединения Telegram.png

При успешном подключении отобразится информация о настроенном боте Telegram.

Если все успешно настроено, активируйте интеграцию, установив флажок у параметра "Включено", и нажмите на кнопку "ОК".

Источник — http://wiki.5-systems.ru/w/index.php?title=Настройка_интеграции_с_Telegram&oldid=2207