Интеграция Altegio: кастомная онлайн-запись на сайте под ключ

Как интегрировать Altegio для онлайн-записи?

По статистике, 30% клиентов уходят из-за невозможности записаться онлайн в нерабочее время. Altegio (ранее YCLIENTS Business) решает эту задачу, но интеграция может быть разной: от простого iframe до кастомной формы через API. У нас за плечами 50+ проектов для салонов и клиник — этот опыт помог выявить типичные подводные камни. Например, одна сеть стоматологий потеряла 15% заявок из-за того, что виджет не поддерживал выбор филиала. Мы разработали для них кастомную форму, и конверсия выросла на 40%. В этой статье разберём, какие варианты интеграции существуют и когда стоит выбирать кастом.

Как встроить виджет Altegio на сайт?

Самый быстрый способ — использовать готовый виджет в виде iframe или попапа. Достаточно зарегистрироваться в Altegio, получить ID компании и вставить код на страницу:

<!-- Виджет Altegio через iframe -->
<iframe
  src="https://widget.altegio.com/widget/[COMPANY_ID]/record?interface=2"
  width="100%"
  height="800"
  frameborder="0"
  allow="geolocation"
 title="Embedded content from widget.altegio.com"></iframe>

<!-- Или попап через JS -->
<script src="https://widget.altegio.com/widgetJS.js"></script>
<button onclick="AltegioPro.booking.open()">Записаться</button>
<script>
  AltegioPro.init({ company_id: 'COMPANY_ID', lang: 'ru' });
</script>

Виджет сразу отображает список услуг, свободные слоты и позволяет клиенту забронировать время. Всё это работает из коробки без дополнительной разработки.

Когда стандартного виджета недостаточно?

Если дизайн сайта не совпадает со стилем виджета, либо требуется многошаговая форма с выбором филиала, сотрудника и услуги в несколько этапов, прямой стандартный виджет не впишется. В таких случаях мы строим кастомный UI поверх Altegio API. Вот пример React-компонента с состоянием шагов:

function CustomBookingForm() {
  const [step, setStep]       = useState<'service' | 'master' | 'datetime' | 'confirm'>('service');
  const [serviceId, setService] = useState<number | null>(null);
  const [masterId,  setMaster]  = useState<number | null>(null);

  const { data: services } = useQuery({ queryKey: ['services'], queryFn: fetchServices });
  const { data: staff }    = useQuery({
    queryKey: ['staff', serviceId],
    queryFn:  () => fetchStaff(serviceId!),
    enabled:  !!serviceId,
  });

  // ... многошаговая форма
}

Такой подход даёт полный контроль над UX и позволяет интегрировать нестандартные бизнес-правила, например, обязательный предоплату или скидки по промокодам.

Altegio API: возможности и ограничения

Altegio API полностью совместимо с YCLIENTS API v2. Аутентификация — Bearer токен, который выдаётся в личном кабинете. Основные методы:

class AltegioPApiClient
{
    private const BASE_URL = 'https://api.altegio.com/api/v1';

    public function getServices(): array
    {
        return $this->request('GET', "/services/{$this->companyId}")->json('data');
    }

    public function getStaff(): array
    {
        return $this->request('GET', "/staff/{$this->companyId}")->json('data');
    }

    public function getAvailableDates(int $staffId, int $serviceId): array
    {
        return $this->request('GET', "/book_dates/{$this->companyId}", [
            'staff_id'   => $staffId,
            'service_id' => $serviceId,
        ])->json('data');
    }

    public function createRecord(array $data): array
    {
        return $this->request('POST', "/records/{$this->companyId}", $data)->json('data');
    }
}

Важно: API имеет лимит 10 запросов в секунду. При высоких нагрузках используйте кеширование (Redis/Memcached) и ставьте очередь задач. Также не забывайте про обработку ошибок: 401 при неверном токене, 404 для несуществующих записей, 429 при превышении лимита.

Что даёт кастомная интеграция Altegio?

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

Почему стоит автоматизировать уведомления?

Одна из частых проблем — клиенты забывают о записи. Через API Altegio можно настроить автоматические напоминания: SMS за два часа и email за день. Это снижает количество неявок на 30-40%. В кастомной интеграции мы добавляем выбор способа уведомления прямо в форму записи, что ещё удобнее.

