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

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