Настройка интеграции с Telegram: различия между версиями
(→Настройка интеграции с WhatsApp) |
м (I.kutygina переименовал страницу Настройка интеграции Telegram в Настройка интеграции с Telegram) |
||
(не показано 19 промежуточных версий этого же участника) | |||
Строка 1: | Строка 1: | ||
− | <p> | + | <p>В системе предусмотрена интеграция с мессенджером Telegram для отправки сообщений клиентам или пользователям системы.</p> |
− | + | == Предварительная настройка интеграции == | |
− | <p> | + | <p>Перед настройкой интеграции с Telegram необходимо предварительно создать бота. Для создания бота найдите в Telegram чат BotFather: [[Файл:Чат для создания t бота.png|none|class=pic]]</p> |
− | </p> | + | <p>Введите команду /start или нажмите кнопку "Запустить" в чате для запуска сессии общения с ботом.</p> |
− | <p> | + | <p>После того как сессия начинается, появляется подсказка со списком возможных команд. Наша цель создать бота для компании и получить авторизационный ключ. Для этого нажимаем на ссылку с командой /newbot или вводим данную команду в сообщении: [[Файл:Новый t бот.png|none|class=pic]]</p> |
− | <p> | + | <p>Придумываем <i>Имя бота</i> для компании и указываем его в сообщении: [[Файл:Имя t бота.png|none|class=pic]]</p> |
− | + | <p>Придумываем <i>Логин для бота</i> (Логин должен заканчиваться на "bot" и быть уникальным) и также вводим его в сообщении: [[Файл:Логин t бота.png|none|class=pic]]</p> | |
− | + | <p>После того как Логин будет принят, Бот пришлет короткую ссылку на новый чат и token: [[Файл:Параметры t бота.png|none|class=pic]]</p> | |
− | + | <p>Помимо создания Бота необходимо запросить настройку и адрес страницы Webhook (php-обработчик поступающих сообщений через API мессенджера с целью сохранения их в Базе 1С) у технической поддержки компании "Пять систем".</p> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | <p> | ||
− | < | ||
− | |||
− | <p> | ||
− | |||
− | <p> | ||
− | <p> | ||
− | == Настройка интеграции | + | == Настройка интеграции == |
− | + | <p>Для настройки интеграции перейдем в справочник "Интеграции": [[Файл:Справочник Интеграции.png|none|class=pic]] | |
− | <p>Для настройки интеграции | ||
</p> | </p> | ||
+ | <p>Создадим новую интеграцию: [[Файл:Создание интеграции.png|none|class=pic]]</p> | ||
+ | <p>В форме создания интеграции заполним наименование и выберем вид интеграции "Telegram": [[Файл:Интеграция Telegram.png|none|class=pic]]</p> | ||
+ | <p>В качестве обработчика выберем "Telegram (прямое соединение)": [[Файл:Обработчик Telegram.png|none|class=pic]] {{doc|Текст=Если сервер 1С находится в России, то напрямую с Telegram не получится соединится, так как данный мессенджер в России заблокирован. В этом случае необходимо выбирать обработчик "Telegram (Прокси-сервер)".}}</p> | ||
+ | <p>После выбора обработчика отображаются параметры для интеграции: [[Файл:Параметры интеграции с Telegram.png|none|class=pic]]</p> | ||
+ | <p>Заполним Token и короткую ссылку на созданный Бот, полученный в чате BotFather (см. [[#Предварительная настройка]]), в соответствующих параметрах: [[Файл:Заполнение параметров Telegram.png|none|class=pic]] {{doc|Текст=Короткие ссылки формата "<nowiki>http://t.me/</nowiki>" на данный момент заблокированы в России, поэтому есть вариант не заполнять параметр. Тогда ссылка будет выглядеть следующим образом: <nowiki>http://cloud2.5-systems/t.me/link.php?bot_name=<Логин бота></nowiki>. Для сокращения ссылки можно использовать различные сервисы для формирования коротких ссылок. Например, https://bitly.com. В этом случае сформированную короткую ссылку необходимо ввести в параметр "Короткая ссылка на telegram-бота".}}</p> | ||
+ | <p>Параметр "Шаблон приветствия клиента" используется для задания шаблона текста сообщения, которое будет видеть клиент при получении приглашения в Telegram. Выберем преднастроенный шаблон "Приветствие в Telegram": [[Файл:Выбор шаблона Telegram.png|none|class=pic]]</p> | ||
+ | <p>Заполним адрес страницы Webhook, предоставленный технической поддержкой компании "Пять систем", в <i>параметр "URL для webhook"</i>.</p> | ||
+ | <p>Готово! Все настройки внесены. Теперь запишем изменения, нажав кнопку "Записать", и протестируем соединение. Для теста соединения перейдем на вкладку "Тест подключения" и нажмем кнопку "Тест подключения": [[Файл:Тест соединения Telegram.png|none|class=pic]]</p> | ||
+ | <p>При успешном подключении отобразится информация о настроенном боте Telegram.</p> | ||
+ | <p>Если все успешно настроено, активируйте интеграцию, установив флажок у параметра "Включено", и нажмите на кнопку "ОК".</p> |
Текущая версия на 06:59, 31 октября 2019
В системе предусмотрена интеграция с мессенджером Telegram для отправки сообщений клиентам или пользователям системы.
Предварительная настройка интеграции
Перед настройкой интеграции с Telegram необходимо предварительно создать бота. Для создания бота найдите в Telegram чат BotFather:
Введите команду /start или нажмите кнопку "Запустить" в чате для запуска сессии общения с ботом.
После того как сессия начинается, появляется подсказка со списком возможных команд. Наша цель создать бота для компании и получить авторизационный ключ. Для этого нажимаем на ссылку с командой /newbot или вводим данную команду в сообщении:
Придумываем Имя бота для компании и указываем его в сообщении:
Придумываем Логин для бота (Логин должен заканчиваться на "bot" и быть уникальным) и также вводим его в сообщении:
После того как Логин будет принят, Бот пришлет короткую ссылку на новый чат и token:
Помимо создания Бота необходимо запросить настройку и адрес страницы Webhook (php-обработчик поступающих сообщений через API мессенджера с целью сохранения их в Базе 1С) у технической поддержки компании "Пять систем".
Настройка интеграции
Для настройки интеграции перейдем в справочник "Интеграции":
Создадим новую интеграцию:
В форме создания интеграции заполним наименование и выберем вид интеграции "Telegram":
В качестве обработчика выберем "Telegram (прямое соединение)":
Если сервер 1С находится в России, то напрямую с Telegram не получится соединится, так как данный мессенджер в России заблокирован. В этом случае необходимо выбирать обработчик "Telegram (Прокси-сервер)".
После выбора обработчика отображаются параметры для интеграции:
Заполним Token и короткую ссылку на созданный Бот, полученный в чате BotFather (см. #Предварительная настройка), в соответствующих параметрах:
Короткие ссылки формата "http://t.me/" на данный момент заблокированы в России, поэтому есть вариант не заполнять параметр. Тогда ссылка будет выглядеть следующим образом: http://cloud2.5-systems/t.me/link.php?bot_name=<Логин бота>. Для сокращения ссылки можно использовать различные сервисы для формирования коротких ссылок. Например, https://bitly.com. В этом случае сформированную короткую ссылку необходимо ввести в параметр "Короткая ссылка на telegram-бота".
Параметр "Шаблон приветствия клиента" используется для задания шаблона текста сообщения, которое будет видеть клиент при получении приглашения в Telegram. Выберем преднастроенный шаблон "Приветствие в Telegram":
Заполним адрес страницы Webhook, предоставленный технической поддержкой компании "Пять систем", в параметр "URL для webhook".
Готово! Все настройки внесены. Теперь запишем изменения, нажав кнопку "Записать", и протестируем соединение. Для теста соединения перейдем на вкладку "Тест подключения" и нажмем кнопку "Тест подключения":
При успешном подключении отобразится информация о настроенном боте Telegram.
Если все успешно настроено, активируйте интеграцию, установив флажок у параметра "Включено", и нажмите на кнопку "ОК".