Интеграция YCLIENTS для онлайн-записи на сайте

Интеграция YCLIENTS для онлайн-записи на сайте

YCLIENTS — российская платформа для управления записью и бизнесом в сфере услуг (салоны красоты, медицина, фитнес). Предоставляет виджет записи и API для интеграции с внешними сайтами.

Встраивание виджета YCLIENTS

<!-- Стандартный виджет -->
<script src="https://widgetv3.yclients.com/widgetJS.js" charset="UTF-8"></script>
<a
  class="yclients-wr-button"
  target="_blank"
  href="https://n123456.yclients.com"
  data-company-id="123456"
  data-source-id="ваш_sourse_id"
>
  Записаться онлайн
</a>

Виджет открывается в попап-окне поверх страницы.

YCLIENTS API v2

API требует токен авторизации. Получение через Basic Auth с логином/паролем аккаунта:

class YclientsApiClient
{
    private string $token;
    private int    $companyId;

    public function authenticate(string $login, string $password): void
    {
        $resp = Http::withHeaders([
            'Authorization' => 'Bearer ' . config('yclients.app_token'),
        ])->post('https://api.yclients.com/api/v1/auth', [
            'login'    => $login,
            'password' => $password,
        ]);

        $this->token = $resp->json('data.user_token');
    }

    public function getBookings(string $startDate, string $endDate): array
    {
        return Http::withHeaders([
            'Authorization' => "Bearer {$this->token}, User {$this->token}",
            'Accept'        => 'application/vnd.yclients.v2+json',
        ])->get("https://api.yclients.com/api/v1/records/{$this->companyId}", [
            'start_date' => $startDate,
            'end_date'   => $endDate,
        ])->json('data');
    }

    public function createBooking(array $data): array
    {
        return Http::withHeaders([
            'Authorization' => "Bearer {$this->token}, User {$this->token}",
        ])->post("https://api.yclients.com/api/v1/book_record/{$this->companyId}", $data)
          ->json('data');
    }
}

Синхронизация данных

YCLIENTS не предоставляет push-webhooks в базовом тарифе. Данные о новых записях получаем через polling:

// Каждые 5 минут проверяем новые записи
$schedule->call(function () {
    $newBookings = app(YclientsApiClient::class)
        ->getBookings(now()->toDateString(), now()->addDay()->toDateString());

    foreach ($newBookings as $booking) {
        YclientsBooking::updateOrCreate(
            ['yclients_id' => $booking['id']],
            [
                'client_name'  => $booking['client']['name'],
                'client_phone' => $booking['client']['phone'],
                'service'      => $booking['services'][0]['title'] ?? null,
                'starts_at'    => $booking['date'],
                'staff_name'   => $booking['staff']['name'] ?? null,
            ]
        );
    }
})->everyFiveMinutes();

Сроки

Встраивание виджета и базовая синхронизация через API: 2–4 рабочих дня.