Интеграции

iiko

Заказ закрыли на кассе — Evidra сама просит гостя оставить отзыв: сначала в MAX и Telegram, затем SMS, если оценки нет.

Как подключить

В iikoWeb откройте Интеграции → API-ключи и создайте ключ. Нужны права на список организаций и на настройки вебхуков.
В кабинете Evidra: Разработчикам → Интеграции → iiko — касса. Выберите локацию, вставьте ключ и нажмите Подключить.
Мы сами подписываем вебхук iiko Cloud на статусы Closed для заказа в зале и доставки. Ключ хранится зашифрованным, на экран больше не показывается.

Это iiko Cloud API (api-ru.iiko.services): тот же контур, которым касса обменивается с сайтом доставки. Страница api.iiko.ru — витрина для партнёров, не адрес, куда ходит интеграция.

Запрос уходит только если у заказа есть телефон. В доставке он почти всегда есть. В зале на кассе телефон часто не спрашивают — такое событие попадёт в журнал как «пропущено».

Что уходит гостю

Берём телефон и имя из заказа. Очередь такая же, как у остальных каналов Evidra: сначала MAX, через час Telegram, через сутки SMS, если оценки всё ещё нет. Письмо в этой очереди не участвует.

Стоимость SMS резервируется на балансе кабинета в момент запуска. Если средств не хватает — каскад не стартует, в журнале подключения будет причина. Повтор по тому же заказу не происходит: мы запоминаем его номер в iiko.

Журнал и проверка

У подключения в кабинете есть журнал: номер заказа, «каскад запущен», «пропущено» с причиной или «ошибка». Кнопка Проверить ещё раз спрашивает iiko и заново подписывает вебхук — так можно починить подписку, если менялся адрес сайта.

Если ключ принят, а вебхук не подписался, подключение всё равно сохранится: в карточке будет текст ошибки. Нажмите «Проверить» после того, как в iikoWeb выдадите ключу право на вебхуки.