Сравнение: виджет vs кастомная интеграция

Какие ошибки допускают при интеграции Altegio?

Типичные проблемы и их решения:

Процесс работы над интеграцией

1. Аналитика — изучаем бизнес-процессы, определяем, какие данные нужны на сайте.
2. Проектирование — выбираем виджет или кастомную схему, согласовываем дизайн.
3. Разработка — пишем код, настраиваем API-клиент, тестируем запросы.
4. Тестирование — проверяем на реальных сценариях: запись, отмена, напоминания.
5. Деплой — загружаем на продакшен, настраиваем мониторинг.

Что входит в работу

• Готовая интеграция (виджет или кастомная форма) на вашем сайте.
• Документация по дальнейшему использованию.
• Одно обучение администратора (20–30 минут).
• Поддержка в течение двух недель после сдачи.

Свяжитесь с нами для оценки вашего проекта. Получите консультацию по интеграции Altegio — подберём оптимальное решение и назовём сроки.

Интеграция сайта с CRM: Битрикс24, amoCRM, Salesforce, HubSpot

Менеджер по продажам ведёт сделки в CRM, а заявки с сайта падают на почту. Он их вручную переносит. Теряет половину. Забывает перезвонить. Это не проблема менеджера — это архитектурная дыра между сайтом и процессами компании. Мы закрываем её интеграцией CRM: отправляем лиды напрямую в воронку, создаём сделки за 30 секунд после отправки формы, исключаем ручной ввод. Закажите аудит текущей схемы — получите план интеграции под ключ.

Интеграция — это не просто POST в API. Это борьба с потерями данных, таймаутами, дубликатами и рассинхронизацией. Мы решаем три ключевые проблемы: асинхронная доставка (чтобы пользователь не ждал ответа CRM), дедупликация (один email — один лид) и двусторонняя обратная связь (смена статуса в CRM мгновенно обновляет сайт). Ниже — как это работает на практике.

Битрикс24: REST API и события

Битрикс24 — самая распространённая CRM на российском рынке. REST API доступен через OAuth 2.0 или через incoming webhook (проще, но менее безопасно для продакшена). Основные сущности: lead, deal, contact, company.

Создание лида: POST /rest/crm.lead.add с набором полей. Привязка к воронке: SOURCE_ID. Добавление комментария: crm.timeline.comment.add. Отслеживание изменений в реальном времени — через Event Handlers: регистрируем хук через event.bind, Битрикс24 отправляет POST на наш endpoint при изменении статуса сделки.

Сложность Битрикс24 — кастомные поля. У каждой установки они уникальны, их ID нужно узнавать через crm.lead.fields. Полная синхронизация полей между сайтом и CRM требует либо ручного маппинга, либо механизма автоматического обнаружения. Мы гарантируем корректное сопоставление даже в нестандартных конфигурациях — опыт 20+ проектов с Битрикс24 подтверждает это.

amoCRM: современный REST

amoCRM (теперь Kommo для международного рынка) имеет более чистый API. OAuth 2.0 с refresh token, JSON API, предсказуемые endpoint. Воронки — pipelines, сделки — leads, контакты — contacts.

Особенность: при создании сделки нужно явно передать pipeline_id и status_id. Без них сделка попадает в дефолтную воронку, что часто не то, что нужно. Теги для классификации источников лидов — через _embedded.tags. Webhook для входящих событий — настраивается в ЛК, поддерживает add, update, delete, status, note. Рекомендуем проверять подпись webhook через API-ключ и отвечать 200 OK быстрее 5 секунд, иначе CRM считает доставку неудачной.

Salesforce и HubSpot: enterprise-уровень

Salesforce — enterprise выбор. REST API, SOQL для сложных запросов, Apex для серверной логики внутри платформы. Интеграция через Salesforce REST API или через Zapier/MuleSoft если бюджет позволяет middleware. Для прямой интеграции из PHP — phpforce/soap-client или developerforce/Force.com-Toolkit-for-PHP. Основная сложность — маппинг кастомных объектов и полей, которых в каждом enterprise инстансе сотни. Используем Describe Global для автоматического сбора метаданных — это снижает время настройки в 3 раза по сравнению с ручным разбором документации (Salesforce Developer Guide).

