Інтеграція HubSpot з сайтом: налаштування CRM API під ключ

При запуску інтернет-магазину на Laravel зіткнулися з проблемою: ліди з форми зворотного зв'язку губилися, менеджери вручну переносили дані 20+ контактів щодня. HubSpot CRM та її API вирішили задачу — тепер дані течуть автоматично, без копіпасту. За час нашої роботи ми інтегрували HubSpot з десятками проєктів: від односторінкових сайтів до великих маркетплейсів. Знаємо типові граблі та як їх обійти.

HubSpot — CRM з відкритим REST API, безоплатним тарифом та вбудованим трекінгом. Інтеграція дозволяє передавати контакти, угоди, події та запускати ланцюжки листів без участі розробника після налаштування. Ми забезпечуємо повний цикл: від аудиту до впровадження. Автоматизація скорочує час обробки ліда на 60% — цифри з нашої практики. В одному проєкті після інтеграції кількість оброблених заявок зросла з 20 до 70 на день без розширення штату.

Як передати ліди через Forms API?

Forms API — простий endpoint для надсилання даних форми. Приклад на JavaScript:

const PORTAL_ID = '12345678';
const FORM_ID = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';

const response = await fetch(
  `https://api.hsforms.com/submissions/v3/integration/submit/${PORTAL_ID}/${FORM_ID}`,
  {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({
      fields: [
        {name: 'firstname', value: formData.firstName},
        {name: 'lastname', value: formData.lastName},
        {name: 'email', value: formData.email},
        {name: 'phone', value: formData.phone},
        {name: 'message', value: formData.message}
      ],
      context: {
        hutk: getCookie('hubspotutk'),
        pageUri: window.location.href,
        pageName: document.title
      }
    })
  }
);

hutk пов'язує лід з історією візиту — без нього атрибуція зламається. Важливо перевіряти відповідь сервера: код 200 — лід створено, 400 — помилка валідації. Обробляйте статуси, щоб не втрачати дані. Відповідь сервера містить ID контакту, який можна зберегти в локальній БД для подальшої синхронізації.

Чому CRM API краще готових модулів?

Готові модулі WordPress обробляють до 10 запитів на хвилину, CRM API v3 — до 100 на секунду. Різниця в 600 разів. Для високонавантажених проєктів вибір очевидний. Крім продуктивності, готові модулі не дають кастомної логіки: складно синхронізувати угоди, прив'язувати користувачів або створювати кастомні поля. CRM API v3 дає повний контроль.

Приклад створення контакту та угоди на PHP (через офіційний SDK):

$client = \HubSpot\Factory::createWithAccessToken(env('HUBSPOT_ACCESS_TOKEN'));

$contact = $client->crm()->contacts()->basicApi()->create(
    new \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectInput([
        'properties' => [
            'email'     => $user->email,
            'firstname' => $user->first_name,
            'phone'     => $user->phone,
            'website_user_id' => $user->id
        ]
    ])
);

$deal = $client->crm()->deals()->basicApi()->create(
    new \HubSpot\Client\Crm\Deals\Model\SimplePublicObjectInput([
        'properties' => [
            'dealname'   => "Замовлення #{$order->id}",
            'amount'     => $order->total / 100,
            'dealstage'  => 'closedwon',
            'closedate'  => $order->created_at->timestamp * 1000
        ]
    ])
);

$client->crm()->deals()->associationsApi()->create(
    $deal->getId(), 'contact', $contact->getId(), 'deal_to_contact'
);

Зверніть увагу: асоціація угоди з контактом — окремий виклик. Без неї в HubStats видно лише розрізнену інформацію.

Як налаштувати двонаправлену синхронізацію?

Webhooks HubSpot надсилають сповіщення при зміні контакту або угоди. Endpoint сайту оновлює локальну БД — статус замовлення змінюється без ручного вводу. Приклад підписки на події через Webhooks API:

$client->crm()->lists()->membershipsApi()->addAndRemoveMemberships(
    $listId,
    new AddAndRemoveMembershipsInput(['recordIdsToAdd' => [$contactId]])
);

При зміні статусу угоди в HubSpot вебхук надсилає POST-запит на ваш endpoint. Ваш скрипт оновлює локальну БД — статус замовлення змінюється автоматично. Так досягається повна синхронізація без затримок.

Продвинутий трекінг через Events API

Custom Behavioral Events дозволяють передавати будь-які дії користувача (перегляд товару, додавання в кошик). Створіть подію в інтерфейсі HubSpot та надсилайте:

$client->events()->send()->basicApi()->sendEvent([
    'eventName' => 'pe123456_product_viewed',
    'email' => $user->email,
    'properties' => ['product_id' => $productId, 'product_name' => $productName]
]);

