Met de HubSpot Lead-app koppel je de Salesdock leadsmodule aan je HubSpot-omgeving. Zodra een lead-status in Salesdock verandert, werkt Salesdock automatisch het bijbehorende contact en/of de bijbehorende deal in HubSpot bij. Handig als je sales-team in HubSpot werkt, maar het verkoop- en plannings-proces in Salesdock loopt.
Vooraf van belang: de koppeling werkt op basis van een Contact ID en/of Deal ID uit HubSpot die je in Salesdock per lead beschikbaar moet hebben. Zonder die ID's weet Salesdock niet welk HubSpot-record bijgewerkt moet worden. Je kunt die ID's via een lead-import meegeven, handmatig op een lead invullen, of meesturen bij het aanmaken van een lead via de Salesdock API.
Stap 1: extra velden aanmaken voor de HubSpot-ID's
Maak in Salesdock een lead-extraveld aan voor het Contact ID en (indien je ook deals wil bijwerken) een tweede voor het Deal ID:
- Ga naar Instellingen → Extra velden → Lead.
- Voeg een extra veld toe met de naam Contact ID (en eventueel een tweede genaamd Deal ID).
- Sla op.
Deze velden zul je in stap 4 koppelen aan de bijbehorende HubSpot-ID's.
Stap 2: de app installeren
Open Apps in het zijmenu, zoek HubSpot Lead en installeer de app. Daarna verschijnen de sub-tabs Instellingen, Lead data mapping, Statuskoppeling en Deals.
Stap 3: instellingen invullen
Op het tabblad Instellingen:
- Zet de app op actief.
- Zet de modus op productie.
- Voer de API-key uit jouw HubSpot-omgeving in.
- Geef aan of leads automatisch verwerkt moeten worden zodra een lead-status wijzigt (anders moet je het per lead handmatig triggeren).
- Beperk optioneel de werking tot bepaalde gebruikers en/of organisaties. Laat je dit leeg, dan geldt de integratie voor iedereen binnen je account.
Stap 4: Lead data mapping
Open de sub-tab Lead data mapping. Koppel hier de zojuist aangemaakte extra velden:
- Contact ID → het Salesdock-extraveld dat het HubSpot Contact ID bevat.
- Deal ID → het Salesdock-extraveld dat het HubSpot Deal ID bevat (alleen nodig als je ook deals wil bijwerken).
Stap 5: Statuskoppeling
Op het tabblad Statuskoppeling haalt Salesdock dynamisch de waarden van het HubSpot-veld hs_lead_status uit jouw omgeving op. Daarmee kun je per Salesdock-leadstatus aangeven welke HubSpot-status het contact moet krijgen.
Voorbeeld: heb je in HubSpot de contact-status "Voorstel verstuurd" en in Salesdock de lead-status "Voorstel uitgebracht"? Koppel ze hier aan elkaar — zodra een agent in Salesdock een lead naar "Voorstel uitgebracht" zet, krijgt het contact in HubSpot automatisch de status "Voorstel verstuurd".
Stap 6: Deals
Wil je ook deals in HubSpot bijwerken? Open dan de sub-tab Deals. Hier haalt Salesdock de dealstatussen op uit jouw HubSpot-omgeving (via het HubSpot-endpoint /pipelines/deal) en koppel je ze op dezelfde manier aan Salesdock-statussen als bij de contact-statuskoppeling.
Optioneel: reden-verloren mappen
Werk je in HubSpot met een eigen veld voor "reden verloren" (of een vergelijkbaar HubSpot-property)? Vul dan het veld Veld reden verloren met de exacte property-naam zoals die in HubSpot bestaat (bijvoorbeeld redenen_verloren of extra_statussen). Salesdock controleert die naam tegen het HubSpot-endpoint /properties/deal.
Vindt Salesdock een match, dan verschijnt een extra reden-verloren-component. Daar koppel je:
- Deal reden → een meerkeuze-leadvraag in jouw Salesdock-flow waarin de agent de verloren-reden noteert.
- Reden-mapping → per HubSpot-waarde (rechts) kies je de bijbehorende antwoordoptie uit de leadvraag (links).
Zodra een lead op verloren wordt gezet, stuurt Salesdock zowel de status als de gemapte reden door naar HubSpot.
Vragen?
Loop je tegen iets aan tijdens de inrichting of werkt de koppeling niet zoals verwacht? Neem contact op met onze supportdesk, dan kijken we mee.