Перейти к основному содержимому

Webhook-уведомления гостям в Restoplace: подключение, формат и список событий

Webhook позволяет отправлять данные о событии (бронирование, лист ожидания, билеты, сертификаты и т. п.) на ваш HTTP(S)-endpoint. Настройка выполняется в общих настройках заведения, во вкладке «Уведомления SMS/Мессенджер».

Напоминаем: уведомления подключаются на уровне бренда (заведения) и действуют для всех адресов внутри него.

Так же у нас есть Webhook событий резервов

1️⃣ Где включить Webhook​

  1. В личном кабинете Restoplace , откройте «Общие настройки» в правом верхнем углу
  2. Перейдите в раздел общих настроек «Уведомления SMS/Мессенджер»
  3. Включите тумблер Webhook
  4. Вставьте ваш HTTPS-endpoint в поле (Ваша ссылка)

2️⃣ Формат запроса (POST, JSON)​

Restoplace отправляет на ваш endpoint POST с телом JSON. Пример структуры полей:

{
  "phone": "+79001234567",         // телефон гостя
  "message": "Текст сообщения",     // итоговый текст (если формируется на стороне Restoplace)
  "action": "reserve_success",      // тип события (см. список ниже)
  "address_id": 123,                // ID адреса в Restoplace
  "address_hash": "restaurant_keyword",
  "address_city": "Москва",
  "address_street": "ул. Примерная, 1",
  "organization_id": 456,           // ID заведения (бренда)
  "organization_name": "Название ресторана"
  "getparams": {
     "utm_source": "yandex",
     "utm_medium": "cpc"
  }
}

Поля address_* и organization_* помогают маршрутизировать уведомления для нескольких точек/брендов.

3️⃣ Список событий (action) и когда они отправляются​

1) Подтверждение телефона Отправка SMS с кодом подтверждения номера телефона action: phone_verification когда: при регистрации или смене номера телефона (отправка SMS с кодом подтверждения). Уведомление о подтверждении номера включается в разделе «Уведомления SMS/Мессенджер». текст:

Наберите код: {код}
{название_организации}, {адрес}

2) Лист ожидания Уведомление о создании заявки в листе ожидания action: waitlist_success когда: сразу после добавления заявки в лист ожидания.

3) Успешное бронирование Уведомление о создании резерва или выборе стола из листа ожидания action: reserve_success когда: сразу после создания брони или выбора стола у заявки из листа ожидания.

4) Отмена бронирования Уведомление об отмене бронирования action: reserve_cancelled когда: при отмене брони сотрудником.

5) Напоминание о бронировании Напоминание о предстоящем бронировании action: reserve_reminder когда: за заданное время до начала брони (время выбирается в настройках уведомлений).

6) Сообщение на следующий день Уведомление на следующий день после бронирования action: reserve_next_day_notice когда: на следующий день после визита гостя.

7) Ссылка на оплату (депозит за резерв) Отправка сообщения с ссылкой на оплату депозита action: reserve_paymentlink когда: при создании/редактировании резерва, если сотрудник выбрал отправку ссылки. (В книге резервов при оформлении брони можно выбрать «Ссылка» или «SMS» для отправки ссылки на оплату.) Для работы ссылок нужна подключенная платёжная система.

Билеты (Tickets)​

8) Ссылка на оплату билета Отправка сообщения с ссылкой на оплату билета action: ticket_paymentlink когда: при создании/редактировании билета и выборе сотрудником отправки ссылки (настройка «Включить отправку ссылки на оплату по СМС/мессенджер» в разделе событий).

9) Успешная покупка билета Уведомление о успешной покупке билета action: ticket_success когда: после создания/оплаты билета.

Сертификаты (Certificates)​

10) Ссылка на оплату сертификата Отправка сообщения с ссылкой на оплату сертификата action: certificate_paymentlink когда: при создании/редактировании сертификата и выборе сотрудником отправки ссылки. (Механика аналогична билетам/депозитам: нужна платёжная система.)

11) Подтверждение покупки сертификата Уведомление о успешной покупке сертификата action: certificate_success когда: после создания/оплаты сертификата. (Уведомления по сертификатам предусмотрены в разделе уведомлений)

4️⃣ Полезные переменные для текстов сообщений​

В исходных SMS/мессенджер-шаблонах Restoplace доступны переменные: имя гостя, время, номер брони/билета/сертификата, адрес, название заведения и др. (например, %username%, %orgname%, %street%, %city%, %reserve_time%, %reserve_num%, %event_name%, %ticket_num%, %certificate_num% и др.). Используйте их для формирования информативных сообщений.

⁉️ Где что настраивается (шпаргалка)​

  • Общие настройки → Уведомления SMS/Мессенджер — включение уведомлений, тексты, Webhook
  • Книга резервов — при создании брони можно выбрать отправку ссылки на оплату.
  • События (Билеты) — включение отправки ссылок на оплату и тайм-аут ожидания оплаты
  • Платёжная система — подключение эквайринга для депозитов/билетов/сертификатов