Терминология

Здесь собраны ключевые понятия, которые используются в Нямботе. Если встретишь незнакомый термин в другом разделе — возвращайся сюда.

Основные понятия#

Нямбот#

Сервис для автоматизации доставки и онлайн-заказов. Включает в себя несколько приложений: СРМ для управления бизнесом, мини-приложение для покупателей, приложение для сотрудников и боты в мессенджерах Telegram и MAX.

Нативный Нямбот#

Сценарий работы без интеграции с кассовой системой: меню, цены, скидки, лояльность и заказы полностью ведутся в СРМ Нямбота. Самый простой способ старта. Альтернатива — связка с POS (iiko, R-keeper). Подробнее — на странице О Нямботе.

POS (кассовая система)#

Система автоматизации заведения, в которой ведутся меню, цены, склад, чеки и продажи: iiko, R-keeper и др. Если торговая точка подключена к POS, ценовой движок на ней — это POS, а Нямбот выступает витриной и каналом приёма заказов. На одной точке движок ровно один — это исключает «двойную скидку».

СРМ (CRM)#

Панель управления для владельца бизнеса и сотрудников. Через СРМ добавляются торговые точки, настраивается меню, просматриваются заказы, управляются клиенты, настраивается маркетинг и лицензия. Открывается в браузере на компьютере или планшете.

Мини-приложение#

Веб-приложение, которое открывается прямо внутри Telegram или MAX без установки отдельного приложения. Покупатель видит меню, добавляет товары в корзину, оформляет заказ и оплачивает — не выходя из мессенджера.

Приложение для сотрудников (Команда)#

Отдельное приложение для персонала заведения. Администратор видит входящие заказы и управляет их статусами. Курьер получает задания на доставку и отмечает их выполнение.

Telegram-бот#

Бот в мессенджере Telegram. Когда покупатель пишет боту, он получает приветствие и кнопку для открытия мини-приложения. Создаётся через BotFather в Telegram.

MAX-бот#

Аналог Telegram-бота, но для российского мессенджера MAX (от Mail.ru). Работает по той же логике — приветствие и открытие мини-приложения. Требует регистрации как ИП или ООО на bid.max.ru.

Структура бизнеса#

Торговая точка (ТТ)#

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

Меню#

Самый крупный слой ассортимента. У торговой точки их может быть несколько: «Азиатская кухня», «Европейская кухня», «Напитки». Меню привязывается к торговым точкам.

Группа#

Раздел внутри меню, объединяющий похожие блюда: «Роллы», «Острые супы», «Десерты». В мини-приложении группы показываются вкладками. Слова «категория» интерфейс Нямбота не использует — это и есть группа.

Элемент меню#

Конкретный товар или блюдо: название, описание, цена, фото, калории, вес, состав. Каждый элемент входит в одну группу.

Модификатор#

Параметр блюда, из которого покупатель собирает свой вариант: диаметр пиццы, тип теста, объём напитка. Справочник модификаторов ведёт Нямбот по типам блюд — владелец включает нужные опции, а не заводит свои.

Вариант блюда#

Сочетание опций модификаторов со своей ценой и весом: «30 см, традиционное тесто». Именно варианты покупатель выбирает в карточке блюда.

Тип блюда#

К чему относится блюдо — пицца, напиток, бургер. От типа зависит, какие модификаторы можно предложить.

Ингредиент#

Составная часть блюда: основная, дополнительная или удаляемая. На ингредиентах стоит стоп-лист повара: погас ингредиент — ушли все блюда, где он основной.

Клиенты и заказы#

Клиент#

Покупатель, который хотя бы раз зарегистрировался через Telegram-бота или MAX-бота (поделился номером телефона). В СРМ можно посмотреть историю заказов, баллы и применённые акции.

Заказ#

Оформленная покупка. Заказ проходит через статусы: «Ожидает» → «Принят» → «Готовится» → «Готов к доставке» → «В пути» → «Доставлен» (для доставки) или «Ожидает» → «Принят» → «Готовится» → «Готов к самовывозу» → «Выдан» (для самовывоза).

Тип заказа#

Доставка — курьер везёт заказ по указанному адресу
Самовывоз — покупатель забирает заказ сам из точки

Онлайн-оплата#

Оплата картой прямо в мини-приложении. Деньги списываются сразу при оформлении заказа. Для работы нужен подключённый онлайн-эквайринг в СРМ (Интеграции → «Оплата») — ЮKassa или Яндекс.Пэй. Для покупателя разницы нет: он просто нажимает «Онлайн».

Статусы заказа#

Заказ последовательно проходит этапы: Ожидает (создан) → Принят (подтверждён, ещё можно отменить) → Готовится → Готов к доставке / Готов к самовывозу → В пути (доставка) → Доставлен / Выдан. Переход «Принят → Готовится» делает администратор или повар в приложении «Команда»; на POS-точках статусы синхронизируются из кассы. Из СРМ статусы не двигаются — там карточка заказа только для чтения.

Возврат#

Возврат денег покупателю за оплаченный онлайн заказ. Инициируется при отмене заказа; для онлайн-оплаты средства автоматически возвращаются на карту. Управляется в СРМ (Продажи) и приложении Команда.

Роли и кухня#

Владелец#

Главный аккаунт бизнеса: полный доступ ко всем настройкам, лицензии и финансам. Добавляет торговые точки, сотрудников и интеграции.

Администратор#

Сотрудник, который принимает заказы и управляет их статусами в приложении Команда и СРМ. Назначает курьеров. Не имеет доступа к лицензии и финансам.

Повар#

