Salesforce API Koppeling op Maat | MG Software B.V.

Salesforce is wereldwijd het grootste CRM-platform en wordt door organisaties van elke omvang gebruikt om klantrelaties, sales pipelines en serviceprocessen te beheren. Het platform is uitzonderlijk flexibel: naast de standaardobjecten zoals Leads, Contacts, Accounts en Opportunities kunnen organisaties hun eigen custom objects definiëren met velden, relaties en automatiseringen die precies passen bij hun bedrijfsproces.

Vanuit integratieperspectief biedt Salesforce een rijke verzameling API's. De REST API is geschikt voor point-to-point operaties, de Bulk API voor grootschalige dataloads, de Streaming API voor realtime change data capture en de Composite API voor het bundelen van meerdere requests in een enkel verzoek. Daarnaast zijn er Platform Events en Change Data Capture die een event-driven architectuur mogelijk maken.

Voor bedrijven die naast Salesforce ook eigen software draaien, een klantportaal, een interne tool of een datawarehouse, is integratie vrijwel onvermijdelijk. Salesforce is zelden het enige systeem. Finance draait in een ander pakket, operations heeft eigen tooling en marketing gebruikt gespecialiseerde platforms. Zonder koppeling ontstaan eilanden van data die handmatig moeten worden samengebracht.

MG Software heeft ervaring met uiteenlopende Salesforce-edities en configuraties. We begrijpen hoe connected apps werken, hoe OAuth flows met JWT bearer tokens zijn opgezet, en welke governor limits van toepassing zijn bij verschillende API-patronen. Die kennis vertalen we naar integraties die performant en betrouwbaar zijn.

In veel organisaties is Salesforce de bron van waarheid voor klantinformatie, maar niet voor operationele processen. Het salesteam werkt in Salesforce, maar het productieteam heeft een eigen planning tool en finance boekt in een ERP-pakket. Wanneer deze systemen niet met elkaar praten, ontstaat er een situatie waarin elke afdeling een eigen versie van de waarheid bijhoudt.

Een concrete integratie verandert dat. Leads die binnenkomen via uw website worden direct aangemaakt in Salesforce, inclusief deduplicatie op basis van e-mail of bedrijfsnaam. Zodra een opportunity een bepaalde fase bereikt, wordt automatisch een order aangemaakt in uw backend. Wanneer een factuur wordt betaald, wordt de status in Salesforce bijgewerkt zodat sales ziet dat de deal daadwerkelijk is afgerond.

De impact op teamefficientie is aanzienlijk. Customer success managers hoeven niet langer te schakelen tussen drie applicaties om een klantbeeld op te bouwen. Managementrapportages worden betrouwbaarder omdat ze gebaseerd zijn op dezelfde onderliggende data. En voor audit en compliance is er een helder spoor van welke data wanneer is gesynchroniseerd.

Voor organisaties die Salesforce gebruiken als platform voor maatwerk, met custom objects en Apex triggers, is integratie nog belangrijker. Hoe complexer het Salesforce-datamodel, hoe groter de kans dat andere systemen verouderde of incomplete data bevatten wanneer er geen geautomatiseerde synchronisatie is.

De technische basis van een Salesforce integratie begint bij de connected app. Dit is het mechanisme waarmee uw externe applicatie zich identificeert bij Salesforce en toestemming vraagt voor API-toegang. We configureren connected apps met OAuth 2.0 en bij voorkeur de JWT bearer flow, omdat deze geen gebruikersinteractie vereist en geschikt is voor server-to-server communicatie. De private key wordt opgeslagen in een managed secret store, nooit in code of configuratiebestanden.

Voor de keuze van het juiste API-patroon analyseren we per use case het datavolume en de latency-eisen. Individuele recordoperaties verlopen via de REST API. Wanneer u duizenden records tegelijk moet synchroniseren, schakelen we over naar de Bulk API 2.0 die asynchrone verwerking biedt. Voor scenario's waarin uw applicatie direct moet reageren op wijzigingen in Salesforce, gebruiken we Platform Events of Change Data Capture via de Streaming API.

