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

Материал из КинтВики
Перейти к: навигация, поиск
(Использование Telegram-бота)
 
(не показано 9 промежуточных версий этого же участника)
Строка 4: Строка 4:
 
Это позволит сотрудникам санатория оперативно отправлять важные уведомления и документы гостям в мессенджер Telegram напрямую из программы.
 
Это позволит сотрудникам санатория оперативно отправлять важные уведомления и документы гостям в мессенджер Telegram напрямую из программы.
  
Для использования этой возможности организации требуется создать собственного Telegram-бота с помощью @BotFather в Telegram и получить API-ключ.
+
Для использования этой возможности организации требуется [https://tlgrm.ru/docs/bots#botfather создать собственного Telegram-бота с помощью @BotFather в Telegram] и получить API-ключ.
  
 
== Порядок подключения ==
 
== Порядок подключения ==
# В интерфейсе «Администратор системы» перейдите на закладку '''Интернет-сервисы''', в раздел «Telegram»:
+
1. В интерфейсе «Администратор системы» перейдите на закладку '''Интернет-сервисы''', в раздел «Telegram»:
#:* Включите опцию «Использовать интеграцию с Telegram».
+
* Включите опцию «Использовать интеграцию с Telegram».
#:* Введите имя созданного Telegram-бота и полученный API-ключ в соответствующие поля.
+
* Введите имя созданного Telegram-бота и полученный API-ключ в соответствующие поля.
#:[[Файл:Раздел Телеграм в Адм.системы.png|600px]]
+
:[[Файл:Раздел Телеграм в Адм.системы.png|600px]]
# В конфигураторе 1С проведите публикацию http-сервиса «TelegramPushNotification».  
+
2. В конфигураторе 1С проведите публикацию http-сервиса «TelegramPushNotification».  
#:[[Файл:Публикация сервиса telegram.png|400px]]
+
:[[Файл:Публикация сервиса telegram.png|400px]]
# В интерфейсе «Администратор системы» перейдите на закладку '''Интернет-сервисы''' и в разделе «Публикация базы» добавьте приложение «Telegram» (для публикации не должна быть включена аутентификация при входе).
+
3. В интерфейсе «Администратор системы» перейдите на закладку '''Интернет-сервисы''' и в разделе «Публикация базы» добавьте приложение «Telegram» (для публикации не должна быть включена аутентификация при входе).
#:[[Файл:Публикация базы Telegram.png|600px]]
+
:[[Файл:Публикация базы Telegram.png|600px]]
  
 
== Использование Telegram-бота ==
 
== Использование Telegram-бота ==
  
# Перейдите в карточку нужного контрагента и кнопкой '''''Печать''''' откройте печатную форму «Код для Telegram». Эта форма содержит QR-код для подключения к боту и код регистрации, необходимый для идентификации гостя в чате.  
+
1. Перейдите в карточку контрагента или в карточку физического лица и кнопкой '''''Печать''''' откройте печатную форму «Код для Telegram». В этой форме содержится QR-код, который гость должен отсканировать для подключения к чату и идентификации в системе.
#:[[Файл:Карточка контрагента Печать.png|700px]]
+
:[[Файл:Карточка контрагента Печать.png|700px]]
#:[[Файл:Код для телеграм.png|500px]]
+
:[[Файл:Код для телеграм.png|500px]]
# Передайте печатную форму «Код для Telegram» гостю любым удобным способом, например, через отправку по электронной почте или в виде ссылки.
+
2. Передайте печатную форму «Код для Telegram» гостю любым удобным способом, например, через отправку по электронной почте или в виде ссылки.
# После того, как гость подключится к Telegram-боту, отсканировав QR-код, можно будет отправлять ему сообщения и документы.
+
 
# Для отправки документа:
+
3. После того, как гость подключится к Telegram-боту, отсканировав QR-код, можно будет отправлять ему сообщения и документы.
## Кнопкой '''''Печать''''' откройте печатную форму документа (например, счета на оплату).
+
 
## Нажмите в ней кнопку '''''Отправить'''''.
+
4. Для отправки документа:
##:[[Файл:Печатная форма Отправить.png|700px]]
+
 
## В открывшейся форме рассылки выберите вид сообщения «Telegram». ID чата в табличной части закладки '''Адресаты''' отображается только в том случае, если гость подключился к Telegram-боту.
+
:4.1 Кнопкой '''''Печать''''' откройте печатную форму документа (например, счета на оплату).
##:[[Файл:Отправка ПФ счета в ТГ.png|700px]]
+
 
# Сообщение гостю через Telegram-бота можно отправить аналогичным образом — через форму рассылки, выбрав в ней вид сообщения «Telegram».  
+
:4.2 Нажмите в ней кнопку '''''Отправить'''''.
# При необходимости можно активировать отправку через Telegram-бота шаблонных уведомлений по операциям бронирования: для этого требуется активировать вид сообщения «Telegram» в разделе «Уведомления» закладки '''Гостиница''' в интерфейсе «Администратор системы».
+
:[[Файл:Печатная форма Отправить.png|700px]]
#:[[Файл:Адм. системы Гостиница Увед.png|600px]]
+
 
 +
:4.3 В открывшейся форме рассылки выберите вид сообщения «Telegram». ID чата в табличной части закладки '''Адресаты''' отображается только в том случае, если гость подключился к Telegram-боту.
 +
:[[Файл:Отправка ПФ счета в ТГ.png|700px]]
 +
5. Сообщение гостю через Telegram-бота можно отправить аналогичным образом — используя форму рассылки.  
 +
 
 +
6. При необходимости можно активировать отправку через Telegram-бота шаблонных уведомлений по операциям бронирования: для этого требуется активировать вид сообщения «Telegram» в разделе «Уведомления» закладки '''Гостиница''' в интерфейсе «Администратор системы».
 +
:[[Файл:Адм. системы Гостиница Увед.png|600px]]
 +
 
 +
7. Сообщения, отправленные гостю (контрагенту) через Telegram-бота, можно посмотреть в журнале сообщений по объекту. Перейти в него можно по кнопке [[Файл:Сообщение по объекту.png]] в карточке контрагента или в карточке физического лица.
 +
 
 +
8. В чате с Telegram-ботом гость может воспользоваться командами '''''Мой QR-код''''' и '''''Расписание на сегодня''''' для получения в чате QR-кода для отметки сеансов и расписания на текущий день:
 +
<div class="tleft" style="clear:none; margin-left: 0;">[[Файл:Подключение пользователя к чат-боту ТГ.jpg|200px]]</div>
 +
<div class="tleft" style="clear:none; margin-left: 0;">[[Файл:Чат-бот ТГ Получить QR-код.jpg|200px]]</div>
 +
<div class="tleft" style="clear:none; margin-left: 0;">[[Файл:Чат-бот ТГ Получить расписание.jpg|200px]]</div>
 +
<div style="clear: both;"></div>

Текущая версия на 10:29, 23 мая 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. Для отправки документа:

4.1 Кнопкой Печать откройте печатную форму документа (например, счета на оплату).
4.2 Нажмите в ней кнопку Отправить.
Печатная форма Отправить.png
4.3 В открывшейся форме рассылки выберите вид сообщения «Telegram». ID чата в табличной части закладки Адресаты отображается только в том случае, если гость подключился к Telegram-боту.
Отправка ПФ счета в ТГ.png

5. Сообщение гостю через Telegram-бота можно отправить аналогичным образом — используя форму рассылки.

6. При необходимости можно активировать отправку через Telegram-бота шаблонных уведомлений по операциям бронирования: для этого требуется активировать вид сообщения «Telegram» в разделе «Уведомления» закладки Гостиница в интерфейсе «Администратор системы».

Адм. системы Гостиница Увед.png

7. Сообщения, отправленные гостю (контрагенту) через Telegram-бота, можно посмотреть в журнале сообщений по объекту. Перейти в него можно по кнопке Сообщение по объекту.png в карточке контрагента или в карточке физического лица.

8. В чате с Telegram-ботом гость может воспользоваться командами Мой QR-код и Расписание на сегодня для получения в чате QR-кода для отметки сеансов и расписания на текущий день:

Подключение пользователя к чат-боту ТГ.jpg
Чат-бот ТГ Получить QR-код.jpg
Чат-бот ТГ Получить расписание.jpg