Руководства

Управление клиентами

Управляйте базой клиентов — профили, заметки, история и общение.

Обзор

Клиенты — это конечные покупатели, которые записываются на услуги. Bronjoy ведёт базу клиентов отдельно для каждой организации: один и тот же человек может быть клиентом нескольких организаций с разными профилями.

Создание клиентов

Клиенты создаются автоматически при первой записи. Также их можно создать вручную:

POST /api/org/clients
Authorization: Bearer your-token
Content-Type: application/json

{
  "name": "Maria Garcia",
  "phone": "+998901234567",
  "email": "[email protected]",
  "notes": "New client, referred by Alex"
}

Список клиентов

GET /api/org/clients
Authorization: Bearer your-token

Поиск и фильтрация:

GET /api/org/clients?search=maria&sort=last_appointment_at&direction=desc

Профиль клиента

GET /api/org/clients/{client}

Профиль клиента включает:

Контактную информацию
Статистику записей (всего, завершённых, отменённых, неявок)
Дату последней записи
Заметки

История записей

Посмотреть всю историю записей клиента в вашей организации:

GET /api/org/clients/{client}/history

Это пригодится, когда:

Клиент звонит и спрашивает о прошлой записи
Вы проверяете, как часто клиент отменяет записи или не приходит
Вы хотите понять предпочтения клиента

Заметки о клиенте

Внутренние заметки видны только сотрудникам — клиенты их никогда не видят. Используйте заметки, чтобы фиксировать:

Предпочтения и особенности («предпочитает утренние записи»)
Медицинские нюансы («аллергия на латекс»)
Особенности общения («всегда звонить, на сообщения не отвечает»)

# Add a note
POST /api/org/clients/{client}/notes
Content-Type: application/json

{ "note": "Prefers stylist Alex. Very particular about fringe length." }

# View notes
GET /api/org/clients/{client}/notes

Обновление клиента

PUT /api/org/clients/{client}
Content-Type: application/json

{
  "phone": "+998909876543",
  "email": "[email protected]"
}

Массовые операции

POST /api/org/clients/batch-update
Content-Type: application/json

{
  "ids": [10, 11, 12],
  "data": { "is_vip": true }
}

Отзывы

Клиенты оставляют отзыв после завершённой записи:

GET /api/client/reviews/reviewable
Authorization: Bearer client-token

POST /api/client/reviews
Authorization: Bearer client-token
Content-Type: application/json

{
  "appointment_id": 101,
  "rating": 5,
  "comment": "Great service, will book again!"
}

Просмотр отзывов клиентов и ответы на них (со стороны сотрудников):

GET /api/org/reviews
GET /api/org/reviews/stats
GET /api/org/reviews/trend

Ответить на отзыв:

POST /api/org/reviews/{review}/reply
Content-Type: application/json

{
  "reply": "Thank you for your feedback! We're so glad you enjoyed the experience."
}

Советы:

Отвечайте на все отзывы, особенно на негативные — это показывает профессионализм
Пишите коротко и по-человечески
Не спорьте с негативными отзывами; признайте проблему и предложите решение вне публичного поля