Запуск Telegram-бота

Создать бота в BotFather, подключить к Axle и настроить кнопки — за 10 минут.

Шаг 1. Создайте бота в BotFather Шаг 2. Подключите бота к Axle Шаг 3. Настройте кнопки меню Шаг 4. Включите пересылку сообщений Шаг 5. Проверьте глазами гостя Шаг 6. Раздайте ссылку

Шаг 1. Создайте бота в BotFather

Откройте в Telegram официального бота @BotFather.
Команда /newbot → придумайте имя (видят гости) и юзернейм (латиницей, оканчивается на bot, например moe_cafe_bot).
BotFather пришлёт токен — длинную строку вида 1234567:AA.... Скопируйте её и никому не показывайте: токен = полный доступ к боту.

Там же в BotFather стоит сразу задать аватар (/setuserpic) и описание (/setdescription) — гости видят их до первого нажатия «Старт».

Шаг 2. Подключите бота к Axle

Кабинет → Интеграции → карточка Telegram → Подключить.
Вставьте токен и сохраните. Мы сами установим вебхук и кнопку мини-приложения — бот оживает сразу.
Статус карточки сменится на «подключён» с юзернеймом бота.

Если включаете «Main App» в BotFather

BotFather умеет назначать боту главное мини-приложение — тогда в списке чатов у бота появляется кнопка «Открыть». Настройка там же: /mybots → ваш бот → Bot Settings → Main App. Два условия, иначе приложение откроется сломанным:

Launch Mode = Fullsize. Режим Fullscreen прячет шапку заведения под системную строку телефона и накрывает её плавающими кнопками Telegram — гость не видит, где он. Compact открывает приложение в половину экрана. Правильный режим — Fullsize.
Ссылка — адрес вашего приложения из карточки Telegram в «Интеграциях», без параметров: https://axleapp.ru/app/{номер организации}/.

Если раньше в этом поле стояла ссылка с «хвостом» (например, персональная ссылка на

карту), гость мог попадать в чужой вид приложения — замените её на чистый адрес.

Шаг 3. Настройте кнопки меню

Карточка Telegram → вкладка Меню. У бота есть готовые кнопки: Бронь, Меню, Вызвать официанта, Моя карта, Как добраться, Написать нам. Для каждой:

тумблер — показывать или нет;
Настроить — подпись у гостя, текст сообщения (поддерживает макросы {имя}, {баланс}, {карта}, {уровень} — чипы под полем вставляют их в текст) и режим: - «Меню»: встроенное меню из вкладки «Прайс» Старт и выше или своя ссылка (сайт, PDF); - «Бронь»: наша онлайн-бронь Старт и выше или внешний сервис (Restoplace и т.п.); - «Моя карта»: текст + кнопки «Добавить в Google/Apple Wallet» (можно переименовать и выключать).
Как добраться — вставьте ссылки на 2ГИС / Яндекс Карты / Google Maps.

У кнопки «Вызвать официанта» есть режим показа: всегда или **только во время

визита** (появляется, когда в кассе открыт чек гостя, и уходит после закрытия — для

этого нужна подключённая касса). В любом режиме вне визита она зал не поднимет: если

открытого чека нет, бот вежливо попросит показать сотруднику QR-код из приложения —

так гостя привяжут к столу. Что происходит при настоящем вызове (кому уйдёт уведомление

и что ответить гостю), настраивается в разделе «Автоматизация» — на странице кнопки

видно, какие сценарии её обрабатывают, и предупреждение, если не обрабатывает никто.

Макет чата справа

Рядом со списком кнопок — телефон с перепиской: то же меню, что получит гость, и живые кнопки. Нажмите любую — увидите сообщение, которым ответит бот, с вашими текстами, подставленными макросами и ссылками. Тумблеры и настройки кнопок макет подхватывает сразу, перезагружать страницу не нужно.

Макет честный и подсказывает недоделки: у «Как добраться» без ссылок гость получит «Адрес пока не указан», у «Моей карты» без включённых площадок Wallet не будет кнопок добавления, а вызов официанта без сценария в «Автоматизации» ответит дежурной фразой. Если у кнопки «Вызвать официанта» есть касса или режим «только во время визита», под телефоном появится переключатель «Гость сейчас: за столом / не в заведении» — им проверяют оба случая.

Площадки в макете разные, потому что разные на самом деле: в Telegram это нижнее меню под полем ввода, и нажатие отправляет боту текст кнопки (он виден в переписке); в MAX нижнего меню нет — кнопки приходят вложением к приветствию, остаются в истории, а нажатие уходит боту скрытым сигналом.

Тот же телефон стоит и на странице Настроить — там он показывает нажатие именно этой кнопки и пересобирается прямо во время правки: меняете текст сообщения, подпись кнопки, режим или ссылку — сообщение в чате меняется на каждой букве, сохранять для проверки не нужно. Выключенная кнопка и режим «только во время визита» подписаны: макет объяснит, почему сейчас гость её не увидит.

Вернуться к списку кнопок — ← Все кнопки меню вверху страницы или Отмена под формой; правки при этом не сохраняются. Кнопка Сохранить уводит туда же, но уже с сохранёнными настройками.

Шаг 4. Включите пересылку сообщений

Вкладка Настройка → тумблер пересылки: всё, что гость пишет боту, прилетает в ваш админ-бот. Ответьте на пересланное сообщение (reply) — ответ уйдёт гостю от имени заведения.

Шаг 5. Проверьте глазами гостя

Откройте своего бота, нажмите «Старт», потыкайте кнопки: карта с QR, меню, бронь. Всё, что видите вы — увидят гости. Быстрая сверка без телефона — макет чата на вкладке «Меню»: он собирает то же меню и те же ответы, что и живой бот.

Шаг 6. Раздайте ссылку

t.me/ваш_бот — в соцсети, на столы (QR), в чеки. Для каждого канала добавляйте свою метку: t.me/ваш_бот?start=utm_instagram — вкладка «Когорты» потом покажет, какой канал приводит гостей.

← Вся документация Открыть кабинет →