Терминология
Здесь собраны ключевые понятия, которые используются в Нямботе. Если встретишь незнакомый термин в другом разделе — возвращайся сюда.
Основные понятия#
Нямбот#
Сервис для автоматизации доставки и онлайн-заказов. Включает в себя несколько приложений: СРМ для управления бизнесом, мини-приложение для покупателей, приложение для сотрудников и боты в мессенджерах Телеграм и MAX.
Нативный Нямбот#
Сценарий работы без интеграции с кассовой системой: меню, цены, скидки, лояльность и заказы полностью ведутся в СРМ Нямбота. Самый простой способ старта. Альтернатива — связка с ПОС (iiko, R-keeper). Подробнее — на странице О Нямботе.
ПОС (кассовая система)#
Система автоматизации заведения, в которой ведутся меню, цены, склад, чеки и продажи: iiko, R-keeper и др. Если торговая точка подключена к ПОС, ценовой движок на ней — это ПОС, а Нямбот выступает витриной и каналом приёма заказов. На одной точке движок ровно один — это исключает «двойную скидку».
СРМ (СРМ)#
Панель управления для владельца бизнеса и сотрудников. Через СРМ добавляются торговые точки, настраивается меню, просматриваются заказы, управляются клиенты, настраивается маркетинг и лицензия. Открывается в браузере на компьютере или планшете.
Мини-приложение#
Веб-приложение, которое открывается прямо внутри Телеграм или MAX без установки отдельного приложения. Покупатель видит меню, добавляет товары в корзину, оформляет заказ и оплачивает — не выходя из мессенджера.
Приложение для сотрудников (Команда)#
Отдельное приложение для персонала заведения. Администратор видит входящие заказы и управляет их статусами. Курьер получает задания на доставку и отмечает их выполнение.
Телеграм-бот#
Бот в мессенджере Телеграм. Когда покупатель пишет боту, он получает приветствие и кнопку для открытия мини-приложения. Создаётся через BotFather в Телеграм.
MAX-бот#
Аналог Телеграм-бота, но для российского мессенджера MAX (от Mail.ru). Работает по той же логике — приветствие и открытие мини-приложения. Требует регистрации как ИП или ООО на bid.max.ru.
Структура бизнеса#
Торговая точка (ТТ)#
Конкретное заведение или место выдачи: кофейня, ресторан, пекарня, магазин. К одной торговой точке привязывается меню, зоны доставки, боты и сотрудники.
Меню#
Самый крупный слой ассортимента. У торговой точки их может быть несколько: «Азиатская кухня», «Европейская кухня», «Напитки». Меню привязывается к торговым точкам.
Группа#
Раздел внутри меню, объединяющий похожие блюда: «Роллы», «Острые супы», «Десерты». В мини-приложении группы показываются вкладками. Слова «категория» интерфейс Нямбота не использует — это и есть группа.
Элемент меню#
Конкретный товар или блюдо: название, описание, цена, фото, калории, вес, состав. Каждый элемент входит в одну группу.
Модификатор#
Параметр блюда, из которого покупатель собирает свой вариант: диаметр пиццы, тип теста, объём напитка. Справочник модификаторов ведёт Нямбот по типам блюд — владелец включает нужные опции, а не заводит свои.
Вариант блюда#
Сочетание опций модификаторов со своей ценой и весом: «30 см, традиционное тесто». Именно варианты покупатель выбирает в карточке блюда.
Тип блюда#
К чему относится блюдо — пицца, напиток, бургер. От типа зависит, какие модификаторы можно предложить.
Ингредиент#
Составная часть блюда: основная, дополнительная или удаляемая. На ингредиентах стоит стоп-лист повара: погас ингредиент — ушли все блюда, где он основной.
Клиенты и заказы#
Клиент#
Гость, который поделился номером телефона и дал согласие в твоём Телеграм- или MAX-боте. В СРМ, в разделе «Клиенты», видны его контакты и история заказов; баллы — в «Маркетинг → Баллы лояльности».
Заказ#
Оформленная покупка. Заказ проходит через статусы: «Ожидает» → «Принят» → «Готовится» → «Готов к доставке» → «В пути» → «Доставлен» (для доставки) или «Ожидает» → «Принят» → «Готовится» → «Готов к самовывозу» → «Выдан» (для самовывоза).
Тип заказа#
- Доставка — курьер везёт заказ по указанному адресу
- Самовывоз — покупатель забирает заказ сам из точки
Онлайн-оплата#
Оплата картой прямо в мини-приложении. Деньги списываются сразу при оформлении заказа. Для работы нужен подключённый онлайн-эквайринг в СРМ (Интеграции → «Оплата») — ЮKassa или Яндекс.Пэй. Для покупателя разницы нет: он просто нажимает «Онлайн».
Статусы заказа#
Заказ последовательно проходит этапы: Ожидает (создан) → Принят (подтверждён, ещё можно отменить) → Готовится → Готов к доставке / Готов к самовывозу → В пути (доставка) → Доставлен / Выдан. Переход «Принят → Готовится» делает администратор или повар в приложении «Команда»; на ПОС-точках статусы синхронизируются из кассы, а на R-keeper с доставкой Нямбота «Готов», «В пути» и «Доставлен» курьерского заказа ставят в «Команде». Из СРМ статусы не двигаются — там карточка заказа только для чтения.
Пометка кассиру#
Строка Нямбота в заказе кассы — сведения или просьба для кассира: Нямбот: курьер …, Нямбот: доставлен курьером … — получить … руб. наличными, Нямбот: отменён … — сними заказ в кассе. На R-keeper — в комментарии заказа, на iiko — флагом «проблема» в окне доставок. Заказ в кассе закрывает и снимает только кассир: Нямбот оплату курьера не вносит и принятый кассой заказ не снимает. Каждую пометку дублирует уведомление «Пометка кассиру в заказе кассы» → Администратор смены.
Возврат#
Возврат денег покупателю за оплаченный онлайн заказ. Инициируется при отмене заказа; для онлайн-оплаты средства автоматически возвращаются на карту. Управляется в СРМ (Продажи) и приложении Команда.
Роли и кухня#
Владелец#
Главный аккаунт бизнеса: полный доступ ко всем настройкам, лицензии и финансам. Добавляет торговые точки, сотрудников и интеграции.
Администратор#
Сотрудник, который принимает заказы и управляет их статусами в приложении Команда (если доставку ведёт касса — только смотрит их; на R-keeper с доставкой Нямбота ведёт курьерские заказы, а кухня остаётся в кассе). Назначает курьеров. В СРМ не заходит, доступа к лицензии и финансам не имеет. Пока он на смене, отвечает гостям и получает уведомления точки в боте уведомлений Нямбота → Администратор смены.
Смена администратора#
Время, когда администратор получает уведомления точки и вопросы гостей: начинается кнопкой «Принять смену» в боте уведомлений, заканчивается кнопкой «Сдать смену» → Администратор смены.
Повар#
Роль сотрудника для кухни. Работает на кухонном экране (KDS) в приложении Команда: видит заказы в готовке, отмечает их готовыми, ведёт стоп-лист по ингредиентам. Доступа к курьерам, возвратам и финансам нет. Повар в «Команде» — только на точке без кассы: с кассой кухня работает в ней.
Курьер#
Сотрудник, который получает задания на доставку в приложении Команда и отмечает их выполнение. Работает на точке без кассы и на R-keeper, где доставку ведёт Нямбот.
KDS (кухонный экран)#
Kitchen Display System — экран повара в приложении Команда, на котором отображаются заказы в работе. Повар отмечает позиции готовыми и управляет стоп-листом.
Маркетинг#
Акция (скидка)#
Снижение цены для определённых условий: скидка на весь заказ, на группу меню или на конкретное блюдо. Настраивается в разделе «Маркетинг» СРМ.
Подарок#
Бесплатная позиция, которую получает гость при выполнении условия (например, при заказе от 1000 рублей). Добавляется автоматически в корзину.
Промокод#
Общий код, который гость вводит в мини-приложении, чтобы получить скидку, подарок или баллы. Один заказ — один промокод. Коды создаются в разделе «Маркетинг» СРМ.
Предложение дня#
Блюдо по особой цене в выбранные дни, с рассылкой гостям в Телеграм и MAX. Можно ограничить: не больше N порций в заказе — сверх лимита порции идут по цене меню.
Сегмент гостя#
Группа, в которую Нямбот сам относит гостя по его успешным заказам: «Постоянные», «Регулярные», «Новые», «Уснувшие», «Ушедшие», «Без заказов». Видна в разделе «Клиенты» колонкой и фильтром → Сегменты гостей.
Рассылка (по сегменту)#
Сообщение в бот гостям выбранных сегментов и точек — сразу или в назначенное время, с 10:00 до 21:00 по времени точки. Уходит только тем, кто согласился на рекламу, и не чаще раза в 7 дней на гостя → Маркетинг → Рассылки.
Не суммируется / Одна на выбор#
Галочка у акции, промокода и предложения дня: такая выгода не складывается ни с какой другой скидкой заказа. Если таких выгод в корзине несколько, гость выбирает одну — карточки подписаны «Одна на выбор». Баллы работают как обычно.
Баллы лояльности#
Система накопительных баллов: гость получает баллы за заказ и может частично оплатить ими следующий. 1 балл = 1 рубль. Начисление заводится акцией типа «Баллы», вкладкой «Баллы на позицию» или промокодом — общего процента «на всё» нет. Баллы ложатся на баланс после оплаты онлайн или при выдаче заказа. Списание ограничивается в самой программе лояльности.
Программа лояльности#
Общая настройка списания баллов для группы точек одного юрлица: можно ли платить баллами, сколько процентов от суммы за еду и сколько рублей максимум. Баланс гостя в каждой программе свой.
Купон#
Код из заранее созданной серии, дающий скидку или подарок. В отличие от промокода Нямбота, на ПОС-точках (iiko) купоны ведутся на стороне кассы (iikoCard). В мини-приложении поле «Промокод» на iiko-точке работает как купон iikoCard.
Комбо#
Набор из нескольких блюд по специальной цене (например, «2 пиццы + напиток»). Гость собирает комбо в мини-приложении, выбирая по позиции из каждой группы. На iiko-точках комбо заводятся в iikoCard, цену считает касса.
Платежи#
ЮКасса#
Платёжный сервис для приёма онлайн-оплаты картами. Нямбот интегрирован с ЮКассой — покупатели оплачивают заказы прямо в мини-приложении. Подробнее в разделе ЮКасса.
Яндекс.Пэй#
Альтернативный эквайринг для онлайн-оплаты (вместо ЮКассы). Подключается по Merchant ID и Merchant API key, есть тестовый режим. На одной торговой точке используется один эквайринг — ЮКасса или Яндекс.Пэй. Подробнее в разделе Яндекс.Пэй.
Магазин ЮКассы#
Зарегистрированный магазин в личном кабинете ЮКассы. У каждого магазина есть свой shopId и секретный ключ, которые вводятся в настройках торговой точки в СРМ.
Интеграции (ПОС)#
iiko#
Система автоматизации ресторанов. Нямбот интегрируется с iiko через iikoCloud API: меню, стоп-листы, заказы и статусы синхронизируются между Нямботом и iiko. Подробнее — в разделе Интеграции → iiko.
R-keeper#
Ещё одна система автоматизации ресторанов. Нямбот интегрируется с R-keeper через White Server (WS) API по той же модели, что и iiko: меню, заказы, статусы, стоп-листы, скидки и комбо. Подробнее — в разделе Интеграции → R-keeper.
iikoWeb / iikoOffice / iikoFront#
Части экосистемы iiko: iikoWeb — веб-кабинет (Cloud API, внешнее меню, простые скидки «Дисконт»); iikoOffice — бэк-офис (настройка iikoCard, типы оплат, сопоставление акций); iikoFront — касса на терминале, куда падают заказы.
iikoCard (m1.iiko.cards)#
Модуль и кабинет лояльности iiko (https://m1.iiko.cards). Здесь заводятся бонусные программы (баллы), скидки, подарки, купоны и комбо — в том числе сложные и комбинированные программы. Простые скидки можно вести и в iikoWeb («Дисконт»).
iikoCloud API#
Облачный API iiko, через который Нямбот обменивается данными с рестораном (меню, заказы, доставка, лояльность). Доступ к нему даёт API-ключ.
API-ключ (apiLogin)#
Секретный ключ интеграции, который выдаётся в iikoWeb («Настройки Cloud API» → «Добавить интеграцию»). Вводится в СРМ при подключении iiko и хранится в зашифрованном виде (AES-256-GCM) — после сохранения не отображается.
Внешнее меню iikoWeb#
«Витрина» меню в iikoWeb с фото, названиями и ценами. Нямбот синхронизирует меню только из внешнего меню (не из общей номенклатуры) — оно даёт чистые категории и отдельные модификаторы. Рекомендуется собирать его автоматической генерацией.
ID внешнего меню (menu_id)#
Числовой идентификатор внешнего меню iiko. Руками его вводить не нужно: при подключении СРМ сама запрашивает список меню у iiko, и ты отмечаешь нужные по названиям (выбрать хотя бы одно обязательно). ID пригодится, только чтобы различить меню с похожими названиями, — он виден в адресной строке при открытии меню в iikoWeb.
Организация и терминальная группа#
Организация — юрлицо/ресторан в iiko. Терминальная группа — касса (iikoFront), куда падают заказы. Обе выбираются в СРМ после проверки соединения.
Стоп-лист#
Список позиций «нет в наличии». Для iiko-точек обновляется автоматически (вебхуки + синхронизация), позиции из стоп-листа недоступны к заказу в мини-приложении.
Модификатор iiko#
Дополнение к блюду из iiko (например, «Добавки», «Бортик»). Импортируется отдельно от категорий и показывается на вкладке «iiko» страницы «Модификаторы» в СРМ (только для чтения).
Тип оплаты iiko#
Способ оплаты в справочнике ресторана. При подключении каждый способ оплаты Нямбота (онлайн, наличные, карта) сопоставляется с типом оплаты iiko — без этого заказ уйдёт в iiko с ошибкой.
iikoDelivery#
Модуль iiko для управления доставкой и курьерами. Если подключён, в настройках подключения можно передать управление доставкой на сторону iiko.
Сопоставление акций и скидок (маппинг)#
Обязательный шаг в iikoOffice: каждую программу лояльности нужно сопоставить со скидкой iikoCard, иначе касса не применит скидку и вернёт ошибку «iikoCard is not enabled». Делается в «Настройка iikoCard → Сопоставление акций и скидок».
Пересинк кассы#
Повторная синхронизация настроек с кассой после изменения программы лояльности. Без него касса крутит старую конфигурацию, и превью скидки в мини-приложении расходится с чеком. Порядок: Переподключиться → Получить маркетинговые акции → Сохранить → Обновить состояние.
Сеть и франшиза#
Аккаунт#
Кабинет одного владельца — и граница всего: гостей, их баллов, персонала, эквайринга и лицензии. 🔴 Граница аккаунта совпадает с границей юрлица, а не с географией: разные юрлица — разные аккаунты, даже под одной вывеской. Подробно — Сеть: с чего начать.
Бренд (вывеска)#
То, что видит гость: меню-эталон, акции, оформление витрины и бот. Точка принадлежит одному бренду; в одном аккаунте брендов может быть несколько (мультибренд) → Бренд и мультибренд.
Меню-эталон#
Меню бренда, действующее на всех его точках Нямбота. Точка может от него отклоняться ценой, наличием позиции и стоп-листом. 🔴 На точках iiko и R-keeper эталон не применяется: там источник меню — касса.
Группа точек#
Именованный набор точек. Четыре типа: куст, регион, расчётная и франчайзи → Группы точек.
Куст#
Управленческий кластер точек: за ним закрепляется территориальный управляющий. У точки кустов может быть несколько.
Расчётная группа#
Набор точек с общими реквизитами плательщика — кто платит по этим точкам. 🔴 У точки она ровно одна → Кто и за что платит.
Назначение#
Выдача доступа: человек + роль + охват (точки, группа точек или бренд). Всё, что вне охвата, для человека не существует → Кто заходит в кабинет.
Роли кабинета#
Владелец, Территориальный управляющий, Управляющий ТТ, Наблюдатель, Бренд-менеджер. ⚖️ Не путать с ролями смены (Администратор, Курьер, Повар) — те работают в «Команде» и в кабинет не заходят.
Франчайзи#
Отдельный аккаунт со своим юрлицом, работающий под вывеской бренда. Головной офис видит по его точкам только сводные показатели → Франшиза.
ТТ-месяц#
Единица расчёта и отчёта в сети: одна торговая точка за один месяц работы. Временная точка считается за фактический срок. 🔴 Это единица счёта, а не способ списания: автосписаний нет.
Передача точки#
Перевод торговой точки в кабинет другого владельца. С точкой уезжают меню, настройки и обезличенная история продаж; гости, их контакты и баллы остаются у прежнего владельца. 🔴 Необратима → Кейс 13.
Лицензия#
Лицензия#
Подписка на использование Нямбота. Определяет, сколько торговых точек, Телеграм-ботов и MAX-ботов можно подключить. Лицензия привязана к аккаунту владельца.
Лимиты лицензии#
Максимальное количество: торговых точек, ботов (ТГ + MAX считаются вместе). При достижении лимита новые боты или точки добавить не получится — нужно обновить лицензию.
Технические термины#
initData#
Данные авторизации, которые Телеграм или MAX передают в мини-приложение при открытии. Нямбот использует их для автоматической авторизации покупателя без ввода логина и пароля.
Токен бота#
Уникальный секретный ключ бота, который выдаётся при создании бота в BotFather (Телеграм) или партнёрской панели MAX. Используется для подключения бота к Нямботу в разделе «Боты» СРМ.
Сотрудник#
Здесь два разных значения. Сотрудник кабинета — человек, которого владелец пригласил в СРМ по почте в разделе «Сотрудники кабинета»: видит то, что даёт его роль и охват, лицензии и эквайринга не видит никогда → Кто заходит в кабинет. Сотрудник смены — администратор, курьер или повар в приложении «Команда»: заводится в разделе «Пользователи», входит по логину и PIN-коду, в СРМ не заходит → Сотрудники.
ИИ-ассистент#
Встроенный в СРМ чат-бот на основе искусственного интеллекта (помощник Аня). Помогает быстро найти нужную информацию, подсказать по настройке и объяснить, что делает конкретное поле или переключатель. Отвечает только по Нямботу — кабинет, мини-приложение, «Команда» и это руководство; на посторонние вопросы вежливо откажет. Есть предел частоты: 10 вопросов в минуту и 100 в сутки на аккаунт. Иконка ассистента находится в правом нижнем углу СРМ.