Это старая версия документа!
Телеграм-Бот для системы ProBonus
**СТАТЬЯ В РАЗРАБОТКЕ**
Описание: Модуль предназначен для гостей, а также управленцев, чтобы отслеживать отзывы.
Бот решает следующие задачи:
- регистрация гостя в ProBonus;
- запрос идентификаторов гостя;
- отчёт по потратам;
- баланс;
- оставить отзыв.
Для отзывов создаётся группа и в неё добавляется бот. Гость в диалоге с ботом оставляет отзыв, который транслируется в группу.
Создание бота в телеграм
Мессенджер Telegram, кроме своей прямой функции (обмена сообщениями между пользователями) позволяет создавать Ботов, которых можно использовать для решения прикладных задач по автоматизации (отправка событийных уведомлений и/или периодической информации определенному списку получателей).
В рамках решений от Компании «Карбис» мы активно используем телеграм-ботов (оповещения персонала в QR меню, рассылка отчетов и информации о фискально-опасных операциях в ресторане, бот для применения скидок по QR- коду и так далее). В данной статье описывается, как самостоятельно завести Бота в Telegram для дальнейшего использования.
Почему мы (Карбис) не можем завести бота для вас?
Этот вопрос мы получаем каждый раз, когда просим клиента завести бота самостоятельно.
Есть 2 причины, почему вам лучше сделать это самим:
- В системе Telegram есть ограничения на количество создаваемых ботов одним пользователем, и если мы сами будем создавать всех ботов для всех, кто пользуется нашими разработками, то мы очень быстро исчерпаем этот лимит.
- В системе Telegram пользователь, который создал бота, имеет полный контроль над ним (может удалить его, изменить его параметры и т.д.) поэтому будет надежнее, если этот контроль останется у вас.
Создание Бота
Для того что бы создать своего Бота, вам нужно иметь аккаунт в Telegram
Вам нужно поиском найти бота с именем BotFather и отправить ему команду «/start», а затем команду «/newbot»
Далее нужно написать «Name» (имя) для бота. Это может быть краткое человекочитаемое описание его предназначения. Например, «Ресторан Ромашка. События ProBonus». На примере мы использовали имя Julia_probonus_bot
Следующим шагом нужно придумать «Username» (имя, по которому можно найти данного бота).
Username обязательно должно оканчиваться на «bot», можно использовать символы «_» и «-».
Например, если мы создаем бота, который будет использоваться персоналом для получения оповещений от модуля QR-меню в ресторане «Ромашка», то можно назвать бота так: Romashka_probonus_bot. На примере мы использовали имя Julia_probonus_bot
После этого вы получите сообщение, что ваш Бот успешно создан. В этом сообщении будет указан HTTP API-токен, который в дальнейшем потребуется для настройки бота.
Управлять вашими ботами можно через команду «/mybots». Например, вы можете дополнительно загрузить Botpic - изображение для бота.
Установка телеграм-бота
После создания бота в телеграм, можно устанавливать сам телеграм-бот для ProBonus. Актуальная ссылка с дистрибутивом находится здесь:
После распаковки файлов из архива, необходимо открыть файл settings.yaml.
HTTP API-токен, который мы получили при создании телеграм-бота (он указан в чате с BotFather), нужно скопировать в файл settings.yaml в поле token