Роль сотрудника для кухни. Работает на кухонном экране (KDS) в приложении Команда: видит заказы в готовке, отмечает их готовыми, ведёт стоп-лист по ингредиентам. Доступа к курьерам, возвратам и финансам нет.

Курьер#

Сотрудник, который получает задания на доставку в приложении Команда и отмечает их выполнение.

KDS (кухонный экран)#

Kitchen Display System — экран повара в приложении Команда, на котором отображаются заказы в работе. Повар отмечает позиции готовыми и управляет стоп-листом.

Маркетинг#

Акция (скидка)#

Снижение цены для определённых условий: скидка на весь заказ, на группу меню или на конкретное блюдо. Настраивается в разделе «Маркетинг» СРМ.

Подарок#

Бесплатная позиция, которую получает покупатель при выполнении условия (например, при заказе от 1000 рублей). Добавляется автоматически в корзину.

Промокод#

Уникальный или общий код, который покупатель вводит в мини-приложении для получения скидки или подарка. Коды создаются в разделе «Маркетинг» СРМ.

Баллы лояльности#

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

Программа лояльности#

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

Купон#

Код из заранее созданной серии, дающий скидку или подарок. В отличие от промокода Нямбота, на POS-точках (iiko) купоны ведутся на стороне кассы (iikoCard). В мини-приложении поле «Промокод» на iiko-точке работает как купон iikoCard.

Комбо#

Набор из нескольких блюд по специальной цене (например, «2 пиццы + напиток»). Гость собирает комбо в мини-приложении, выбирая по позиции из каждой группы. На iiko-точках комбо заводятся в iikoCard, цену считает касса.

Платежи#

ЮКасса#

Платёжный сервис для приёма онлайн-оплаты картами. Нямбот интегрирован с ЮКассой — покупатели оплачивают заказы прямо в мини-приложении. Подробнее в разделе ЮКасса.

Яндекс.Пэй#

Альтернативный эквайринг для онлайн-оплаты (вместо ЮКассы). Подключается по Merchant ID и Merchant API key, есть тестовый режим. На одной торговой точке используется один эквайринг — ЮКасса или Яндекс.Пэй. Подробнее в разделе Яндекс.Пэй.

Магазин ЮКассы#

Зарегистрированный магазин в личном кабинете ЮКассы. У каждого магазина есть свой shopId и секретный ключ, которые вводятся в настройках торговой точки в СРМ.

Интеграции (POS)#

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. Указывается в СРМ при подключении (поле обязательно). Проще всего посмотреть его в адресной строке браузера при открытии меню в iikoWeb.

Организация и терминальная группа#

Организация — юрлицо/ресторан в iiko. Терминальная группа — касса (iikoFront), куда падают заказы. Обе выбираются в СРМ после проверки соединения.

Стоп-лист#

Список позиций «нет в наличии». Для iiko-точек обновляется автоматически (вебхуки + синхронизация), позиции из стоп-листа недоступны к заказу в мини-приложении.

Модификатор iiko#

Дополнение к блюду из iiko (например, «Добавки», «Бортик»). Импортируется отдельно от категорий и показывается на вкладке «iiko» страницы «Модификаторы» в СРМ (только для чтения).

Тип оплаты iiko#

Способ оплаты в справочнике ресторана. При подключении каждый способ оплаты Нямбота (онлайн, наличные, карта) сопоставляется с типом оплаты iiko — без этого заказ уйдёт в iiko с ошибкой.

iikoDelivery#

Модуль iiko для управления доставкой и курьерами. Если подключён, в настройках подключения можно передать управление доставкой на сторону iiko.

Сопоставление акций и скидок (маппинг)#

Обязательный шаг в iikoOffice: каждую программу лояльности нужно сопоставить со скидкой iikoCard, иначе касса не применит скидку и вернёт ошибку «iikoCard is not enabled». Делается в «Настройка iikoCard → Сопоставление акций и скидок».

Пересинк кассы#

Повторная синхронизация настроек с кассой после изменения программы лояльности. Без него касса крутит старую конфигурацию, и превью скидки в мини-приложении расходится с чеком. Порядок: Переподключиться → Получить маркетинговые акции → Сохранить → Обновить состояние.

Лицензия#

Подписка на использование Нямбота. Определяет, сколько торговых точек, Telegram-ботов и MAX-ботов можно подключить. Лицензия привязана к аккаунту владельца.

Лимиты лицензии#

Максимальное количество: торговых точек, ботов (TG + MAX считаются вместе). При достижении лимита новые боты или точки добавить не получится — нужно обновить лицензию.

Технические термины#

initData#

Данные авторизации, которые Telegram или MAX передают в мини-приложение при открытии. Нямбот использует их для автоматической авторизации покупателя без ввода логина и пароля.

Токен бота#

Уникальный секретный ключ бота, который выдаётся при создании бота в BotFather (Telegram) или партнёрской панели MAX. Используется для подключения бота к Нямботу в разделе «Боты» СРМ.

Сотрудник#

Пользователь СРМ с ограниченными правами. Может просматривать заказы и управлять статусами, но не имеет доступа к настройкам лицензии и финансам. Добавляется владельцем в разделе «Сотрудники».

ИИ-ассистент#

Встроенный в СРМ чат-бот на основе искусственного интеллекта (помощник Аня). Помогает быстро найти нужную информацию, подсказать по настройке и объяснить, что делает конкретное поле или переключатель. Отвечает только по Нямботу — кабинет, мини-приложение, «Команда» и это руководство; на посторонние вопросы вежливо откажет. Есть предел частоты: 10 вопросов в минуту и 100 в сутки на аккаунт. Иконка ассистента находится в правом нижнем углу СРМ.