База знаний Restoplace

Webhook событий резервов — Restoplace

Эта инструкция для разработчиков и описывает формат webhook‑событий о создании и обновлении резервов (броней) в Restoplace. Используйте её, чтобы принимать данные в свою CRM/ERP, триггерить автоматизации и синхронизировать статусы.

Для уведомлений гостей по шаблонам — есть webhook уведомлений

Где включить Webhook

  1. В личном кабинете Restoplace перейдите в настройки адреса
  2. В левом меню, раскройте пункт «Интеграции»
  3. Перейдите в «API / Webhook»
  4. Включите тумблер «Включить Webhook»
  5. Вставьте ваш HTTPS-endpoint в поле (URL вебхука)
  6. Сохраните изменения
Где включить webhook Restoplace

Что и когда отправляется

Поле event в теле события хранит тип события.

Restoplace отправляет HTTP‑запрос с JSON‑телом на ваш обработчик при событиях:
  • reserve.created — создан новый резерв
  • reserve.updated — в резерве произошли изменения

Структура JSON и поля

Ниже перечислены поля, которые приходят в webhook‑событии. Названия и типы соблюдать строго — используйте их для сериализации/валидации на вашей стороне.

Пример JSON:

Restoplace отправляет на ваш endpoint POST с телом JSON. Пример структуры полей:
{
  "event": "reserve.updated",
  "id": 1000000,
  "userid": 1,
  "created": "2025-11-27 16:36:46",
  "last_updated": null,
  "reserve_id": 3234,
  "time_from": "2025-11-27 16:36:46",
  "time_to": "2025-11-27 17:50:00",
  "name": "Иван",
  "count": 2,
  "phone": "7919",
  "email": "",
  "text": "34r34r",
  "status": 4,
  "success": 1,
  "is_fast": 1,
  "source": "adminpanel",
  "tags": ["vip"],
  "getparams": ["utm_company": "yandex"],
  "depositPriceDesired": 1430,
  "depositPrice": 0,
  "depositPaid": 1,
  "depositOnline": 0,
  "order_sum": null,
  "item_ids": [1000, 1001],
  "item_type": "hookahzone",
  "floor_id": 58,
  "floor_name": "Основной зал",
  "time_see": "",
  "time_open": "2025-11-27 16: 36: 46",
  "time_close": "",
  "time_cancel": "",
  "is_banquet": 0,
  "Parent_ID": 0,
  "Next_ID": 0,
  "address_id": 147,
  "address_hash": "99fcee43c466423523tg",
  "organization_id": 100
}

Рекомендации по приёму и обработке

  • Идентификация заявки. Используйте id и/или reserve_id вместе с last_updated, чтобы применить только самые свежие изменения (идемпотентность).
  • Источники. Для аналитики источников используйте source и блок getparams.

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

  • Как понять, подтверждена ли бронь? Смотрите поле success:true — выбран конкретный стол/зал.
  • Когда приходит order_sum? Если подключены интеграции с iiko или R‑Keeper — сумма передаётся при закрытии счёта.

Прочитайте ещё