iiko для ресторанов

Обновлено 1 октября 2026 г.

Бот смотрит занятость комнат и столов по броням в iiko, ставит бронь прямо на кассу ресторана и отвечает по стоп-листу. Администратору не нужно переносить заявку из чата в кассу: бронь уже там.

⏱ 8 мин · 👤 для владельца · 🟢 live

За 30 секунд:
Нужно одно значение: ключ API ресторана (iikoWeb → Интеграции → API-ключи). Регистрироваться на портале разработчика iiko не нужно.
Выберите кассу: залы и столы загрузятся сами, вебхук для отмен и переносов включится сам. Отметьте, какой зал это комнаты (каждый стол = комната), какой общий зал, а какие залы бот не трогает («на вынос», кофейня).
Кнопка «Добавить функции бота» в том же окне ставит боту три функции: свободны ли комнаты, бронь в iiko, брони гостя.
Брони через API включает ресторан или его дилер iiko. Пока они выключены, бот честно работает по старинке: заявка администратору карточкой.

Что понадобится

Что	Где взять	Зачем
Ключ API ресторана	iikoWeb → Интеграции → API-ключи, создаёт ресторан или его дилер	доступ к организации, залам, броням и стоп-листам этого ресторана
Брони (резервы) включены на кассе	ресторан или дилер iiko	иначе бот не увидит занятость и не поставит бронь

Реквизиты приложения iiko (App ID и Client Secret) держит платформа: ресторану их вводить не нужно.

Подключение за 5 шагов

Интеграции → iiko → «Подключить». Вставьте ключ ресторана и нажмите «Проверить и подключить». Платформа получит доступ, покажет организацию и кассы. Ключ хранится зашифрованным, повторно на экране не показывается.
Выберите кассу (терминальную группу), к которой привязаны залы, и сохраните. У ресторана с кофейней их две. Залы и столы загрузятся сами (потом обновить можно кнопкой «Обновить залы»), и сам включится вебхук для отмен и переносов.
Роли залов. Для каждого зала выберите роль: Комнаты (каждый стол это отдельная комната или кабина, бот называет их по имени), Общий зал (бот считает свободные столы) или Не использовать. Если в iiko у столов не заполнена вместимость (часто так), впишите её здесь: по ней бот подбирает комнату под число гостей. Подпись к столу (например, «свой санузел») бот тоже видит.
Функции бота. В блоке «Функции бота для броней» нажмите «Добавить функции бота»: появятся «Свободны ли комнаты и столы», «Бронь в iiko» и «Брони гостя». Без них бот не видит занятость и не бронирует. Функции лежат в разделе «Функции», там их можно выключить или поправить.
Настройки брони: сколько минут занимает одна бронь (по умолчанию 3 часа) и зазор между бронями одного стола. Сохраните.

«Стоп-лист iiko» имеет смысл, когда меню ресторана выгружено в облако iiko: Функции → Новая функция → Из готового шаблона → «Ресторан: iiko».

Как бот бронирует

Гость назвал дату, время и число гостей. Бот вызывает «Свободны ли комнаты и столы» и получает: какие комнаты свободны на это время, какие подходят по числу гостей, сколько столов свободно в зале.
Гость выбрал. Бот вызывает «Бронь в iiko»: занятость проверяется ещё раз, бронь ставится на кассу со статусом «новая». Компании больше одного стола достаётся несколько свободных столов зала, рассаживает администратор. Телефон гостя берётся из WhatsApp сам, бот его не спрашивает.
Бронь попадает и в раздел «Записи» проекта: напоминание гостю уйдёт по вашим настройкам.
Администратор видит бронь на кассе. Чтобы он сразу о ней узнал, в промпте бота можно попросить после брони отправить ему карточку с номером брони: такая карточка ложится в ту же запись, второй записи и второго напоминания не будет.

Статуса «подтверждена» у брони в iiko нет: у неё только «новая», «гости пришли», «закрыта» и отмена. Поэтому подтверждает гостю администратор в переписке.

Вебхук iiko включается сам после выбора кассы (если не вышло, в окне есть кнопка «Включить вебхук»). Он сообщает платформе об изменениях брони: отменённую на кассе бронь платформа снимает в «Записях», и напоминание гостю не уходит; перенесённую на другое время переносит, и напоминание уходит к новому времени.

Касса не на связи (например, ночью, когда ресторан закрыт) или iiko не отвечает: функция сразу говорит об этом боту, и он передаёт заявку администратору обычной карточкой (функция «Уведомление в Telegram»). Гостю о технике бот не рассказывает. Занятые комнаты, полный зал и такие ответы кассы бот обрабатывает сам: они не ставят диалогу пометку «ответьте руками» и не шлют вам тревогу.

В тест-чате бронь в iiko не создаётся: ответ кассы моделируется, а занятость читается настоящая. Телефона в тест-чате нет, и бот его не спрашивает, как и в WhatsApp.

Что бот НЕ делает через iiko

Не переносит и не отменяет брони сам: в iikoCloud API таких операций нет. Бот находит бронь гостя («Брони гостя») и передаёт просьбу администратору.
Не называет гостю номер стола в общем зале: он проверяет, что места есть, и ставит бронь на подходящие свободные столы. Пересадить может администратор на кассе.
Не пишет гостю «бронь подтверждена» сам: такого события у iiko нет, подтверждает администратор.
Не берёт меню из iiko: цены и состав бот читает из вашей базы знаний. Из iiko идут только брони и стоп-лист.

Частые вопросы

Проверка проходит, а «Свободны ли комнаты» отвечает «брони выключены». У ресторана не включён модуль резервов для API: платформа видит это по пустому ответу iiko. Попросите ресторан или дилера включить резервы для кассы (дилер может попросить удалённый доступ к компьютеру кассы), после этого нажмите «Обновить залы».

«iiko не принял ключ». Ключ скопирован не целиком или удалён в iikoWeb. Откройте iikoWeb → Интеграции → API-ключи, скопируйте ключ заново (или создайте новый) и нажмите «Сменить ключ».

У всех столов вместимость 0. Так iiko отдаёт незаполненные поля. Впишите вместимость в настройках интеграции или попросите ресторан заполнить её в iikoOffice.

Можно ли подключить несколько ресторанов группы? Да, каждый ресторан это отдельный проект со своим ключом API.

Кто может отключить iiko? Администратор проекта. Ключ и роли залов удаляются, брони в «Записях» и в iiko остаются.

Дальше: → Вебхуки
Связано: Что можно подключить · Запись на время · Записи и напоминания · Функции

Документация › Интеграции › iiko