Телеграм-бот

Телеграм-бот — это точка входа для покупателей в мини-приложение через Телеграм. Создаётся через @BotFather.

Что такое BotFather#

BotFather — официальный бот Телеграм для создания и управления ботами. Найди его в поиске: @BotFather. Все действия можно выполнять двумя способами: через команды в чате или через мини-приложение BotFather (кнопка «Open App»)

Шаг 1: Создание бота#

Через команды:

Открой @BotFather → отправь /newbot
Введи название бота — например, Кофейня Рокет
Введи имя пользователя — должен заканчиваться на bot, например rocket_coffee_bot
BotFather ответит сообщением с токеном

Через мини-приложение:

Открой @BotFather → нажми кнопку «Open App»
Нажми «Create Bot» → заполни название и имя пользователя
После создания скопируй токен

Шаг 2: Получение токена#

Токен — секретный ключ бота. Он нужен для подключения бота к серверу Нямбота: отправка сообщений, приём заказов, уведомления. Без токена бот не будет работать

Через команды: /mybots → выбери бота → API Token → Copy

Через мини-приложение: выбери бота → нажми Copy на токене

Не публикуй токен нигде. Если скомпрометирован — /revoke в BotFather

Шаг 3: Настройка бота (Edit Info)#

Через команды: /mybots → выбери бота → Edit Bot → Edit Info

Через мини-приложение: выбери бота → раздел Info

Что настроить:

Название и описание — краткое описание бота, видно в профиле
Изображение приветственного сообщения (Set Welcome Picture) — это фото будет показано покупателю при загрузке мини-приложения и в приветственном сообщении бота. Не связано с аватаркой BotFather
Текст приветственного сообщения формирует Нямбот автоматически из данных формы бота в СРМ

Шаг 4: Настройка кнопки мини-приложения#

Через команды: /mybots → выбери бота → Bot Settings → Menu Button → Configure menu button → URL: https://app.nyambot.ru

Через мини-приложение: выбери бота → раздел Mini Apps. Здесь нужно заполнить два пункта:

Кнопка в нижнем левом углу чата, которая открывает мини-приложение:

Нажми Menu Button → укажи URL: https://app.nyambot.ru

🔴 Адрес бери из карточки бота в СРМ, а не отсюда. После того как бот добавлен в СРМ (шаг 5), в его карточке появляется строка «Адрес для кнопки меню в BotFather» с кнопкой «Скопировать» — там тот же адрес, но с параметром в конце. Он показывает гостю логотип твоего заведения на первом же экране загрузки; без параметра первый вход встречает пустой кружок. Кнопки, которые бот отправляет сам (подтверждение номера, рассылка «блюдо дня»), параметр проставляют автоматически — руками он нужен только здесь и в Main App.

После настройки в чате с ботом появится кнопка — при нажатии откроется мини-приложение

Main App#

Основное мини-приложение, которое открывается при нажатии «Open App» на странице бота:

Нажми Main App → укажи URL: https://app.nyambot.ru
В разделе Launch Mode выбери Fullsize — это обеспечивает корректное отображение мини-приложения на весь экран
Нажми Save

Шаг 5: Добавление бота в СРМ#

Открой раздел Боты → Боты
Нажми «+ Добавить ТГ бота»
Заполни форму:
- Приветственное сообщение — текст для новых пользователей при первом запуске (до 100 символов)
- Описание — краткое описание бота (до 200 символов)
- Название кнопки — текст кнопки для открытия мини-приложения (например, «Открыть меню»)
- Изображение — фото, которое увидит покупатель при загрузке мини-приложения. Для Телеграм в приветственном сообщении используется аватарка из BotFather (Set Welcome Picture)
- Токен — вставь токен из BotFather. Токен необходим для работы бота: подключение к Телеграм API, отправка сообщений, приём заказов и уведомлений
- Торговые точки — выбери, какие точки обслуживает бот
Нажми «Создать»

Один бот — один сервис. Телеграм отдаёт сообщения бота только одному получателю. Если бот уже подключён к другому сервису — конструктору сценариев, рассылке, своей интеграции, — после подключения к Нямботу они перестанут получать сообщения. Нужны оба: заведи отдельного бота у @BotFather и подключи к Нямботу его.

Где взять данные бота (ID, имя, имя пользователя)#

Если автоматический запрос не сработал (сетевые ограничения) — включи ручной режим в форме и введи данные вручную:

Username — отображается под именем бота в BotFather (например, @test_1_nyambot). Вводи без @
Имя бота — заголовок на странице бота в BotFather
ID бота — число из токена до двоеточия. Скопируй токен, возьми число до : (например, из 123456789:ABCdef... → ID = 123456789)

Управление ботом в BotFather#

Команда	Что делает
`/mybots`	Список твоих ботов
`/setname`	Изменить имя бота
`/setdescription`	Описание (при первом открытии)
`/setabouttext`	Краткое описание в профиле
`/setuserpic`	Аватарка бота
`/deletebot`	Удалить бота (необратимо)
`/token`	Получить токен повторно
`/revoke`	Аннулировать токен и создать новый

Важные моменты#

Один токен = один бот = одна запись в СРМ
Бот в СРМ можно редактировать (приветствие, кнопку, точки) без пересоздания в BotFather
Ссылка на бота формируется автоматически: https://t.me/{username}

Команды бота для покупателя#

Покупатель может отправить боту следующие команды:

/start — приветственное сообщение, запрос контакта при первом запуске
/menu — открыть мини-приложение с меню
/stop — отписаться от маркетинговых рассылок этого бота. Покупатель больше не получает предложения дня, рассылки по сегментам и другую рекламу от этого конкретного бота. Заказы и статусы уведомлений продолжают приходить без изменений
/start_offers — возобновить подписку на рассылки этого бота

Отписка персональна для каждого бота. Если покупатель отписался в боте компании A, он продолжит получать рассылки от бота компании B — согласие на маркетинг по закону требуется отдельно для каждого отправителя.

Связь с другими разделами#

Добавление бота в СРМ → СРМ — Боты
Лимит ботов → СРМ — Лицензия
Как покупатель видит бот → Мини-приложение — Обзор