Настройка организации
Обзор
После регистрации и создания организации нужно пройти чек-лист настройки, прежде чем клиенты смогут записываться. Это руководство проведёт вас по каждому шагу в рекомендуемом порядке.
Проверить текущий статус настройки можно в любой момент:
GET /api/org/setup-status
Authorization: Bearer your-token
Шаг 1. Профиль организации
Профиль — это публичная страница, которую видят клиенты, когда находят ваш бизнес. Заполните её полностью — это напрямую влияет на доверие и конверсию.
GET /api/org/organization-profile
PUT /api/org/organization-profile
Рекомендуемые поля для заполнения:
| Поле | Почему это важно |
|---|---|
name | Отображается везде — используйте реальное название бизнеса |
description | Расскажите клиентам, чем вы занимаетесь. Оптимально 2–4 предложения |
category | Помогает клиентам найти вас в поиске |
address | Обязательно, если у вас есть физическая точка |
phone | Клиенты хотят позвонить перед записью |
website | Повышает доверие |
logo | Показывается в результатах поиска и на странице записи |
cover_image | Первое впечатление на странице профиля |
working_hours | Показывается в профиле, чтобы клиенты знали часы работы |
Советы:
- Пишите описание с упором на пользу для клиента, а не просто перечисляйте услуги
- Используйте качественный квадратный логотип (минимум 200×200 px)
- Заполните все ссылки на соцсети, которыми вы действительно пользуетесь
Публикация профиля
Профиль изначально находится в статусе черновика — он не виден публично. Когда всё готово:
POST /api/org/organization-profile/toggle-publish
Authorization: Bearer your-token
Шаг 2. Локации
Если у вас одна или несколько физических точек, создайте их как локации.
POST /api/org/branches
Authorization: Bearer your-token
Content-Type: application/json
{
"name": "Main Branch",
"address": "123 Main St, Tashkent",
"phone": "+998901234567"
}
Даже если точка всего одна, создайте её — записи привязываются к локациям.
Шаг 3. Услуги
Услуги — это то, на что записываются клиенты. Создайте хотя бы одну услугу для начала.
POST /api/org/services
Authorization: Bearer your-token
Content-Type: application/json
{
"name": "Haircut",
"description": "Classic haircut with styling",
"duration": 60,
"price": 50000,
"category_id": 1,
"buffer_time": 10
}
Ключевые поля:
| Поле | Описание |
|---|---|
duration | Длительность услуги в минутах |
price | Цена в минимальных единицах валюты (например, в тийинах) |
buffer_time | Промежуток после записи (время на уборку) |
prepay_required | Требуется ли оплата при записи |
prepay_amount | Фиксированная сумма депозита, если предоплата обязательна |
max_advance_days | За сколько дней вперёд клиенты могут записаться на эту услугу |
Советы:
- Задавайте
buffer_timeреалистично — он не даёт записям идти вплотную друг за другом - Группируйте связанные услуги в одну категорию
- Если у разных сотрудников услуга занимает разное время, создайте отдельные варианты
Шаг 4. Сотрудники
Добавьте свою команду. У каждого сотрудника своё расписание, и его можно назначить на конкретные услуги.
Полное руководство — в разделе Управление сотрудниками.
Шаг 5. Расписание и доступность
Каждому сотруднику нужно рабочее расписание, иначе слоты не появятся. Пока расписание не задано, слоты не генерируются.
Полное руководство — в разделе Услуги и расписание.
Шаг 6. Настройки
Настройте поведение на уровне организации:
GET /api/org/settings
PUT /api/org/settings
Важные настройки:
| Настройка | Описание | Рекомендация |
|---|---|---|
booking_lead_time | Минимум часов до слота, за которые его ещё можно забронировать | Поставьте 1–2 часа, чтобы избежать сюрпризов в последний момент |
max_advance_booking_days | За сколько дней вперёд клиенты могут записаться | Стандарт — 30–60 дней |
appointment_auto_confirm | Автоподтверждение новых записей | Включите, если ручное подтверждение не нужно |
allow_guest_booking | Разрешить запись без аккаунта клиента | Включите, чтобы снизить барьер |
slot_interval | Минуты между началами слотов | Подберите под длительность ваших услуг |
cancellation_hours | За сколько часов до записи клиент может отменить | Обычно 24–48 часов |
Шаг 7. Настройки платежей (опционально)
Если вы хотите принимать оплату при записи, включите её и задайте политику депозита и возвратов — собственный аккаунт Stripe вам не нужен.
Инструкции по настройке — в разделе Stripe.
Шаг 8. Настройки уведомлений
Настройте, какие уведомления отправляются клиентам и сотрудникам:
GET /api/org/notification-settings
PUT /api/org/notification-settings
Рекомендуемые уведомления для включения:
- Подтверждение записи (клиенту)
- Напоминание о записи (клиенту) — обычно за 24 часа и за 1 час
- Уведомление о новой записи (сотруднику)
- Уведомление об отмене (обоим)
Код приглашения
Поделитесь кодом приглашения организации с сотрудниками, чтобы они могли присоединиться к вашему рабочему пространству:
POST /api/org/invite-code/generate
Authorization: Bearer your-token
Сотрудники используют этот код при регистрации или при входе с уже существующего аккаунта.
Панель управления
После настройки следите за бизнесом через панель управления:
GET /api/org/dashboard
Authorization: Bearer your-token
Возвращает метрики по сегодняшним записям, предстоящим бронированиям, выручке и последней активности.