Salesforce API koppelen aan je website.

Salesforce is een CRM-platform voor verkoop, service en marketing. Voor een website gaat het bijna altijd om Sales Cloud: het deel waarin je verkoopteam werkt met Leads, Accounts, Contacts en Opportunities.

Een Lead is een aanvraag die nog niet gekwalificeerd is. Zodra sales er een kans in ziet, wordt de Lead omgezet naar een Account, een Contact en een Opportunity. Dat moment, en het moment dat de Opportunity gewonnen wordt, zijn later de interessante momenten voor je advertenties.

Salesforce is ingericht per organisatie, en die omgeving heet een org. Velden, regels en processen verschillen per org, dus een koppeling begint altijd met kijken hoe die van jou is ingericht. Werk je met een kleiner team en nog zonder Salesforce, dan is een koppeling met HubSpot of Pipedrive vaak de kortere route.

Salesforce heeft zelf een manier om formulieren binnen te halen: Web-to-Lead. Je genereert in Salesforce een stuk HTML met het ID van je org erin, en het formulier stuurt rechtstreeks vanuit de browser naar Salesforce. Er is geen sleutel en geen server voor nodig, en reCAPTCHA staat standaard aan.

Dat werkt voor een klein formulier met weinig verkeer. De grenzen zitten in de 500 leads per dag, in de wachtrij daarboven, en in het feit dat je pagina niet hoort of het gelukt is. Ook de opmaak en de meting liggen vast aan wat Salesforce genereert.

De REST API is de route die wij meestal kiezen. Het formulier staat in je eigen ontwerp en stuurt naar je eigen server, en die maakt de Lead aan. De server krijgt een antwoord terug, dus een fout vangen we op en melden we, in plaats van dat hij in een mailbox verdwijnt. Voorwaarde is wel een editie met API-toegang.

De REST API draait op het adres van je eigen org: https://jouwdomein.my.salesforce.com/services/data/ met het versienummer erachter. Een Lead maak je aan met een POST op het object Lead, en je krijgt het ID van het nieuwe record terug.

Toegang loopt via OAuth 2.0. In Salesforce maak je een external client app aan, en die krijgt een token voor een vaste gebruiker. Wij gebruiken daarvoor een aparte integratiegebruiker met alleen API-rechten, zodat de koppeling niet stilvalt als een medewerker vertrekt of zijn wachtwoord wijzigt.

Bestaat de persoon al, dan wil je geen tweede Lead. Daarvoor zijn twee instrumenten: de duplicaatregels van Salesforce, die je via een header per aanroep kunt sturen, en upsert op een extern ID, waarmee je een record bijwerkt als het al bestaat. Welke past, hangt af van hoe je org met duplicaten omgaat.

Naam en e-mailadres zijn het minste. Wat de koppeling waardevol maakt is de context: het standaardveld Lead Source, de pagina waar het formulier stond, en de UTM-waarden van de campagne waarmee iemand binnenkwam. Komen er leads via de telefoon binnen, dan kan AdCalls ze met bron en campagne als lead in Salesforce zetten.

Voor Google Ads komt daar de gclid bij. Dat is de klik-ID die Google Ads aan de URL toevoegt als automatisch taggen aanstaat. Wij bewaren die bij het eerste bezoek in een cookie, na toestemming, zodat hij er nog is als iemand pas drie pagina's later het formulier invult.

In Salesforce komen daar eigen velden voor op de Lead, en dezelfde velden op de Opportunity, met een veldkoppeling zodat ze meegaan bij het omzetten. Zonder die koppeling staat de gclid op de Lead en is hij weg zodra sales de deal maakt.

Een formulier is nog geen klant. Wie Google Ads laat sturen op formulieren, krijgt meer formulieren, ook de aanvragen waar sales niets mee kan. Daarom sturen we de stappen die er wel toe doen terug: een gekwalificeerde Lead, een Opportunity, een gewonnen deal.

Google Ads koppelt rechtstreeks met Salesforce via Data Manager, op de objecten Lead, Opportunity en Order. Dat werkt op de gclid, en voor conversies voor leads ook op het e-mailadres of telefoonnummer. De oude Salesforce-integratie in Google Ads wordt sinds 31 mei 2025 niet meer ondersteund. Hoe de meting aan de kant van Google Ads werkt, lees je in ons stuk over offline conversies in Google Ads.

Let op de tijd: Google Ads telt een klikconversie alleen mee als hij binnen 90 dagen na de klik wordt geïmporteerd. Bij een lange verkoopcyclus kies je daarom een eerdere stap, zoals een gekwalificeerde Lead, als conversie om op te sturen.

Een org mag per 24 uur een vast aantal API-aanroepen doen. In Enterprise Edition is dat 100.000 plus 1.000 per Salesforce-licentie, dus met 15 licenties 115.000. Dat geldt voor alles wat met je org praat, ook andere koppelingen. Voor een formulier is dat ruim; elke aanroep geeft in de header Sforce-Limit-Info terug hoeveel er nog over is.

Bij het aanmaken van een Lead via de REST API past Salesforce de actieve toewijzingsregels toe, tenzij je dat in de aanroep anders aangeeft. Dat is meestal wat je wilt: de Lead komt bij de juiste verkoper zonder dat iemand hem handmatig verdeelt.

Validatieregels gelden ook voor de API. Een verplicht veld in Salesforce dat op je formulier ontbreekt, laat de aanroep mislukken. Wij lopen die regels vooraf met je Salesforce-beheerder door en vangen fouten aan de serverkant op, zodat geen aanvraag verloren gaat.

Op WordPress blijft het formulier in de plugin die je al gebruikt, zoals Gravity Forms. Een kleine uitbreiding op de server stuurt de inzending door naar de Salesforce API, met de bron, de UTM-waarden en de gclid erbij. Een kant-en-klare Salesforce-plugin kan ook, maar dan bepaalt de plugin welke velden meegaan.

Op een maatwerksite in Next.js is het een eigen serverroute die hetzelfde doet. Dat is de route voor meerstapsformulieren, offertetools of portalen waarin meer gebeurt dan één Lead aanmaken.

In beide gevallen staat de token op de server en niet in de browser. Het meten van de bron, de koppeling met Salesforce en de terugkoppeling naar Google Ads vallen bij ons onder Data & Tracking.