Как настроить внешний webhook (External Webhook)

Что умеет модуль?

При трёх событиях VisitTime сразу отправляет запрос на ваш сервер:

newvisit — создана новая запись (клиент записался через форму или бот).

movevisit — запись перенесена на другое время.

cancelvisit — запись отменена (мастером, администратором или самим клиентом).

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

Зайдите на страницу Визит Маркет, найдите модуль External Webhook и нажмите Добавить.

После подключения в настройках появится блок управления модулем с тремя полями.

Настройки модуля

URL — адрес на вашем сервере, куда будет отправляться POST-запрос. Например: https://example.com/visittime/webhook. Сервер должен отвечать кодом 2xx.

Group ID — необязательный параметр. Если у вас несколько кабинетов VisitTime и один обработчик, сюда можно вписать любой идентификатор (название, номер), чтобы на стороне вашего сервера понять, от кого пришёл запрос.

Секрет (Secret) — необязательный параметр. Если заполнен, каждый запрос будет содержать заголовок X-Secret с указанным значением. Используйте его для проверки подлинности запросов на вашем сервере.

Формат запроса

На ваш URL отправляется POST-запрос с заголовками:

Content-Type: application/json
X-Secret: <ваш секрет> — только если секрет задан

Тело запроса (JSON):

{
  "message":   "newvisit",
  "user_id":   42,
  "client_id": 15,
  "tg_id":     123456789,
  "max_id":    0,
  "vk_id":     0,
  "group_id":  "мой_идентификатор",
  "body": {
    "visitid":          100,
    "service_name":     "Стрижка",
    "master_name":      "Анна",
    "date":             "2026-05-12T14:30:00",
    "duration_minutes": 60.0,
    "price":            1500.00,
    "branchid":         1,
    "individual":       1
  }
}

message — тип события: newvisit, movevisit или cancelvisit.

user_id — внутренний ID вашего кабинета VisitTime.

client_id — ID клиента в вашей базе VisitTime.

tg_id / max_id / vk_id — ID клиента в мессенджерах (0, если не привязан).

group_id — значение из поля Group ID настроек модуля.

body.individual — тип услуги: 1 — индивидуальная, 2 — групповая, 3 — поток, 4 — параллельная.

Если у вас возникли вопросы по интеграции, обратитесь в наш Центр поддержки.