Прямая интеграция API онлайн-записи в Яндекс Бизнесе: когда это нужно и как внедрить

Кнопка «Записаться онлайн» в Яндекс Картах обеспечивает до 38% первичных конверсий в бьюти-сфере и медицине. При этом 74% сетевых компаний теряют трафик из-за рассинхронизации: клиент видит свободное окно, но получает отказ при попытке записи. Прямое подключение через API исключает ручной перенос слотов и передает данные в Яндекс Карты без задержек.

Прямой API против интеграции через CRM

Яндекс Бизнес предлагает два способа запуска бронирования. Первый — использование аккредитованных CRM (YClients, Altegio, Dikidi, 1 °C Салон красоты, НаПоправку, Sycret). Второй — прямое подключение через Booking API. Для студии на два кресла облачный сервис решает все задачи. Однако при масштабировании сети готовые модули ограничивают маркетинг, передают базовый набор полей и работают с задержками. Если вам достаточно стандартных настроек, изучите технический гайд по подключению онлайн-записи в Яндекс Бизнесе.

Прямой API связывает внутреннюю МИС с базами Яндекса напрямую. Запрос из карт попадает во внутренний контур клиники, бронирует время и возвращает подтверждение без участия посредников.

Сравнение архитектурных подходов к передаче расписания.

Условия доступа к прямому API

Доступ к прямому API регламентирован. Согласно справке Яндекс Бизнеса, способ подходит организациям с фактическим адресом двух типов. Первый — крупные сети, которые хотят подключить онлайн-запись через собственную CRM-систему. Второй — разработчики CRM-систем, которые хотят стать партнером Яндекса и уже подключили более 300 компаний в свою систему.

Если у компании 5-10 филиалов, заявку отклонят на этапе модерации. Таким компаниям доступна онлайн-запись в Яндекс Картах через CRM или прямой API через список партнеров. По умолчанию для подключения доступны только рубрики сегмента красоты. Если у вашей организации другой основной вид деятельности — уточните это при первом контакте с менеджером.

Технические требования: протоколы и вебхуки

Интеграция занимает в среднем один месяц. Скорость запуска зависит от соблюдения спецификации. Процесс тестируется на окружениях Testing и Production.

Яндекс предъявляет требования к архитектуре ответов. Отклонения вызывают ошибку 406:

Вебхуки применяются для синхронизации отмен. При отмене визита в МИС сервер отправляет запрос PUT https://partner.maps.yandex.net/booking/v1/partners/{partnerName}/{bookingId}.

Зачем переходить на прямую интеграцию

Оформление внутри Яндекс Карт сокращает путь клиента. Пациенту не нужно переходить на сайт или заполнять данные повторно. В медицине скорость отклика критична. Прямой API отдает свободные окна за миллисекунды. Это позволяет реализовать онлайн-запись в Яндекс Бизнесе для медицинских клиник с учетом квалификации врачей.

В салонах API позволяет выбирать конкретного мастера через поля title и description, где передаются имя и квалификация специалиста.

Этапы запуска

1. Заявка. Руководитель подписывает оферту и заполняет форму.
2. Материалы. Передача логотипа: векторный черный SVG, высота 16 px.
3. Тестовый контур. Настройка сервера Testing.
4. Сборка фида. Формирование данных по филиалам, услугам и персоналу.
5. Вебхуки. Настройка обмена статусами.
6. Регресс. Тестовые бронирования и вывод в Production.

Пример: сеть на 320 филиалов

Сеть студий педикюра с 320 точками и своей системой на PostgreSQL внедрила API, чтобы избавиться от 14% задвоенных записей.

1. Разработчики создали микросервис на Node.js для трансформации данных в JSON формата Booking API.
2. Юристы подписали оферту, IT подготовили векторные логотипы.
3. Филиалы сопоставили с ID в Яндекс Бизнесе.
4. Настроили JWT без iat, обработку пустого массива availableTimeSlots и статус cancelled.
5. Внедрена двухсторонняя синхронизация через вебхуки.

Результат: кнопка заработала через 8 дней. Время подтверждения — 1,2 секунды. Доля записей без участия операторов — 41%.

Диагностика овербукинга

Главный риск — рассинхронизация остатков. При нажатии клиентом на слот в Картах бэкенд должен блокировать время на 10-15 минут во внутренней системе. Если график в профиле не совпадает с данными API, Яндекс заблокирует кнопку действия.

Чек-лист готовности

1. Сеть от 300 филиалов или статус разработчика CRM.
2. Подтвержденный адрес и график работы на Картах.
3. Заголовок Content-Type: application/json.
4. Отсутствие редиректов HTTPS-HTTP.
5. Формат ISO 8601 с таймзоной.
6. Возврат [] вместо null.
7. JWT в режиме --no-iat.
8. Поля title и description для специалистов.
9. Статус cancelled.
10. Настроенные вебхуки.
11. Логотип SVG 16 px.
12. Технический специалист для связи в Telegram.

Частые вопросы