Главная Интеграции Мессенджеры Telegram

Telegram

Обновлено Oct 21, 2026

Telegram используется в трёх сценариях. Собственный бот заведения, созданный у BotFather, служит для входа гостя в личный кабинет и как канал связи с гостем в блоке «Репутация». Общий бот Смартомато присылает сотрудникам уведомления о заказах.

Бот заведения: вход гостя и «Репутация»

  • Вход гостя. Гость получает подтверждение в чате с ботом и входит одной кнопкой, без SMS и звонка. По статье для заведения это бесплатно. С мобильного сайта и из приложения сразу открывается установленное приложение Telegram.
  • «Репутация». От имени бота гость получает просьбу оценить заказ и переписывается с оператором.

Что нужно до подключения

  • Имя бота.
  • Описание бота — до 120 символов.
  • Иконка бота с соотношением сторон 1:1.
  • Отдельный бот на каждую организацию, даже в мультибрендовом аккаунте.
  • С одного аккаунта Telegram можно создать не больше 4 ботов в сутки. Дальше придётся ждать до конца дня.

Создание бота в BotFather

Статьи о входе и о «Репутации» приводят одни и те же шаги.

  1. Открыть @BotFather.
  2. «Меню» → команда /newbot.
  3. Ввести название бота, обычно это название заведения. Зачем: оно отображается в шапке чата, от него гость получает сообщения.
  4. Ввести имя бота — адрес, по которому бота находят и добавляют. Имя должно оканчиваться на bot, например smartomato_MyBurger_bot.
  5. Скопировать API-токен, который выдаст BotFather.
  6. «Меню» → /setabouttext → выбрать бота → ввести описание (пример текста для «Репутации» — в исходной статье «Репутация»).
  7. «Меню» → /setuserpic → выбрать бота → загрузить иконку 1:1.

Если бота создаёт поддержка и передаёт клиенту (прежняя схема)

Эти шаги есть только в статье «Telegram» (раздел «Авторизация через мессенджеры»).

  1. На аккаунте Telegram, где создаётся бот и с которого передаются права, должна быть включена двухфакторная авторизация (облачный пароль).

  2. У клиента запрашивают имя пользователя Telegram (через @) — ему будут переданы права на бота.

  3. Регистрируют вебхук бота запросом к Bot API Telegram (в статье — через Postman). Вместо <API_Token> подставляют токен из шага 5.

    curl -F "url=telegram-order-and-auth-bot.smartomato.ru/telegram/<API_Token>/webhook" \
-F "max_connections=40" \
-F "allowed_updates=['message', 'callback_query']" \
https://api.telegram.org/bot<API_Token>/setWebhook
    • Зачем: Telegram начинает пересылать сообщения бота на сервер Смартомато.

  4. Новый владелец хотя бы раз взаимодействует с ботом: авторизуется через него на сайте или в приложении. Без этого права передать не получится.

  5. Передать права: /mybots → выбрать бота → «Transfer Ownership» → «Choose recipient» → указать имя пользователя → подтвердить.

Бот уведомлений о заказах

Уведомления о заказах сотрудникам заведения приходят через общий бот Смартомато @Smartomato_notifications_bot. Бота добавляют в личный чат или в группу смены. Что и по каким ресторанам присылать, настраивается командами в самом боте.

Что нужно до подключения

  • Учётная запись сотрудника в Смартомато — логин и пароль от неё вводятся в боте.

Шаги на стороне Telegram

  1. Написать боту https://t.me/Smartomato_notifications_bot или добавить его в группу.
  2. В группе выдать боту права администратора и доступ к сообщениям. Зачем: без этого бот не сможет писать в группу.
  3. Запустить бота командой /start.
  4. Авторизоваться командой /auth — ввести логин и пароль от учётной записи в Смартомато.
  5. Командой /edit_restaurants выбрать ресторан, по которому нужны уведомления.
  6. При необходимости изменить набор уведомлений командой /notifications_settings.
  7. Проверить работу бота тестовым заказом.

Что умеет бот

  • Уведомления о новых заказах или только об оплаченных.
  • Об отменённых заказах и об оценке заказа.
  • Об ошибке отправки заказа в кассу (если касса подключена).
  • О задолженности по оплате тарифа — только для учётных записей «Администратор».
  • О назначении курьера аутсорс-службы на доставку.
  • В уведомлении о новом заказе — данные заказа (статус, номер, даты, тип и адрес доставки, состав, комментарий, приборы, слот), гостя (имя, кликабельный телефон) и оплаты (способ, статус, сумма, сдача, списанные бонусы).
  • Шаблон уведомления о заказе меняется командой /edit_order_template.

Что передать в Смартомато

Для бота заведения (вход гостя и «Репутация»):

  • API-токен бота.
  • Имя бота (username), которое оканчивается на bot.

Типовые ошибки и вопросы клиентов

Бот заведения

  • BotFather не даёт создать бота. С одного аккаунта создаётся не больше 4 ботов в сутки. Нужно подождать до конца дня.
  • Не получается передать права на бота. Новый владелец ни разу не взаимодействовал с ботом, или на аккаунте, с которого передают права, нет двухфакторной авторизации.
  • Один бот на несколько организаций. Нельзя: у каждой организации свой бот.

Бот уведомлений о заказах

  • Заказ с оплатой «Картой онлайн» пришёл со статусом «не оплачен». Так и должно быть: после оплаты бот обновит это сообщение на актуальный статус и дополнительно пришлёт ответом на него сообщение, что заказ оплачен.
  • Как поменять шаблон уведомления о заказе? Командой /edit_order_template в боте, дальше — по инструкции бота.

Связь заведения с поддержкой Смартомато

Отдельно от ботов заведения: сотрудники заведения пишут в поддержку Смартомато через Telegram-группу с ботом Смартомато.

  1. Создать группу в Telegram и добавить в неё сотрудников, которым нужна связь с поддержкой.
  2. Добавить в группу бота @smartomato_help.
  3. Выдать боту права администратора («Управление группой» → «Администраторы» → «Добавить администратора»).
  4. Включить в группе «Темы».

Каждое обращение становится отдельной темой: новое сообщение в General превращается в тему, к которой подключается сотрудник поддержки; в закрытую тему можно написать снова.

Связанные статьи