Различия

Показаны различия между двумя версиями страницы.

--- external:pro_bonus:pro_bonus_tlgbot [2022/10/06 14:33] – Юлия Иванова
+++ external:pro_bonus:pro_bonus_tlgbot [2022/10/23 12:44] (текущий) – удалено Александр Ильин
@@ Строка 1: / Строка 1: @@
-====== Телеграм-Бот для системы ProBonus ======
-====== **СТАТЬЯ В РАЗРАБОТКЕ** ======
-**Описание:** Модуль предназначен для гостей, а также управленцев, чтобы отслеживать отзывы.
-Бот решает следующие задачи:
-  * регистрация гостя в ProBonus;
-  * запрос идентификаторов гостя;
-  * отчёт по потратам;
-  * баланс;
-  * оставить отзыв.
-Для отзывов создаётся группа и в неё добавляется бот. Гость  в диалоге с ботом оставляет отзыв, который транслируется в группу.
-**Создание бота в телеграм**
-Мессенджер Telegram, кроме своей прямой функции (обмена сообщениями между пользователями) позволяет создавать Ботов, которых можно использовать для решения прикладных задач по автоматизации (отправка событийных уведомлений и/или периодической информации определенному списку получателей).
-В рамках решений от Компании "Карбис" мы активно используем телеграм-ботов (оповещения персонала в [[external:qr_меню:|QR меню]], [[external:carbistbot:|рассылка отчетов и информации о фискально-опасных операциях]] в ресторане, бот для применения [[external:дискобот:|скидок по QR- коду]] и так далее). В данной статье описывается, как самостоятельно завести Бота в Telegram для дальнейшего использования.
-===== Почему мы (Карбис) не можем завести бота для вас? =====
-Этот вопрос мы получаем каждый раз, когда просим клиента завести бота самостоятельно.
-Есть 2 причины, почему вам лучше сделать это самим:
-  - В системе Telegram есть ограничения на количество создаваемых ботов одним пользователем, и если мы сами будем создавать всех ботов для всех, кто пользуется нашими разработками, то мы очень быстро исчерпаем этот лимит.
-  - В системе Telegram пользователь, который создал бота, имеет полный контроль над ним (может удалить его, изменить его параметры и т.д.) поэтому будет надежнее, если этот контроль останется у вас.
-===== Создание Бота =====
-Для того что бы создать своего Бота, вам нужно иметь аккаунт в Telegram
-Вам нужно поиском найти бота с именем **BotFather** и отправить ему команду "**/start**", а затем команду "**/newbot**"
-{{:external:zz_дополнительные_материалы:pasted:20211108-143009.jpeg?300}} {{:external:zz_дополнительные_материалы:pasted:20211108-143056.jpeg?300}}
-Далее нужно написать "Name" (имя) для бота. Это может быть краткое человекочитаемое описание его предназначения. Например, "Ресторан Ромашка. События ProBonus". На примере мы использовали имя Julia_probonus_bot
-{{:external:zz_дополнительные_материалы:pasted:20211108-144247.jpeg?300}}  {{:external:pro_bonus:sdfsfsfsf.png?300|}}
-Следующим шагом нужно придумать "Username" (имя, по которому можно найти данного бота).
-Username обязательно должно оканчиваться на "bot", можно использовать символы "_" и "-".
-Например, если мы создаем бота, который будет использоваться персоналом для получения оповещений от модуля QR-меню в ресторане "Ромашка", то можно назвать бота так: Romashka_probonus_bot. На примере мы использовали имя Julia_probonus_bot
-{{:external:zz_дополнительные_материалы:pasted:20211108-144639.jpeg?300}}
-После этого вы получите сообщение, что ваш Бот успешно создан. В этом сообщении будет указан **HTTP API-токен, который в дальнейшем потребуется для настройки бота.**
-{{:external:zz_дополнительные_материалы:pasted:20211108-144754.jpeg?300}}
-Управлять вашими ботами можно через команду "**/mybots**". Например, вы можете дополнительно загрузить Botpic - изображение для бота.
-{{:external:zz_дополнительные_материалы:pasted:20211108-144917.jpeg?300}}  {{:external:zz_дополнительные_материалы:pasted:20211108-144928.jpeg?300}}
-{{:external:zz_дополнительные_материалы:pasted:20211108-144938.jpeg?300}}  {{:external:zz_дополнительные_материалы:pasted:20211108-144958.jpeg?300}}
-===== Установка Бота =====
-После создания бота в телеграм, можно устанавливать сам телеграм-бот для ProBonus. Актуальная ссылка с дистрибутивом находится здесь:
-После распаковки файлов из архива, необходимо открыть файл settings.yaml.
-HTTP API-токен, который мы получили при создании телеграм-бота (он указан в чате с BotFather), нужно скопировать в файл settings.yaml в поле token
-{{:external:pro_bonus:img_3826.jpg?400|}} {{:external:pro_bonus:img_3823.jpg?400|}} {{:external:pro_bonus:img_3824.jpg?400|}}