Подключение HubSpot к Elido

Интеграция с HubSpot передает события конверсии Elido в HubSpot в качестве свойств контактов и обновлений сделок. Когда кто-то нажимает на отслеживаемую ссылку и достигает цели конверсии, Elido отправляет данные атрибуции (UTM source, campaign, click ID) в HubSpot — без написания вами какого-либо кода.

Подключение через OAuth#

1. Перейдите в Dashboard → Conversions → HubSpot → Connect HubSpot.
2. Откроется экран HubSpot OAuth. Войдите в аккаунт, имеющий доступ "CRM → Objects".
3. HubSpot показывает запрошенные области: crm.objects.contacts.write и crm.objects.deals.write. Они позволяют Elido записывать свойства контактов и перемещать сделки по этапам.
4. Нажмите Connect app. HubSpot перенаправит вас обратно в Elido.

Токены обновления автоматически ротируются. Если вы отзовете доступ со стороны HubSpot (Settings → Connected Apps), Elido немедленно прекратит отправку событий и покажет ошибку "token revoked" в журнале доставки.

Сопоставление полей#

После подключения перейдите в Dashboard → Conversions → HubSpot → Configure:

1. Свойства контактов — выберите, в какие свойства контактов HubSpot Elido будет записывать данные. Доступные поля Elido: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Этап сделки — выберите воронку и этап, на который конверсия перемещает сделку. Оставьте пустым, если вы не используете сделки HubSpot.
3. Сопоставлять контакт по — email (если вы собираете email через свою целевую страницу) или HubSpot contact ID (для серверной атрибуции, где вы передаете hs_contact_id в URL).

Что Elido записывает в HubSpot#

Каждая конверсия создает событие на временной шкале HubSpot и (если сопоставлено) обновляет свойства контакта. Необработанная полезная нагрузка, которую отправляет 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 обновляется при каждом событии. Если вы не получали конверсий в течение нескольких месяцев, переподключитесь вручную.