Połącz HubSpot z Elido

Integracja HubSpot przekazuje zdarzenia konwersji Elido do HubSpot jako właściwości kontaktów i aktualizacje transakcji. Gdy ktoś kliknie śledzony link i ukończy cel konwersji, Elido przesyła dane atrybucji (źródło UTM, kampania, ID kliknięcia) do HubSpot — bez pisania żadnego kodu.

Połącz przez OAuth#

1. Przejdź do Dashboard → Konwersje → HubSpot → Połącz HubSpot.
2. Otwiera się ekran OAuth HubSpot. Zaloguj się na konto z dostępem "CRM → Objects".
3. HubSpot pokazuje żądane zakresy: crm.objects.contacts.write i crm.objects.deals.write. Pozwalają one Elido pisać do właściwości kontaktów i przenosić transakcje przez etapy.
4. Kliknij Connect app. HubSpot przekierowuje Cię z powrotem do Elido.

Tokeny odświeżania rotują automatycznie. Jeśli cofniesz dostęp od strony HubSpot (Ustawienia → Połączone aplikacje), Elido natychmiast przestaje wysyłać zdarzenia i pokazuje błąd "token revoked" w logu dostarczania.

Mapuj pola#

Po połączeniu przejdź do Dashboard → Konwersje → HubSpot → Konfiguruj:

1. Właściwości kontaktu — wybierz, które właściwości kontaktu HubSpot Elido zapisuje. Dostępne pola Elido: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Etap transakcji — wybierz pipeline i etap, do którego konwersja przenosi transakcję. Zostaw puste jeśli nie używasz transakcji HubSpot.
3. Dopasuj kontakt wg — e-mail (jeśli zbierasz e-mail przez stronę docelową) lub HubSpot contact ID (dla atrybucji po stronie serwera gdzie przekazujesz hs_contact_id w URL).

Co Elido zapisuje w HubSpot#

Każda konwersja tworzy zdarzenie na osi czasu HubSpot i (jeśli zmapowane) aktualizuje właściwości kontaktu. Surowy ładunek wysyłany przez Elido:

{
  "event": "conversion.recorded",
  "click_id": "clk_abc123",
  "value": 99.0,
  "currency": "EUR",
  "utm": {
    "source": "newsletter",
    "medium": "email",
    "campaign": "spring-2026"
  }
}

HubSpot pokazuje to jako niestandardowe zdarzenie na osi czasu w rekordzie kontaktu. Aktualizacja etapu transakcji (jeśli skonfigurowana) następuje w tym samym żądaniu.

Co się nie synchronizuje#

• Zdarzenia kliknięć bez konwersji — surowe kliknięcia nie tworzą rekordów HubSpot. Robią to tylko konwersje.
• Dane historyczne — integracja jest wyłącznie do przodu od momentu połączenia.
• HubSpot → Elido — integracja jest wyłącznie wychodząca. Zmiany etapów transakcji w HubSpot nie wpływają na linki Elido.

Rozwiązywanie problemów#

Błąd "Insufficient permissions" — Użytkownik HubSpot, który autoryzował, nie miał dostępu do zapisu CRM. Poproś super admina HubSpot o ponowną autoryzację z Dashboard → Konwersje → HubSpot → Połącz ponownie.

Kontakt nie znaleziony — zdarzenia odrzucone — Jeśli Elido nie może znaleźć pasującego kontaktu po e-mailu lub ID, zdarzenie jest logowane, ale nie przekazywane. Sprawdź Dashboard → Konwersje → Log dostarczania pod kątem wpisów "no matching contact".

Konwersje docierają z błędną atrybucją kampanii — Sprawdź, czy parametry UTM są obecne na docelowym URL. Elido przechwytuje je z kliknięcia; jeśli link nie ma UTM, pola HubSpot będą puste.

OAuth ciągle wygasa — HubSpot unieważnia tokeny dla aplikacji, które nie wywołują endpointu odświeżania przez 6+ miesięcy. Integracja Elido odświeża przy każdym zdarzeniu. Jeśli nie otrzymałeś żadnych konwersji przez miesiące, połącz ponownie ręcznie.