Интеграция iiko с чат-ботом: заказы прямо в кассу

Гость пишет «хочу пиццу», а заказ сам появляется на кассе и уходит на кухню — без ручного переноса, без ошибок официанта. Разбираем, как это устроено на практике.

Зачем вообще связывать iiko с чат-ботом

Представьте типичный вечер в доставке. Гость пишет в WhatsApp: «Две пеперони на 32 см и колу». Администратор читает сообщение, переспрашивает адрес, открывает кассу iiko, вбивает позиции руками, считает сумму, диктует время. На один заказ уходит 4–6 минут, а в пик таких сообщений десятки. Ошибка в позиции или адресе — переделка, испорченный заказ, минус в отзывах.

Интеграция iiko с чат-ботом убирает ручной этап целиком. Бот распознаёт, что хочет гость, подтягивает актуальное меню и цены из кассы, собирает корзину и отправляет готовый заказ напрямую в iiko через API. Кухня видит его так же, как если бы его вбил оператор. Разница — заказ появляется за секунды и без человеческого фактора.

Главный смысл интеграции — не «чтобы был бот», а чтобы заказ доходил до кухни без ручного переноса. Всё остальное (меню, цены, статусы) существует ради этой одной цели.

Как технически работает iiko API

У iiko есть два основных программных контура, и путать их — самая частая ошибка на старте.

iikoCloud (iiko Transport / iikoCard)

Это облачный iiko API — то, что нужно для доставки и приёма заказов извне. Через него бот получает меню, номенклатуру, стоп-листы, создаёт заказы доставки и самовывоза, узнаёт статусы. Работает по HTTPS, авторизация по токену, который выдаётся на apiLogin. Именно этот контур связывает внешний сервис с вашей кассой.

iikoServer (Back Office / RMS)

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

Для интеграции чат-бота вам нужен доступ к iikoCloud API — конкретно apiLogin (ключ доступа), ID организации (organizationId) и ID терминала/точки. Эти три параметра — минимальный набор, чтобы заказ «нашёл» вашу кассу.

Что именно автоматизируется

Хорошая интеграция закрывает не только сам факт создания заказа. Вот что реально уходит на автомат:

• Меню и цены. Бот тянет актуальную номенклатуру из кассы. Поменяли цену в iiko — она обновилась в диалоге, без правок в двух местах.
• Стоп-лист. Закончилась моцарелла — позиция автоматически исчезает из предложения, гость не закажет то, чего нет.
• Модификаторы. Размер пиццы, тесто, соусы, «без лука» — всё передаётся в заказ как отдельные модификаторы, а не текстом в комментарии.
• Тип заказа. Доставка или самовывоз, адрес, время, оплата наличными/картой/онлайн.
• Статусы. «Принят» → «Готовится» → «В пути» → «Доставлен» приходят обратно из iiko, и бот сам сообщает их гостю.

Пошаговая настройка интеграции

1. Проверьте тариф iiko. Доступ к облачному API есть не на всех подписках. Уточните у своего менеджера iiko, подключён ли iikoTransport/iikoCloud для вашей организации.
2. Получите apiLogin. Это ключ доступа к API. Его выдают через личный кабинет iiko или запросом в поддержку. Без него интеграция не авторизуется.
3. Заберите organizationId и ID терминала. Эти идентификаторы определяют, в какую точку и на какую кассу упадёт заказ. У сети их несколько — по одному на филиал.
4. Сопоставьте меню. Убедитесь, что номенклатура в iiko заполнена: названия, цены, категории, модификаторы. Мусор в кассе = мусор в боте.
5. Настройте типы оплаты и доставки. В iiko должны быть заведены способы оплаты, которые вы хотите принимать через бота, иначе заказ не создастся.
6. Протестируйте на реальном заказе. Сделайте тестовый заказ через бота и проверьте, что он появился на кассе с правильными позициями, суммой и адресом.
7. Включите обратные статусы. Настройте, чтобы смена статуса в iiko возвращалась гостю сообщением — это снимает половину звонков «а где мой заказ».

Частые ошибки при интеграции iiko

Ручной перенос против интеграции: считаем деньги

Допустим, у вас 40 заказов в день через мессенджеры, и на каждый оператор тратит 5 минут. Это 200 минут — больше трёх часов работы в день только на переписывание заказов в кассу. За месяц — около 100 часов, фактически половина ставки сотрудника. При интеграции это время освобождается, а вечерние пики перестают быть узким горлышком: бот принимает десять заказов одновременно, кассе всё равно.

Добавьте сюда ошибки. Ручной ввод даёт 3–5% брака: не тот размер, забытый модификатор, опечатка в адресе. Каждая такая ошибка — это либо переделка за ваш счёт, либо злой отзыв на картах. Интеграция сводит этот процент почти к нулю, потому что заказ собирает сам гость, а бот лишь переносит его в кассу iiko без искажений.

Где здесь ИИ-администратор и что он добавляет

Голая интеграция iiko с ботом-меню работает, но упирается в кнопки: гость обязан идти по дереву «категория → блюдо → модификатор». Живые люди так не пишут. Они пишут «хочу что-нибудь острое до 600 рублей» или «повторите как в прошлый раз». Здесь нужен не бот-кнопки, а ИИ-администратор, который понимает свободный текст.

Такое умеет автоматизировать, например, Людочка — ИИ-администратор для общепита. Она подключается к iiko через API, принимает заказ живым языком в WhatsApp, Telegram или по звонку, собирает корзину из актуального меню и отправляет готовый заказ в кассу. Параллельно закрывает то, до чего у интеграции руки не доходят:

• Отвечает 24/7 — ночные заказы и вопросы не теряются, даже когда операторов нет.
• Определяет зону доставки по адресу и маршрутизирует заказ в нужный филиал.
• Допродаёт — предлагает соус к пицце или напиток, поднимая средний чек.
• Собирает отзывы после статуса «Доставлен» и подсвечивает негатив, пока он не ушёл на карты.
• Возвращает гостей — вспоминает прошлые заказы и делает персональные предложения.

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

Коротко

Интеграция iiko API с чат-ботом — это про то, чтобы заказ из мессенджера сам оказывался на кассе с правильными позициями, ценами и статусами. Начните с проверки тарифа и apiLogin, наведите порядок в номенклатуре, протестируйте на реальном заказе и включите обратные статусы. А чтобы гость мог заказывать живым языком, а не тыкать кнопки, поверх интеграции ставят ИИ-администратора вроде Людочки.