Що ви налаштуєте
- OAuth-з'єднання, що надає Elido права доступу
crm.objects.contacts.writeтаcrm.objects.deals.write. - Зіставлення полів UTM та даних кліків Elido з властивостями контактів і етапами угод HubSpot.
- Автоматичний запис подій конверсії як записів часової шкали HubSpot — без написання коду.
Інтеграція з HubSpot передає події конверсії Elido в HubSpot як властивості контактів та оновлення угод. Коли хтось переходить за відстежуваним посиланням і виконує ціль конверсії, Elido передає дані атрибуції (джерело UTM, кампанія, ID кліку) в HubSpot — без написання жодного коду.
Підключення через OAuth#
- Перейдіть у Dashboard → Conversions → HubSpot → Connect HubSpot.
- Відкриється екран OAuth HubSpot. Увійдіть за допомогою облікового запису, який має доступ до «CRM → Objects».
- HubSpot покаже запитувані дозволи (scopes):
crm.objects.contacts.writeтаcrm.objects.deals.write. Вони дозволяють Elido записувати властивості контактів та переміщувати угоди за етапами. - Натисніть Connect app. HubSpot перенаправить вас назад до Elido.
Токени оновлення (refresh tokens) змінюються автоматично. Якщо ви скасуєте доступ з боку HubSpot (Settings → Connected Apps), Elido негайно припинить надсилати події та покаже помилку «token revoked» у журналі доставки.
Зіставлення полів#
Після підключення перейдіть у Dashboard → Conversions → HubSpot → Configure:
- Contact properties — виберіть властивості контакту HubSpot, у які Elido записуватиме дані. Доступні поля Elido:
utm_source,utm_medium,utm_campaign,utm_content,utm_term,click_id,link_slug. - Deal stage — виберіть воронку та етап, на який конверсія переміщує угоду. Залиште порожнім, якщо ви не використовуєте угоди HubSpot.
- Match contact by — email (якщо ви збираєте email через цільову сторінку) або HubSpot contact ID (для атрибуції на стороні сервера, де ви передаєте
hs_contact_idв URL).
Що Elido записує в HubSpot#
Кожна конверсія створює подію на часовій шкалі (timeline event) HubSpot і (якщо налаштовано зіставлення) оновлює властивості контакту. Сирі дані (payload), які надсилає Elido:
{
"event": "conversion.recorded",
"click_id": "clk_abc123",
"value": 99.0,
"currency": "EUR",
"utm": {
"source": "newsletter",
"medium": "email",
"campaign": "spring-2026"
}
}
HubSpot відображає це як спеціальну подію часової шкали в записі контакту. Оновлення етапу угоди (якщо налаштовано) виконується в тому ж запиті.
Що не синхронізується#
- Події кліків без конверсії — звичайні кліки не створюють записів у HubSpot. Це роблять лише конверсії.
- Історичні дані — інтеграція працює лише для нових подій з моменту підключення.
- HubSpot → Elido — інтеграція працює лише в одному напрямку (вихідному). Зміни угод у HubSpot не передаються назад в Elido.
Усунення несправностей#
Помилка «Insufficient permissions» — Користувач HubSpot, який надав авторизацію, не мав прав на запис у CRM. Попросіть суперадміна HubSpot повторно авторизуватися через Dashboard → Conversions → HubSpot → Reconnect.
Контакт не знайдено — події відхилено — Якщо Elido не може знайти відповідний контакт за email або ID, подія реєструється, але не пересилається. Перевірте Dashboard → Conversions → Delivery log на наявність записів «no matching contact».
Конверсії надходять з неправильною атрибуцією кампанії — Переконайтеся, що параметри UTM присутні в цільовому URL. Elido фіксує їх під час кліку; якщо посилання не має UTM-міток, поля HubSpot будуть порожніми.
Термін дії OAuth постійно закінчується — HubSpot анулює токени для програм, які не звертаються до кінцевої точки оновлення протягом 6+ місяців. Інтеграція Elido оновлює токен під час кожної події. Якщо ви не отримували конверсій протягом місяців, підключіться повторно вручну.