Интеграция с Telegram-ботом (КУС) — различия между версиями

Материал из КинтВики
Перейти к: навигация, поиск
(Новая страница: «<noinclude>Т</noinclude> В релизе 25.01 появилась в…»)
 
(Использование Telegram-бота)
 
(не показано 11 промежуточных версий этого же участника)
Строка 1: Строка 1:
 
<noinclude>[[Категория: Интеграция с внешними сервисами (КУС)|Т]]</noinclude>
 
<noinclude>[[Категория: Интеграция с внешними сервисами (КУС)|Т]]</noinclude>
В релизе 25.01 появилась возможность отправлять файлы и сообщения гостям санатория через Telegram-бота.  
+
Начиная с релиза 25.01, в программе «Кинт: Управление санаторием» появилась возможность отправлять файлы и сообщения гостям через Telegram-бота.  
  
Это позволяет оперативно, без перехода в мессенджер, отправлять гостям уведомления и печатные формы документов, например, счетов на оплату. Данная функция является первым этапом интеграции с мессенджером Telegram.
+
Это позволит сотрудникам санатория оперативно отправлять важные уведомления и документы гостям в мессенджер Telegram напрямую из программы.
  
Для использования этой возможности организации требуется создать собственного Telegram-бота с помощью @BotFather в Telegram и получить API ключ.
+
Для использования этой возможности организации требуется создать собственного Telegram-бота с помощью @BotFather в Telegram и получить API-ключ.
  
 
== Порядок подключения ==
 
== Порядок подключения ==
 
# В интерфейсе «Администратор системы» перейдите на закладку '''Интернет-сервисы''', в раздел «Telegram»:
 
# В интерфейсе «Администратор системы» перейдите на закладку '''Интернет-сервисы''', в раздел «Telegram»:
:* Включите опцию «Использовать интеграцию с Telegram».
+
#:* Включите опцию «Использовать интеграцию с Telegram».
:* Введите имя созданного Telegram-бота и полученный API-ключ в соответствующие поля.
+
#:* Введите имя созданного Telegram-бота и полученный API-ключ в соответствующие поля.
# В конфигураторе 1С проведите публикацию http-сервиса «TelegramPushNotification» (убедитесь, что аутентификация при публикации отключена).  
+
#:[[Файл:Раздел Телеграм в Адм.системы.png|600px]]
# В интерфейсе «Администратор системы» перейдите на закладку '''Интернет-сервисы''' и в разделе «Публикация базы» добавьте приложение «Telegram».  
+
# В конфигураторе 1С проведите публикацию http-сервиса «TelegramPushNotification».  
 +
#:[[Файл:Публикация сервиса telegram.png|400px]]
 +
# В интерфейсе «Администратор системы» перейдите на закладку '''Интернет-сервисы''' и в разделе «Публикация базы» добавьте приложение «Telegram» (для публикации не должна быть включена аутентификация при входе).
 +
#:[[Файл:Публикация базы Telegram.png|600px]]
  
 
== Использование Telegram-бота ==
 
== Использование Telegram-бота ==
  
 
# Перейдите в карточку нужного контрагента и кнопкой '''''Печать''''' откройте печатную форму «Код для Telegram». Эта форма содержит QR-код для подключения к боту и код регистрации, необходимый для идентификации гостя в чате.  
 
# Перейдите в карточку нужного контрагента и кнопкой '''''Печать''''' откройте печатную форму «Код для Telegram». Эта форма содержит QR-код для подключения к боту и код регистрации, необходимый для идентификации гостя в чате.  
# Передайте печатную форму гостю любым удобным способом, например, через отправку по электронной почте или в виде ссылки.
+
#:[[Файл:Карточка контрагента Печать.png|700px]]
 +
#:[[Файл:Код для телеграм.png|500px]]
 +
# Передайте печатную форму «Код для Telegram» гостю любым удобным способом, например, через отправку по электронной почте или в виде ссылки.
 
# После того, как гость подключится к Telegram-боту (отсканировав QR-код) и пройдет идентификацию (отправив код регистрации в чат с ботом), можно будет отправлять ему сообщения и документы.
 
# После того, как гость подключится к Telegram-боту (отсканировав QR-код) и пройдет идентификацию (отправив код регистрации в чат с ботом), можно будет отправлять ему сообщения и документы.
 
