| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия |
| external:pro_bonus:pro_bonus_tlgbot [2022/10/06 12:33] – Юлия Иванова | external:pro_bonus:pro_bonus_tlgbot [2022/10/23 12:44] (текущий) – удалено Александр Ильин |
|---|
| ====== Телеграм-Бот для системы 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" | |
| {{:external:zz_дополнительные_материалы:pasted:20211108-144247.jpeg?300}} {{:external:zz_дополнительные_материалы:pasted:20211108-144255.jpeg?300}} | |
| |
| Следующим шагом нужно придумать "Username" (имя, по которому можно найти данного бота). | |
| Username обязательно должно оканчиваться на "bot", можно использовать символы "_" и "-". | |
| Например, если мы создаем бота, который будет использоваться персоналом для получения оповещений от модуля QR-меню в ресторане "Ромашка", то можно назвать бота так: Romashka_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 | |