Привязка к группе в telegram [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Привязка к группе в telegram ======

Видео с демонстрацией процесса на платформах YouTube и VK Video:
{{youtube>eNql4bEIsf4?}}

{{url>https://vk.com/video_ext.php?oid=-157461792&id=456239051&hd=2&hash=4adae0a07d87a907&autoplay=0 430,267}}

\\

Для привязки бота к группе в telegram используется промежуточный inline-бот. Зачем и что это такое?
Телеграм-ботов для уведомлений - несколько. На этапе настройки inline-бот сам определяет наименее загруженного и "привязывает" его к конкретному чату.
Сам по себе inline-бот не присылает никаких уведомлений и отчётов, он нужен только на этапе настройки. Не нужно добавлять его в группу.

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

1) Создать в telegram группу. При создании группы добавить в неё кого-нибудь временно (потому что для создания группы нужно хотя бы 2 участника).
  
2) После создания группы можно сразу удалить "лишнего" участника.
  
3) Чтобы группа могла корректно работать с ботами, нужно сделать её публичной. Для этого нажать "Управление группой" -> "Тип группы" -> "Публичная группа". Указать какое-то имя для формирования ссылки на группу и сохранить. После этого группа превратилась в "супергруппу". 

4) Чтобы группа не была общедоступной - делаем её обратно "частной". Для этого нажать "Управление группой" -> "Тип группы" -> "Частная группа".
  
5) В группе нужно обратиться к **@proalert_inline_bot** , набрав этот текст в строке сообщения. Появится запрос "Добавить в чат доступного Telegram бота?". Нажать на этот запрос.
  
{{:external:pro_alert:01_install_and_settings:pasted:20230215-152752.png}}

и согласиться.

{{:external:pro_alert:01_install_and_settings:pasted:20230215-152852.png}}

5) Произойдёт привязка к чату наиболее свободного на момент времени бота ProAlert. В чате появится сообщение - какого именно бота нужно добавить в чат.
  
{{:external:pro_alert:01_install_and_settings:pasted:20230215-152959.png}}

6) Через кнопку "добавить участников" добавляем того бота, которого нам предложила система (именно его! не всегда того который на скриншоте в этой статье!)

{{:external:pro_alert:01_install_and_settings:pasted:20230215-153114.png}}

7) Произойдёт закрепление бота за чатом.
  
{{:external:pro_alert:01_install_and_settings:pasted:20230215-153419.png}}

8) Последний шаг - связать чат с конкретным ProAlert-агентом из ресторана.
Для этого нужно прислать в чат фото (скриншот) QR-кода, который показывает в браузере ProAlert-агент в desktop-режиме при запуске.
Либо можно нажать "Настройки" и прислать идентификатор ресторана в текстовом виде. Идентификатор ресторана содержится в конфиг-файле ProAlert-агента **proalert.yaml**.
{{:external:pro_alert:01_install_and_settings:pasted:20230215-153904.png}}
Где найти идентификатор в конфиг-файле:
{{:external:pro_alert:01_install_and_settings:pasted:20230215-154108.png}}

9) Здесь же, в меню чата "Настройки" для ресторана нужно выбрать используемую схему печати и указать "Фильтры уведомлений", т. е. те события, о которых бот будет извещать на кассе. Схему печати выбрать ту, которая реально используется в ресторане (см. параметр "использование схем печати" в rk7man).
{{:external:pro_alert:01_install_and_settings:pasted:20230216-151050.png}}

10) Чтобы из r_keeper приходил при закрытии смены на кассе отчёт автоматически, в фильтре должно быть включено "Печать документов из r_keeper"
{{:external:pro_alert:01_install_and_settings:pasted:20230216-151149.png}}

Если к группе (чату) нужно подключить сразу несколько ресторанов, нажимаем внутри группы  "Настройки" -> "Подключить ресторан" и  отправить идентификаторы от всех ProAlert-агентов, которые нужно включить.