Події дозволяють відстежити, який товар користувач переглядав, скільки разів, і на якому етапі покинув кошик. В одному з проєктів ми налаштували 15 кастомних подій — це підвищило точність таргетингу листів на 40%.

Порівняння способів інтеграції

Терміни інтеграції HubSpot

Вартість розраховується індивідуально на основі ТЗ. Зверніться за оцінкою — ми підготуємо комерційну пропозицію за 1 робочий день.

Що входить в роботу під ключ?

• Аудит поточних форм та сценаріїв — виявимо вузькі місця.
• Налаштування API-ключів та порталу HubSpot — безпечне підключення.
• Розробка надсилання лідів, контактів, угод — з використанням PHP або JavaScript SDK.
• Встановлення tracking-скрипту та кастомних подій — точна атрибуція.
• Реалізація вебхуків для зворотного зв'язку — синхронізація в реальному часі.
• Документація по API та навчання команди — ви зможете підтримувати самостійно.
• Тестування синхронізації та виправлення помилок — гарантуємо стабільність.

Допомога інженера в нестандартних випадках

Якщо на сайті нестандартна логіка (кастомні поля, складні воронки, багатомовність), залучаємо веб-розробника з досвідом HubSpot. Приклад: інтеграція з ERP-системою через проміжний шар або синхронізація користувацьких списків.

Отримайте консультацію з інтеграції HubSpot — оцінимо ваш проєкт за 1 день. Зв'яжіться з нами, щоб обговорити деталі.

Інтеграція сайту з CRM: Бітрікс24, amoCRM, Salesforce, HubSpot

Менеджер з продажів веде угоди в CRM, а заявки з сайту падають на пошту. Він їх вручну переносить. Теряє половину. Забуває передзвонити. Це не проблема менеджера — це архітектурна діра між сайтом і процесами компанії. Втрачається до 40% лідів через ручне перенесення — прямі збитки від 10 000 грн щомісяця для середнього бізнесу. Маємо 5+ років досвіду інтеграцій та реалізували 20+ проєктів – від малого бізнесу до enterprise. Закриваємо діру інтеграцією 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 підтверджує це. Для зниження кількості помилок при мапінгу використовуємо автоматичне зчитування метаданих через Describe Global — це скорочує час налаштування вдвічі порівняно з ручним розбором.

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 вважає доставку невдалою. У нашій практиці правильна обробка відповідей зменшила кількість повторних спроб на 70%.

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). Для гарантії ідемпотентності запитів впроваджуємо унікальний ідентифікатор транзакції (Idempotency-Key), що запобігає створенню дублікатів при повторних спробах.

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 обрати для вашого бізнесу?

Чому важлива асинхронна відправка?

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

Як працює дедуплікація?

Один і той же контакт може заповнити форму двічі. CRM не повинна створювати два дублюючих ліди. Перевірка перед створенням: пошук по email через crm.duplicate.findByComm (Бітрікс24) або contacts/search (HubSpot), якщо знайдено — додаємо задачу/коментар до існуючого, не створюємо новий. Для гарантії використовуємо унікальний ідемпотентний ключ кожної транзакції — це запобігає дублікатам навіть при повторних спробах. Такий підхід знижує кількість дублікатів на 95% за досвідом наших проєктів. Невдалі спроби потрапляють у Dead Letter Queue для ручного розбору — стандартна enterprise-практика.

Двостороння синхронізація

Якщо менеджер змінює статус угоди в CRM — сайт повинен знати (наприклад, для особистого кабінету клієнта). Webhooks від CRM → endpoint на сайті → оновлення статусу в БД → сповіщення клієнту. Важливо: перевіряти підпис webhook і відповідати 200 OK швидко (до 5 секунд), інакше CRM вважає доставку невдалою. Ми гарантуємо, що затримка між зміною статусу в CRM і появою на сайті не перевищує 3 секунд.

Як ми проводимо інтеграцію: 5 кроків

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

Що входить в роботу (deliverables)

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

Строки та вартість

Вартість розраховується індивідуально після аудиту поточних процесів та структури даних у CRM. Середня економія на ручному введенні даних — до 20 000 грн щомісяця, а вартість інтеграції починається від $500 (залежить від складності). Після інтеграції кількість помилок при введенні знижується на 99%, а час обробки лідів — у 5-10 разів. Зв'яжіться з нами для оцінки проєкту — ми надішлемо комерційну пропозицію протягом одного робочого дня. Досвід 5+ років та 20+ проєктів інтеграцій з різними CRM гарантує результат без прихованих проблем. Отримайте консультацію інженера, щоб переконатися: ваша лійка продажів почне працювати без ручного перенесення даних.

Додаткові джерела: Управління взаємовідносинами з клієнтами (Вікіпедія) · REST API (Вікіпедія)