HubSpot verbinden met Elido

De HubSpot-integratie stuurt Elido-conversiegebeurtenissen door naar HubSpot als contacteigenschappen en dealupdates. Wanneer iemand op een gevolgde link klikt en een conversiedoel voltooit, stuurt Elido de attributiegegevens (UTM-bron, campagne, click-ID) naar HubSpot — zonder dat je code hoeft te schrijven.

Verbinden via OAuth

1. Ga naar Dashboard → Conversions → HubSpot → Connect HubSpot.
2. Het OAuth-scherm van HubSpot opent. Log in met een account dat toegang heeft tot "CRM → Objects".
3. HubSpot toont de aangevraagde scopes: crm.objects.contacts.write en crm.objects.deals.write. Hiermee kan Elido schrijven naar contacteigenschappen en deals door fases verplaatsen.
4. Klik op Connect app. HubSpot stuurt je terug naar Elido.

Refresh tokens worden automatisch ververst. Als je toegang intrekt vanuit HubSpot (Settings → Connected Apps), stopt Elido onmiddellijk met het versturen van gebeurtenissen en toont het bezorgingslogboek een foutmelding "token revoked".

Velden toewijzen

Ga na het verbinden naar Dashboard → Conversions → HubSpot → Configure:

1. Contacteigenschappen — kies naar welke HubSpot-contacteigenschappen Elido schrijft. Beschikbare Elido-velden: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Dealfase — selecteer de pipeline en fase waarnaar een conversie een deal verplaatst. Laat leeg als je geen HubSpot-deals gebruikt.
3. Contact matchen op — e-mail (als je e-mail vastlegt via je landingspagina) of HubSpot-contact-ID (voor server-side attributie waarbij je hs_contact_id in de URL doorgeeft).

Wat Elido naar HubSpot schrijft

Elke conversie maakt een HubSpot-tijdlijngebeurtenis aan en werkt (indien toegewezen) de contacteigenschappen bij. De ruwe payload die Elido verstuurt:

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

HubSpot toont dit als een aangepaste tijdlijngebeurtenis op het contactrecord. De update van de dealfase (indien geconfigureerd) wordt in dezelfde aanvraag uitgevoerd.

Wat niet synchroniseert

• Klikgebeurtenissen zonder conversie — losse klikken maken geen HubSpot-records aan. Alleen conversies doen dat.
• Historische gegevens — de integratie werkt alleen vooruit vanaf het moment dat je verbinding maakt.
• HubSpot → Elido — de integratie is alleen uitgaand. Wijzigingen in HubSpot-deals stromen niet terug naar Elido.

Probleemoplossing

Foutmelding "Insufficient permissions" — De HubSpot-gebruiker die autoriseerde, had geen schrijftoegang tot CRM. Vraag een HubSpot-superbeheerder om opnieuw te autoriseren via Dashboard → Conversions → HubSpot → Reconnect.

Contact niet gevonden — gebeurtenissen verworpen — Als Elido geen bijpassend contact kan vinden op e-mail of ID, wordt de gebeurtenis gelogd maar niet doorgestuurd. Controleer Dashboard → Conversions → Delivery log op vermeldingen van "no matching contact".

Conversies komen binnen met verkeerde campagne-attributie — Controleer of UTM-parameters aanwezig zijn op de bestemmings-URL. Elido legt deze vast bij de klik; als de link geen UTM's heeft, zijn de HubSpot-velden leeg.

OAuth blijft verlopen — HubSpot trekt tokens in voor apps die het refresh-endpoint 6 maanden of langer niet aanroepen. De Elido-integratie ververst bij elke gebeurtenis. Heb je maanden geen conversies ontvangen, verbind dan handmatig opnieuw.