Адреса для уведомлений и мини-приложения

На этой странице собраны все адреса, которые нужно указывать в сторонних сервисах для работы с Нямботом: вебхуки для уведомлений об оплате и событиях кассы, а также URL мини-приложения для ботов.

Базовый адрес#

Все вебхуки принимаются по адресу:

https://api.nyambot.ru

ЮKassa#

Куда вводить: Личный кабинет ЮKassa → Настройки → HTTP-уведомления

Адрес вебхука:

https://api.nyambot.ru/api/webhooks/yookassa-order

Метод: POST

Какие события включить:

• payment.succeeded — оплата прошла успешно
• payment.canceled — оплата отменена
• refund.succeeded — возврат выполнен

Нямбот принимает уведомления только с IP-адресов ЮKassa. Убедись, что адрес введён точно как написано выше — без лишних символов и без слеша в конце.

Яндекс.Пэй#

Куда вводить: Личный кабинет Яндекс.Пэй → Настройки магазина → URL для уведомлений о платежах (Callback URL)

Адрес вебхука (вводить ровно так):

https://api.nyambot.ru/api/webhooks/yandexpay-order

Метод: POST

⚠️ Важно: указывай только базовый адрес выше. Яндекс.Пэй сам дописывает в конце /v1/webhook и шлёт уведомления на https://api.nyambot.ru/api/webhooks/yandexpay-order/v1/webhook. Не добавляй /v1/webhook вручную — иначе адрес задвоится и уведомления перестанут приходить (заказ не будет подтверждаться автоматически).

Яндекс.Пэй подписывает запросы цифровой подписью — дополнительных настроек со стороны Нямбота не требуется.

iiko#

Ручная настройка не нужна — Нямбот регистрирует вебхук автоматически при подключении iiko через СРМ: прописывает URL и генерирует токен авторизации в iikoWeb самостоятельно.

Убедиться, что всё встало, можно в iikoWeb → Внешние заказы → Настройки Cloud API → нажать на интеграцию → вкладка «Основное». Должны быть заполнены:

• URI: https://api.nyambot.ru/api/webhooks/iiko
• Токен авторизации: значение, которое Нямбот выставил автоматически (менять не нужно)

Проверить и починить это можно самому, не выходя из СРМ: Интеграции → вкладка «POS-системы» → сегмент «Вебхуки». Кнопка «Проверить» спрашивает у самой iiko, что у неё сейчас прописано, и сравнивает с тем, что ждёт Нямбот:

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

Колонка «Последнее событие» показывает, когда касса реально присылала уведомление. Если там «Не приходили», а заказы и стоп-листы уже идут — вебхук настроен не до конца.

ℹ️ Одна настройка на организацию, а не на точку. iiko разрешает один адрес на организацию, и он общий для всех твоих точек внутри неё. Вписывать адрес и токен в каждую точку не нужно — в сегменте «Вебхуки» одна строка и покрывает несколько точек сразу. Если в одну организацию смотрят два разных API-ключа, они пишут в одну и ту же настройку кассы, поэтому Нямбот держит для них общий токен: перезапись тогда безвредна.

Какие события нужны (вкладка «Фильтры»):

• StopListUpdate — обновление стоп-листа
• DeliveryOrderUpdate — изменение статуса заказа

iiko ожидает ответ 200 в течение 3 секунд; при превышении — временная блокировка (15 мин → 1 ч → 12 ч). Один URL обрабатывает все типы событий — дополнительных адресов не нужно.

r_keeper — статусы с кассы (White Server)#

🚧 В подготовке. Делать тебе ничего не нужно — ни сейчас, ни потом.

Сейчас всё работает: Нямбот сам опрашивает кассу примерно раз в минуту и обновляет статусы заказа. Настраивать нечего.

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

Опрос кассы никуда не денется. У r_keeper нет повторной отправки событий: если событие потерялось по дороге, второй раз оно не придёт. Поэтому опрос остаётся страховкой — просто более редким. Выбор в СРМ честно звучит так:

• опрос раз в минуту — как сейчас;
• мгновенные события + страховочный опрос раз в 5 минут — статусы почти сразу, а потерянное событие подберёт опрос.