Een belangrijk aandachtspunt bij Salesforce zijn de governor limits. Elke organisatie heeft een dagelijks maximum aan API-calls, en individuele requests zijn gebonden aan limieten voor query-lengte, batchgrootte en verwerkingstijd. Wij ontwerpen integraties die deze limieten respecteren door slim te batchen, composite requests te gebruiken waar mogelijk, en caching toe te passen voor data die niet constant wijzigt.

SOQL, de query-taal van Salesforce, wordt ingezet voor selectieve data-opvraag. In plaats van hele tabellen te downloaden, halen we alleen gewijzigde records op via LastModifiedDate filters of SystemModstamp. Dit minimaliseert het dataverkeer en verlaagt het verbruik van API-calls aanzienlijk.

Foutafhandeling is ingebouwd op meerdere niveaus. Netwerkfouten leiden tot retries met exponential backoff. Functionele fouten, zoals een validatieregel die een record afwijst, worden gelogd met het foutbericht en de betreffende record-ID zodat ze gericht kunnen worden opgelost.

Salesforce bevat gevoelige klant- en commerciële data. De integratie moet daarom voldoen aan dezelfde beveiligingsnormen die gelden voor directe toegang tot het CRM. Field-level security in Salesforce bepaalt welke velden zichtbaar en bewerkbaar zijn per profiel. Onze integratie respecteert deze instellingen door alleen velden op te vragen en te schrijven waarvoor de integration user daadwerkelijk rechten heeft.

Sharing rules en record-level access worden eveneens in acht genomen. Wanneer uw Salesforce-organisatie private sharing model gebruikt, heeft de integration user alleen toegang tot records die expliciet zijn gedeeld. We adviseren over de juiste configuratie van de integration user om zowel veiligheid als functionaliteit te waarborgen.

Daarnaast versleutelen we alle credentials en tokens at rest en in transit. JWT private keys worden beheerd via een secret manager en worden nooit in broncode opgeslagen. Audit logs registreren elke API-interactie zodat bij een security review precies is na te gaan welke data wanneer en door welk systeem is benaderd.

De meest voorkomende uitdaging bij Salesforce integraties zijn de governor limits. Salesforce hanteert strikte limieten op het aantal API-calls per dag, het aantal records per bulkjob en de verwerkingstijd per request. Integraties die hier geen rekening mee houden, kunnen onverwachts tegen een muur lopen, precies op het moment dat het systeem het drukst heeft.

Een tweede uitdaging is de complexiteit van het Salesforce datamodel, vooral bij organisaties die veel custom objects en lookup relaties gebruiken. Het correct vertalen van een genest datamodel naar een extern systeem vereist zorgvuldige mapping en vaak ook denormalisatie, waarbij we gerelateerde objecten samenvoegen tot een plattere structuur die beter past bij uw doelsysteem.

Het verschil tussen sandbox en productie is een derde valkuil. Configuratiewijzigingen die in sandbox werken, gedragen zich soms anders in productie door differences in data volume, user permissions of active triggers. We mitigeren dit door deployment checklists en door altijd te testen met productie-representatieve data.

Salesforce brengt drie keer per jaar een major release uit die impact kan hebben op API-gedrag. Wij monitoren de Salesforce release previews en testen de integratie in een preview sandbox voordat de release naar productie wordt uitgerold. Op die manier vangen we breaking changes op voordat ze uw bedrijfsproces raken.

Daarnaast houden we dagelijks de API-consumptie in de gaten via monitoring dashboards. Wanneer het verbruik onverwacht stijgt of daalt, onderzoeken we de oorzaak. Dit voorkomt dat u pas aan het eind van de maand ontdekt dat de integratie al dagen niet draait.

De scope van een Salesforce integratie wordt bepaald door het aantal objecten, de richting van datastromen en de complexiteit van uw Salesforce configuratie. Een eerste koppeling met een enkel object in een richting is doorgaans compact en past binnen enkele sprints.

Voor organisaties met tientallen custom objects, complexe sharing rules of meerdere Salesforce-orgs adviseren we een gefaseerde aanpak. Elke fase levert een werkend resultaat op dat direct waarde biedt.

Een eerste scopebespreking geeft u inzicht in de verwachte investering. We werken met transparante sprintbudgetten en heldere deliverables per fase.