Телеграм бот
Раздел настраивает телеграм-бота заведения: через него гость выбирает торговую точку, собирает корзину по внешнему меню и оформляет заказ. Бот создаётся в Telegram у @BotFather, а в каби нете указываются его токен и правила работы — какие точки обслуживает, по какому меню и ценам продаёт, какие типы доставки и оплаты доступны.
Страница — одна форма настроек, а не список: у кабинета один бот. При первом сохранении бот создаётся, при последующих — обновляется.
Где находится
Внешние сервисы → Телеграм бот.
Форма настроек
123456789101112131415161718192021222324252627
Обзор интерфейса по номерам
| № | Элемент | Что делает |
|---|---|---|
| 1 | Телеграм бот | Заголовок раздела. |
| 2 | Кнопка со значком вопроса | Открывает окно Информация — инструкцию по созданию бота в @BotFather. |
| 3 | Название | Обязательное. Внутреннее название бота в кабинете. |
| 4 | Название бренда | Название, которое видит гость в интерфейсе бота. |
| 5 | URL | Ссылка вида https://tg.mison.uz/... — адрес мини-приложения. Поле только для чтения, его нужно скопировать в настройки бота в Telegram. |
| 6 | TELEGRAM TOKEN | Обязательное. Токен, выданный @BotFather при создании бота. |
| 7 | Ресторан загрузки цен | Обязательное. Торговая точка, из прайса которой бот берёт цены. |
| 8 | Правила доставки | Обязательное. Правило расчёта стоимости доставки (например, Фиксированный). |
| 9 | Внешнее меню | По какому меню бот продаёт. Основное меню — меню кабинета, остальные значения — меню из раздела Внешнее меню. |
| 10 | Язык по умолчанию | Обязательное. Язык, на котором бот отвечает до выбора языка гостем. |
| 11 | Языки для клиента | Обязательное, минимум один. Языки, между которыми гость может переключаться. Язык по умолчанию добавляется сюда автоматически. |
| 12 | Зал | Обязательное. Подтип заказа, которым оформляются заказы в зале. |
| 13 | Собой | Обязательное. Подтип заказа для самовывоза. |
| 14 | Доставка | Обязательное. Подтип заказа для доставки. |
| 15 | Минимальная сумма заказа | Сумма, ниже которой заказ в боте не оформляется. Пусто — ограничения нет. |
| 16 | Типы оплат | Обязательное. Способы оплаты, доступные гостю в боте. |
| 17 | Видео при старте бота | Файл, который бот отправляет при первом запуске. Загруженный файл убирается красной кнопкой. |
| 18 | Оценка заказа | Бот просит гостя оценить выполненный заказ. |
| 19 | ОТП код при регистрации | Подтверждение номера телефона кодом при регистрации. |
| 20 | Отправлять локацию клиента в группу | В телеграм-группу с заказами приходит геометка гостя. |
| 21 | Авто подтверждение заказа | Заказ из бота подтверждается автоматически, без ручного подтверждения оператором. |
| 22 | Доступ только внутренним клиентам | Бот работает только для клиентов из базы кабинета. |
| 23 | Показать долг клиента | Гость видит в боте свою задолженность. |
| 24 | Текст при старте бота | Приветственное сообщение по команде /start. |
| 25 | Торговые точки | Список точек кабинета. Переключатель в строке включает точку в бота: выключенные точки гость не видит. |
| 26 | Отмена | Уходит со страницы без сохранения. |
| 27 | Сохранить | Сохраняет настройки: при первом нажатии создаёт бота, дальше — обновляет. |
Как подключить бота
- Создайте бота в Telegram у @BotFather командой
/newbotи получите токен. - Вставьте токен в 6 — TELEGRAM TOKEN и заполните 3 — Название.
- Выберите 7 — Ресторан загрузки цен и 8 — Правила доставки.
- Укажите 9 — Внешнее меню, по которому бот будет продавать.
- Задайте 10 — Язык по умолчанию и 11 — Языки для клиента.
- Проставьте подтипы заказа для 12 — Зал, 13 — Собой и 14 — Доставка.
- Выберите 16 — Типы оплат.
- Включите переключатели нужных точек в таблице 25 — Торговые точки.
- Нажмите 27 — Сохранить.
- Скопируйте ссылку из 5 — URL и подключите её в @BotFather как кнопку меню и как Mini App — порядок описан в окне 2.
Окно «Информация»
Кнопка 2 открывает памятку по настройке бота на стороне Telegram.
В памятке пять блоков:
- Как создать бота —
/newbotу @BotFather, название и ник бота, получение токена. - Контекстное меню —
/mybots→ бот → Bot Settings → Menu Button → Configure menu button, отправить ссылку из поля 5 — URL. - Mini App —
/mybots→ бот → Bot Settings → Configure Mini App → Enable Mini App, та же ссылка. - Получать заказы в телеграм-группу — создать приватную группу, добавить туда бота, скопировать id группы (отрицательное число) и вставить его в Telegram ID.
- Получать жалобы и предложения — так же, но id вставляется в поле группы для жалоб.
Примечание
Поля Telegram ID и «ID группы для жалоб», о которых говорит памятка, на этой странице не выводятся. Где они задаются в текущей версии кабинета — вопрос открытый.
Проверки перед сохранением
| Что проверяется | Когда сохранение не проходит |
|---|---|
| Название | Поле пустое. |
| TELEGRAM TOKEN | Поле пустое. |
| Ресторан загрузки цен | Точка не выбрана. |
| Правила доставки | Правило не выбрано. |
| Язык по умолчанию | Язык не выбран. |
| Языки для клиента | Не выбран ни один язык. |
| Тип доставки | Подтипы заданы не для всех трёх типов — зала, самовывоза и доставки. Ошибка: «Укажите подтипы для зала, самовывоза и доставки». |
| Типы оплат | Не выбран ни один способ оплаты. |
| Внешнее меню | Значение должно быть числом или пустым (Основное меню). |
| Торговые точки | Список точек должен быть передан, у каждой точки переключатель включён или выключен. |
Чт о происходит после сохранения
- При первом сохранении создаётся внутренняя интеграция канала продаж Telegram бот, и к ней привязывается запись бота.
- Сохраняются выбранные точки: заказы принимаются только из тех, у которых переключатель в таблице 25 включён.
- Список языков гостя и подтипы заказа для зала, самовывоза и доставки перезаписываются целиком по тому, что задано в форме.
- Цены в боте берутся из прайса точки 7 — Ресторан загрузки цен, состав меню — из 9 — Внешнее меню.