ℹ️ Стоп-лист остаётся на опросе. Событие об изменении меню стоп-лист не покрывает, а терять стоп-позиции нельзя: гость закажет то, чего нет. Стоп-лист Нямбот запрашивает у кассы сам.

r_keeper — доставка (r_k Delivery)#

Нужно, только если доставку у тебя ведёт r_k Delivery (тумблер «Доставка» в модалке R-keeper в СРМ переключён на r_keeper). Если доставку ведёт Нямбот — этот раздел пропусти, статусы приходят и без него.

Настраивается вручную — в отличие от iiko, у r_k Delivery нет авторегистрации.

Адрес push-уведомлений:

https://api.nyambot.ru/api/webhooks/rkeeper-delivery

Метод: POST

Токен авторизации: свой у каждого API-подключения r_k Delivery — то есть один на все заведения этого ключа, а не на каждую точку. Возьми его в СРМ: Интеграции → вкладка «POS-системы» → сегмент «Вебхуки» → строка своего ключа R-keeper: там адрес и токен с кнопкой «копировать», а в колонке «Точки» видно, на какие заведения они распространяются. Кнопка «Инструкция» в той же строке открывает пошаговую памятку.

ℹ️ Сверки, как у iiko, здесь нет: r_k Delivery не отдаёт свои настройки push наружу. Понять, что связь есть, можно по колонке «Последнее событие» — она заполняется, как только от кассы приходит первое уведомление.

Куда вводить (кабинет r_k Delivery):

1. Коммуникации → Внешнее API для push-уведомлений → создай своё API: вставь адрес выше. Токен положи в поле «Токен», а в поле «Заголовок» укажи любое латинское имя без пробелов и _ (например Nyambot) — кабинет не принимает Authorization, а Нямбот примет токен из любого заголовка. Поле X-Signature оставь пустым.

2. Коммуникации → Шаблоны → создай отдельный шаблон на каждый статус заказа (в одном шаблоне выбирается только один статус). Для каждого: канал api, привяжи своё внешнее API из шага 1, условие «Статус равно <статус>», а в заведениях — только своё (чужие шаблоны не трогай). Называй по образцу «Нямбот <Статус>».

   Полная схема доставочного заказа — 13 статусов, заведи шаблон на каждый:

   Новый · Подтверждён · Принят в ресторане · Передан на кухню · Готовится · Приготовлен · Сборка заказа · Собран · У курьера · Заказ в пути · Доставлен · Выполнен · Отменён

   Особенно важны Доставлен (клиент видит «Заказ доставлен») и Отменён (запускает отмену/возврат).

Без этой настройки заказы не потеряются: Нямбот всё равно опрашивает статусы сам, просто реже (примерно раз в минуту). Push нужен, чтобы клиент видел «Готовится» / «В пути» сразу.

Яндекс.Доставка#

Куда вводить: Личный кабинет Яндекс.Доставки → Настройки → Webhook URL

Адрес вебхука:

https://api.nyambot.ru/api/webhooks/yandex-delivery

Метод: POST

Telegram — URL мини-приложения#

Чтобы в боте появилась кнопка открытия мини-приложения, нужно один раз настроить URL в BotFather.

URL мини-приложения:

https://app.nyambot.ru

Menu Button (кнопка в чате)#

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

Через мини-приложение BotFather: выбери бота → раздел Mini Apps → Menu Button → введи URL выше

После этого в нижнем левом углу чата появится кнопка, которая открывает мини-приложение.

Main App (кнопка «Open App»)#

Через мини-приложение BotFather: выбери бота → раздел Mini Apps → Main App → введи URL выше → в Launch Mode выбери Fullsize

MAX — URL мини-приложения#

Куда вводить: Партнёрская панель bid.max.ru → настройки бота → «Настройки чат-бота и мини-приложения» → поле URL мини-приложения

URL мини-приложения:

https://app.nyambot.ru

Таблица: быстрый справочник#

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

• Настройка ЮKassa → ЮКасса
• Настройка iiko → Подключение iiko
• Доставка r_keeper → Доставка r_keeper
• Настройка Telegram-бота → Telegram-бот
• Настройка MAX-бота → MAX-бот
• Тестирование оплаты → Тестирование