Боты

Раздел «Боты» — подключение и управление Телеграм-ботами и MAX-ботами, через которые покупатели попадают в мини-приложение.


Страница ботов#

На странице две отдельные таблицы:

  • ТГ боты — с кнопкой «+ Добавить ТГ бота»
  • MAX-боты — с кнопкой «+ Добавить MAX бота»

Над таблицами — блок «Боты по мессенджерам» с общей статистикой: количество ботов и привязанных торговых точек по каждому мессенджеру.

Каждая таблица показывает: изображение, имя бота, имя пользователя, ID, привязанные торговые точки, дату создания и действия.


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

Как создать бота в Телеграм#

Перед добавлением бота в СРМ его нужно создать в Телеграм через BotFather. Подробная инструкция → Телеграм-бот.

Кратко:

  1. Открой @BotFather в Телеграм
  2. Отправь /newbot
  3. Введи название и имя пользователя (должен заканчиваться на bot)
  4. Скопируй полученный токен

Форма добавления Телеграм-бота#

  • Изображение — фото бота (загружается отдельно, не из Телеграм). Показывается в мини-приложении
  • Приветственное сообщение — текст, который получает новый пользователь при первом запуске. Напиши что-то приветливое: «Привет! Добро пожаловать в [название кафе] 👋»
  • Описание — краткое описание бота для покупателей
  • Название кнопки — текст кнопки, которая открывает мини-приложение. Например: «Открыть меню», «Сделать заказ»
  • Ссылка на MAX бота — если есть MAX-бот, укажи ссылку — она будет в приветственном сообщении
  • Токен — вставь токен из BotFather
  • Торговые точки — выбери, какие точки обслуживает этот бот

После нажатия «Создать» бот запускается и готов принимать покупателей.

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


MAX-боты#

Как создать бота в MAX#

Требуется регистрация на bid.max.ru как ИП или ООО. Подробная инструкция → MAX-бот.

Форма добавления MAX-бота#

  • Изображение — фото бота (512×512 px рекомендуется), круглая обрезка (как аватар в мессенджере)
  • Приветственное сообщение — текст для новых пользователей (до 100 символов)
  • Описание — краткое описание (до 200 символов)
  • Название кнопки — поле заполнено значением «Открыть» и не редактируется. Название кнопки задаётся платформой MAX в партнёрской панели
  • Ссылка на MAX бота — ссылка на бота в MAX, будет в приветственном сообщении
  • Токен — вставь токен из партнёрской панели MAX (только сам токен, без слова «токен»)
  • Кнопка «Запросить данные в MAX» — нажми после ввода токена. Система автоматически подтянет ID, имя и имя пользователя из MAX
  • Торговые точки — выбери точки (одна точка — один MAX-бот)

Важно: Одна торговая точка может быть привязана только к одному MAX-боту. Токен хранится в зашифрованном виде.


Смена токена у живого бота#

Токен меняется правкой бота — и Телеграм, и MAX. Открой бота на редактирование и вставь новый токен в поле «Токен».

🔴 Поле открывается ПУСТЫМ, и пустое значит «не менять». Сохранил, не тронув поле, — токен остался прежним. Это не потерянное значение: старый токен не показывается никому, он хранится зашифрованным.

Бот переподключается сам, перезапускать ничего не нужно.

🔴 Токен при правке не проверяется в Телеграме. Телеграм недоступен из России без прокси, и проверка отказывала бы законной смене. Ошиблись в токене — это покажет сторож приёма обновлений: бот перестанет отвечать, и в мониторинге появится отказ. Проверь бота сообщением сразу после смены.

⚖️ Меняй токен правкой, а не пересозданием бота. Удаление бота уносит каскадом привязку точек, владельцев и регистрации гостей — заново регистрироваться придётся всем, кто уже нажимал «Старт».


Лимиты ботов#

Количество ботов ограничено лицензией. Телеграм-боты и MAX-боты считаются вместе. Например, при лимите 6 ботов можно создать 3 ТГ + 3 MAX = 6 ботов.

Сам лимит в заголовке раздела («Мои боты (2 из 5)») видит только Владелец — как и всё остальное про лицензию → Роли.

При достижении лимита кнопка добавления блокируется — нужно обновить лицензию в разделе Лицензия.


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

  • Редактировать — изменить приветствие, описание, привязанные точки, изображение
  • Удалить — бот полностью удаляется из системы. Токен можно переиспользовать

🔴 Удаление бота — Телеграм или MAX — удаляет и регистрации гостей в нём — вместе с согласием на обработку данных и подпиской на рекламу. Согласие живёт в ботах, которые обслуживают твои точки, поэтому:

  • есть другой твой бот, где гость уже был, — согласие остаётся там, и ничего спрашивать заново не нужно;
  • удалённый бот был единственным (или гость заходил только в него) — в новом боте гость для тебя новичок: бот снова спросит номер и согласие, а на рекламу он подписывается заново. То же, если перевесить все точки на нового бота: бот без точек согласие не держит.

История заказов в твоих точках при этом не пропадает: гость, который у тебя заказывал, остаётся в «Клиентах». Это штатное поведение, а не сбой: согласие хранится вместе с регистрацией гостя в твоём боте, и когда таких регистраций не осталось, подтвердить его нечем — Нямбот не вправе считать, что человек согласился снова.


Уведомления покупателям#

Боты автоматически отправляют уведомления покупателям:

  • Статус заказа — готовится, в доставке, доставлен, отменён, задержка курьера
  • Предложения дня — ежедневные предложения по расписанию

Если покупатель пользуется и Телеграм, и MAX — уведомления приходят в оба мессенджера одновременно, независимо от того, где был сделан заказ.


Сколько ботов нужно сети#

🔴 Один бот на вывеску — это норма. Гость открывает приложение и выбирает точку: ближайшую, по городу или поиском. Заводить бота под каждую точку не надо — это дробит вход и путает гостя.

Второй бот заводят, когда:

  • у точек разные концепции — кофейня и пиццерия, две вывески → Бренд и мультибренд;
  • нужен запасной канал.

Перевесить точки на другого бота можно списком или группой целиком → Много точек сразу. Перевес — это замена: точку обслуживает один бот каждого мессенджера.

🔴 Точка без бота гостю не показывается вовсе. Это первая причина, по которой «точка есть, а в приложении её нет».

Ссылку на бота бери здесь же, а QR-код — в блоке «Общий QR-код» (его можно сделать и на одного бота). С них начинается путь гостя → Как привлекать гостей.


Общий QR-код#

Под «Ботами по мессенджерам» — блок «Общий QR-код»: один код на MAX и Телеграм, гость сам выбирает мессенджер. На ту же страницу можно поставить свой сайт и приложение заведения → Сайт и приложение. Там же скачиваешь код в PNG и SVG, видишь переходы и можешь поставить код на свой домен → Общий QR-код.

🔴 До печати прочитай, где живёт адрес кода. Код с адресом Нямбота работает, пока ты работаешь с Нямботом; код на своём домене остаётся твоим.


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