WebHook (вебхуки)

Логика делается через вебхук в каскаде + «Отправлять всегда».

1) Настройте URL вебхука

В «Глобальных настройках» есть блок «Вебхук».

Там укажите URL, на который мы будем отправлять POST-запросы.

Пример тела POST-запроса

{
  "phone": "[phone]",
  "email": "[email protected]",
  "content": "TEST",
  "notificationType": "BOOKED"
}

Пояснения:

• phone — телефон клиента.

• email — email клиента.

• notificationType — тип события.

• content — текст сообщения для клиента.

Виды notificationType

Значение приходит в поле notificationType.

• BOOKED — запись создана (оповещение клиенту)

• BOOKED_LONG — длинная запись (оповещение клиенту) создана

• BOOKED_INTERNAL — запись создана (оповещение менеджерам)

• CANCEL — отмена записи (оповещение клиенту)

• CANCEL_INTERNAL — отмена записи (оповещение менеджерам)

• SPOT_AVAILABLE — место освободилось (оповещение клиенту)

• DAY_BEFORE_VISIT — напоминание о записи за 24 часа (оповещение клиенту)

• TWO_HOURS_BEFORE_VISIT — напоминание о записи за 2 часа (оповещение клиенту)

• PENULTIMATE — абонемент: закончится через 2 дня

• EXPIRING — абонемент: осталось 1 посещение

• EXPIRED — абонемент: закончился

• FOR_TRAINER_EXERCISE_CREATED — запись создана (оповещение исполнителю)

• FOR_TRAINER_EXERCISE_UPDATED — запись обновления (оповещение исполнителю)

• FOR_TRAINER_EXERCISE_CANCELED — запись отменена (оповещение исполнителю)

• FOR_CLIENTS_EXERCISE_UPDATED — запись обновлена (оповещение клиенту)

• FOR_CLIENTS_BIRTHDAY — день рождения клиента

• OTP — код для входа

• LINK — ссылка на оплату

Примеры POST-запросов для популярных событий

Ниже — примеры расширенного тела запроса.

Поле content содержит уже готовый текст оповещения. Поле notificationType показывает тип события.

BOOKED

{
  "phone": "71234567890",
  "email": "[email protected]",
  "content": "Запись есть!\nНаправление: Аренда открытого корта под бадминтон\nТип записи: Для персональных записей\nИсполнитель: Без тренера\nСтудия: 1 Студия с онлайн-кассой и онлайн-платежами., Insomnia\n18 марта, среда, 11:00\nМетод оплаты: ON_PLACE",
  "notificationType": "BOOKED",
  "org": {
    "id": "aa7dc7f4-31b2-4065-a2a8-df28fe9c2be7",
    "name": "1 Компания с онлайн-кассой и онлайн-платежами"
  },
  "studio": {
    "id": "943fe2eb-837f-41ba-9498-b1bb06766f29",
    "name": "1 Студия с онлайн-кассой и онлайн-платежами."
  },
  "room": {
    "id": "cf659ad2-5ec7-4dc1-ae9e-c454592cec98",
    "name": "Insomnia"
  },
  "client": {
    "id": "94cdfe52-9138-4ffd-91be-0b5d6f500199",
    "firstName": "ERP",
    "lastName": "Viva",
    "phone": "7123456789",
    "email": "[email protected]"
  },
  "exerciseId": "46072000-59c2-4431-a7b1-2bba4a3ceab1",
  "bookingId": "cd65acfa-8e44-44db-b4ed-a31961a30105",
  "dateTimeStart": "2026-03-18T06:00Z",
  "dateTimeEnd": "2026-03-18T07:00Z"
}

BOOKED_INTERNAL

CANCEL

CANCEL_INTERNAL

SPOT_AVAILABLE

FOR_TRAINER_EXERCISE_CREATED

FOR_TRAINER_EXERCISE_UPDATED

FOR_TRAINER_EXERCISE_CANCELED

FOR_CLIENTS_EXERCISE_UPDATED

Структура тела запроса обычно одинаковая. Чаще всего меняются notificationType и текст в content.

2) Добавьте вебхук в каскад

1. Перейдите в раздел https://vision.vivacrm.ru/notifications.

2. Выберите событие.

3. Выберите вебхук как 2-й или 3-й этап каскада.

4. Если вебхук должен отправляться всегда, включите «Отправлять всегда» на этом этапе.

Рекомендация

Вебхуки, которые должны отправляться всегда, ставьте 3-м этапом. Включайте «Отправлять всегда».

Так клиент получит уведомление по каскаду (email/SMS/мессенджеры). А вы получите техническое уведомление по вебхуку.