Інтеграція 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="ваш_source_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 робочих дні.