Messenger API

Всё, что панель умеет с подключённым аккаунтом Telegram, WhatsApp или Instagram, — через REST: один ключ, один формат ответа, по разделам.

Записи

Услуги, свободные слоты и записи — то, что использует шаг «Запись на время».

Base URL: https://chatvendor.net/api/v1 · каждый ответ {"success": true, "data": …}

GET /services Bookable services (duration, price) channels:read

Право: channels:read

Ответ 200

curl https://chatvendor.net/api/v1/services \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

GET /services/{service}/slots Free time slots of a service on a date (?date=YYYY-MM-DD, Asia/Tashkent) channels:read

Право: channels:read

Параметры

servicepath · integerобязательно

Service id

datequery · string

Ответ 200

curl https://chatvendor.net/api/v1/services/{service}/slots \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

GET /bookings Bookings (filters: status, from, to, limit) channels:read

Право: channels:read

Ответ 200

curl https://chatvendor.net/api/v1/bookings \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

POST /bookings Book a slot (starts_at must be a free slot); channel_id + peer_id link it to a chat so reminders reach the customer channels:write

Право: channels:write

Тело запроса (application/json)

service_idintegerобязательно

starts_atstringобязательно

namestring

phonestring

notestring

channel_idstring

peer_idinteger

statusstring: pending | confirmed

Ответ 200

curl -X POST https://chatvendor.net/api/v1/bookings \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -H "Content-Type: application/json" \
  -d '{"service_id":1,"starts_at":"…"}'

PATCH /bookings/{id} Change status (confirmed / cancelled / done / no_show), move (starts_at) or note channels:write

Право: channels:write

Параметры

idpath · integerобязательно

Booking id

Тело запроса (application/json)

statusstring

starts_atstring

notestring

notifyboolean

Ответ 200

curl -X PATCH https://chatvendor.net/api/v1/bookings/1 \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -H "Content-Type: application/json" \
  -d '[]'