Telegram-бот

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

Что такое BotFather

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Main App

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

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

Шаг 5: Добавление бота в CRM

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

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

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

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

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

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

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

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

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

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

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

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

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

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