Telegram — токен бота и привязка чата

BotFather, создание бота, токен, привязка персонала, уведомления о заказах.

Telegram — токен бота и привязка чата

Telegram-бот нужен для:

  • Уведомления о заказах — кухне, официантам, курьерам.
  • Отправка чеков гостю после оплаты.
  • Курьерский модуль — назначения, статусы.
  • Бот для персонала — открытие смены, «сколько я заработал» (см. Официант через Telegram-бот).

Один токен обслуживает всё сразу — не нужно создавать несколько ботов.

Шаг 1. Создать бота через BotFather

  1. В Telegram найдите @BotFather (официальный — с синей галочкой).
  2. Команда /newbot.
  3. BotFather спросит:
    • Имя бота — отображается в шапке, например «Кафе Misea». Может быть на русском.
    • Username — должен заканчиваться на bot. Пример: cafe_misea_bot. Проверяется на уникальность.
  4. После создания BotFather пришлёт:
    HTTP API token: 123456789:AAFxxxxxxxxxxxxxxxxxx
    
  5. Скопируйте этот токен — он понадобится.

Никому не давайте токен и не публикуйте в открытых чатах. Кто имеет токен — управляет ботом.

Шаг 2. Настроить бота

В BotFather → /mybots → выберите вашего:

  • Edit Bot Picture — аватарка (лого ресторана, PNG 512×512).
  • Edit Description — описание «Бот сети кафе Misea. Получайте уведомления о заказах.»
  • Edit About — короткий текст, когда бот пересылают.
  • Edit Commands — оставьте пустым, Misea настроит сама.

Шаг 3. Вставить токен в Misea

  1. /settings/integrationsTelegram.
  2. Вставьте токен в поле Bot token.
  3. Сохранить.

Misea проверит — отправит тестовое сообщение через API. Если 🟢 — токен валиден.

Шаг 4. Привязка персонала

Каждому сотруднику, который должен получать уведомления, нужно привязать свой Telegram-чат к его аккаунту в Misea.

Способ 1. Через /start

  1. Сотрудник заходит в Telegram, ищет бот по username (@cafe_misea_bot).
  2. Нажимает Start.
  3. Бот присылает: «Привет! Чтобы связать этот чат с вашим аккаунтом, введите код привязки из Misea».
  4. В админке сотрудник заходит в /profileПривязать Telegram → копирует код (6 цифр).
  5. Вставляет код боту → 🟢 Готово.

Способ 2. Админ привязывает за сотрудника

  1. /users → карточка сотрудника → TelegramОтправить приглашение.
  2. Misea шлёт ссылку вида t.me/cafe_misea_bot?start=abc123.
  3. Сотрудник кликает → автоматически привязывается.

Шаг 5. Настройки уведомлений

/settings/notifications:

  • Новый заказ — кому слать (вся смена / только менеджер / конкретные роли).
  • Отмена заказа — менеджеру.
  • Курьеру — назначение заказа.
  • Доставка выполнена — гостю.
  • Старт / конец смены — сотруднику.

Каждая нотификация можно включить или выключить и выбрать канал (Telegram / push / ничего).

Общий чат ресторана

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

  1. Создайте группу в Telegram → добавьте в неё бота.
  2. Дайте боту права администратора группы.
  3. В Misea → /settings/integrations → Telegram → Добавить канал уведомлений → введите @group_username или chat_id.
  4. В /settings/notificationsНовый заказ → Канал → выберите группу кухни.

Готово — заказы сыпятся в общий чат, каждый, кто «принял», пишет сообщение в чате.

Бот у Misea один на всех

Важно: бот, которого вы создали через BotFather — ваш. Даже если сеть ресторанов использует Misea, каждый бренд заводит свой бот.

Для тестов Misea даёт общий тестовый бот — он годится на trial, но после перехода на Pro лучше сделать свой.

Следующие шаги