# Для отправки документа:
 
# Для отправки документа:
 
## Кнопкой '''''Печать''''' откройте печатную форму документа (например, счета на оплату).
 
## Кнопкой '''''Печать''''' откройте печатную форму документа (например, счета на оплату).
 
## Нажмите в ней кнопку '''''Отправить'''''.
 
## Нажмите в ней кнопку '''''Отправить'''''.
## В открывшейся форме рассылки выберите вид сообщения «Telegram».
+
##:[[Файл:Печатная форма Отправить.png|700px]]
 +
## В открывшейся форме рассылки выберите вид сообщения «Telegram». ID чата в табличной части закладки '''Адресаты''' отображается только в том случае, если гость подключился к Telegram-боту и ввел в чате код идентификации.
 +
##:[[Файл:Отправка ПФ счета в ТГ.png|700px]]
 
# Сообщение гостю через Telegram-бота можно отправить аналогичным образом — через форму рассылки, выбрав в ней вид сообщения «Telegram».  
 
# Сообщение гостю через Telegram-бота можно отправить аналогичным образом — через форму рассылки, выбрав в ней вид сообщения «Telegram».  
# При необходимости можно активировать отправку через Telegram-бота шаблонных уведомлений по операциям бронирования: для этого требуется активировать вид сообщения «Telegram» в разделе «Уведомления» интерфейса «Администратор системы».
+
# При необходимости можно активировать отправку через Telegram-бота шаблонных уведомлений по операциям бронирования: для этого требуется активировать вид сообщения «Telegram» в разделе «Уведомления» закладки '''Гостиница''' в интерфейсе «Администратор системы».
 +
#:[[Файл:Адм. системы Гостиница Увед.png|600px]]

Текущая версия на 10:15, 13 февраля 2025

Начиная с релиза 25.01, в программе «Кинт: Управление санаторием» появилась возможность отправлять файлы и сообщения гостям через Telegram-бота.

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

Для использования этой возможности организации требуется создать собственного Telegram-бота с помощью @BotFather в Telegram и получить API-ключ.

Порядок подключения

  1. В интерфейсе «Администратор системы» перейдите на закладку Интернет-сервисы, в раздел «Telegram»:
    • Включите опцию «Использовать интеграцию с Telegram».
    • Введите имя созданного Telegram-бота и полученный API-ключ в соответствующие поля.
    Раздел Телеграм в Адм.системы.png
  2. В конфигураторе 1С проведите публикацию http-сервиса «TelegramPushNotification».
    Публикация сервиса telegram.png
  3. В интерфейсе «Администратор системы» перейдите на закладку Интернет-сервисы и в разделе «Публикация базы» добавьте приложение «Telegram» (для публикации не должна быть включена аутентификация при входе).
    Публикация базы Telegram.png

Использование Telegram-бота

  1. Перейдите в карточку нужного контрагента и кнопкой Печать откройте печатную форму «Код для Telegram». Эта форма содержит QR-код для подключения к боту и код регистрации, необходимый для идентификации гостя в чате.
    Карточка контрагента Печать.png
    Код для телеграм.png
  2. Передайте печатную форму «Код для Telegram» гостю любым удобным способом, например, через отправку по электронной почте или в виде ссылки.
  3. После того, как гость подключится к Telegram-боту (отсканировав QR-код) и пройдет идентификацию (отправив код регистрации в чат с ботом), можно будет отправлять ему сообщения и документы.
  4. Для отправки документа:
    1. Кнопкой Печать откройте печатную форму документа (например, счета на оплату).
    2. Нажмите в ней кнопку Отправить.
      Печатная форма Отправить.png
    3. В открывшейся форме рассылки выберите вид сообщения «Telegram». ID чата в табличной части закладки Адресаты отображается только в том случае, если гость подключился к Telegram-боту и ввел в чате код идентификации.
      Отправка ПФ счета в ТГ.png
  5. Сообщение гостю через Telegram-бота можно отправить аналогичным образом — через форму рассылки, выбрав в ней вид сообщения «Telegram».
  6. При необходимости можно активировать отправку через Telegram-бота шаблонных уведомлений по операциям бронирования: для этого требуется активировать вид сообщения «Telegram» в разделе «Уведомления» закладки Гостиница в интерфейсе «Администратор системы».
    Адм. системы Гостиница Увед.png