HubSpot — популярен у SaaS-компаний и международного B2B. HubSpot API v3 — REST, хороший SDK для PHP и Node.js (@hubspot/api-client). Contacts, Companies, Deals — стандартные объекты. Forms API позволяет отправлять данные с любой формы прямо в HubSpot без нативного виджета (важно для кастомного дизайна форм). Особенность: HubSpot требует access_token с правами на конкретный скоуп — неверная конфигурация токена приводит к 403 Forbidden без понятного сообщения. Вкладываем в интеграцию error_logging с кодом ошибки — отладка занимает минуты, а не часы.

Какую CRM выбрать: Битрикс24, amoCRM или HubSpot?

Почему важна асинхронная отправка?

Синхронный запрос к API CRM прямо из обработчика формы — плохая идея. API может быть недоступен 2 секунды, пользователь ждёт. Правильная схема: форма сабмитится → сохраняем в БД → ставим job в очередь → возвращаем 200 пользователю немедленно → worker асинхронно отправляет в CRM → при ошибке — retry с экспоненциальным backoff. Мы используем Redis + Bull (Node.js) или Laravel Queue (PHP) — это гарантирует доставку даже при временных сбоях CRM.

Дедупликация. Один и тот же контакт может заполнить форму дважды. CRM не должна создавать два дублирующих лида. Проверка перед созданием: поиск по email через crm.duplicate.findByComm (Битрикс24) или contacts/search (HubSpot), если найден — добавляем задачу/комментарий к существующему, не создаём новый. Снижает количество дубликатов на 95% по опыту наших проектов.

Двусторонняя синхронизация. Если менеджер меняет статус сделки в CRM — сайт должен знать (например, для личного кабинета клиента). Webhooks от CRM → endpoint на сайте → обновление статуса в БД → уведомление клиенту. Важно: проверять подпись webhook и отвечать 200 OK быстро (до 5 секунд), иначе CRM считает доставку неудачной. Мы гарантируем, что задержка между изменением статуса в CRM и появлением на сайте не превышает 3 секунд.

Как мы проводим интеграцию: 5 шагов

1. Аудит потоков данных — анализируем текущую передачу заявок, структуру полей CRM, выявляем узкие места. На выходе — схема «как есть» и «как будет».
2. Проектирование архитектуры — выбираем механизм очереди (Redis Bull, Laravel Queue), определяем способ дедупликации, маппинг полей. Готовим спецификацию endpoint.
3. Реализация на staging — пишем код на Laravel или Node.js, настраиваем webhook, тестируем с реальными данными: создание лидов, обновление статусов, обработка ошибок.
4. Нагрузочное тестирование — проверяем, как система справляется с пиковыми нагрузками (например, 500 заявок в минуту). Исправляем тайминги и retry-политики.
5. Деплой и документирование — выкатываем на продакшн, обучаем команду, передаём инструкцию по мониторингу и чистке повторных попыток.

Что входит в работу (deliverables)

• Аудит текущих процессов — схема потоков данных, структура полей CRM, типичные ошибки.
• Проектирование архитектуры — выбор очереди, механизм дедупликации, маппинг полей.
• Реализация интеграции — код на Laravel/Node.js, настройка webhook, тестирование на staging.
• Документация — описание endpoint, инструкция для менеджера, схема обработки ошибок.
• Обучение команды — кто отвечает за поддержку, как чистить повторные попытки.
• Гарантийная поддержка — 30 дней после деплоя: исправление багов, корректировка маппинга.

Сроки и стоимость

Стоимость рассчитывается индивидуально после аудита текущих процессов и структуры данных в CRM. Экономия на ручном вводе — от 50 000 до 150 000 рублей в месяц. Типичный бюджет интеграции — от 40 000 до 200 000 рублей в зависимости от CRM и сложности. Свяжитесь с нами для оценки проекта — мы пришлём коммерческое предложение в течение одного рабочего дня. Опыт 5+ лет и 20+ проектов интеграций с различными CRM гарантирует результат без скрытых проблем. Получите консультацию инженера, чтобы убедиться: ваша воронка продаж начнёт работать без ручного переноса данных.

Дополнительные источники: Customer relationship management (Wikipedia) · REST API (Wikipedia)