Laat een koppeling bouwen als hij over de grens van twee systemen gaat en het team er dagelijks op leunt. Doe hem zelf als het een standaardapp is die je in een uur instelt.
De bouw staat zelden in de weg. Wat later pijn doet is een koppeling zonder eigenaar, zonder melding bij een fout en zonder documentatie.
Eén woord op de offerte, drie soorten werk
Op een offerte staat "koppeling Pipedrive met boekhouding" of "integraties: 3". Achter dat ene woord kunnen drie verschillende soorten werk zitten, met een verschil in prijs en onderhoud dat je pas achteraf voelt. Het eerste soort is een app uit de Pipedrive Marketplace die je instelt. Het tweede is een scenario in een tussenlaag zoals Make. Het derde is maatwerk tegen de API.
Vraag per koppeling op welke van de drie de offerte rekent, hoeveel uur eenmalig en welke maandlasten erbij horen. De bedragen per soort staan op wat kosten koppelingen. Hier gaat het over wat je daarbovenop moet afspreken, want een goede prijs voor een koppeling zonder afspraken is een koopje dat later terugkomt.
Native, Make of maatwerk: hoe je kiest
De vuistregel die wij gebruiken: wat helemaal binnen Pipedrive blijft, doe je met de automatiseringen van Pipedrive zelf. Een taak bij een stagewissel, een eigenaar toewijzen, een herinnering voor opvolging. Wat over de grens van een tool heen gaat, zoals een gewonnen deal die een klant in je boekhouding aanmaakt, hoort in een koppeling. De fout die we vaak zien is Make gebruiken voor werk dat Pipedrive zelf kan, want dat is trager en duurder.
Een native app is de eerste keuze als hij bestaat en doet wat je nodig hebt. Controleer in de Marketplace de actuele stand, want aanbod en voorwaarden veranderen. Een tussenlaag is de keuze wanneer er meerdere stappen en voorwaarden in zitten. Maatwerk is voor wanneer systemen in twee richtingen moeten synchroniseren of de standaardroutes tekortschieten, en dat is vooral bij een ERP het geval. Wil je zien hoe die keuzes in een echt project uitpakten, lees dan het klantproject MM Montage.
Welk systeem is leidend per gegeven
Dit is de afspraak die het vaakst ontbreekt. Een adres staat in Pipedrive en in je boekhouding. Wijzigt een verkoper het in Pipedrive en de administratie in de boekhouding, dan wint er één van de twee, en als niemand heeft afgesproken welke, wint de laatste die schrijft. Bij MM Montage maakt een gewonnen deal de klant aan in het offertesysteem, en komen adres, contact en btw-gegevens vandaar weer terug in Pipedrive. Per soort gegeven is dus bekend waar het vandaan komt.
Leg per veld vast welk systeem leidend is en in welke richting het gegeven loopt. Een tabel met drie kolommen volstaat: veld, bron, richting. Een partner die dat niet vraagt, bouwt een koppeling die in de eerste weken werkt en daarna stilletjes data overschrijft.
Wat er gebeurt als een koppeling faalt
Koppelingen falen. Een API is een uur niet bereikbaar, een veld is in het ene systeem verplicht en in het andere leeg, een wachtwoord is verlopen. De vraag is niet of dat gebeurt, maar wie het hoort. Een koppeling zonder melding faalt stilletjes, en je merkt het pas wanneer een klant zegt dat zijn factuur nooit kwam.
Vraag drie dingen. Wie krijgt de melding en op welk kanaal? Probeert de koppeling het automatisch opnieuw, en hoe vaak? En kun je een gemiste gebeurtenis terugspelen zonder dat er dubbele records ontstaan? Dat laatste heet idempotent bouwen: een tweede keer uitvoeren geeft hetzelfde resultaat als de eerste. Voor scenario's waar je op leunt hoort daar een dagelijkse controle bij die opvangt wat toch gemist is. Bij MM Montage heeft elk scenario eigen foutafhandeling, nieuwe pogingen en een audit log.
Een uitval is een melding en geen incident.
Vraag een voorbeeld van een foutmelding en laat de bouwer laten zien hoe hij een gemiste gebeurtenis terugspeelt.
Dit is een koppeling zonder toezicht.
Je betaalt voor de bouw en krijgt het onderhoud er achteraf bij, als schade bij klanten.
Ontdubbelen: koppelsleutels en de sleutel die niet de naam is
Een koppeling die records aanmaakt zonder te controleren of ze al bestaan, maakt binnen een maand dubbelen. De oplossing is een vaste sleutel waarmee de systemen elkaar terugvinden: een offertenummer, een klantnummer, een KvK-nummer. Niet de bedrijfsnaam, want die schrijft iedereen anders.
Bij MM Montage kwamen de offerte- en klant-ID's uit het offertesysteem als veld in Pipedrive terug. Daardoor weet elk scenario of een deal al bestaat en wordt hij bijgewerkt in plaats van opnieuw aangemaakt. Vraag aan een bouwer welke sleutel hij gebruikt, en wat er gebeurt als die sleutel ontbreekt. Het antwoord verklaart veel over wat je later aan opschoonwerk kunt verwachten.
Wie beheert het scenario na oplevering en onder welk account
Een scenario in Make draait in een omgeving die aan iemand toebehoort. Staat die op jouw naam, dan heb je alles wat gebouwd is, ook als je van partner wisselt. Staat hij op de naam van de partner, dan hangt jouw verkoopproces aan de relatie met één bureau. Dat kan een bewuste keuze zijn, bijvoorbeeld voor beheer. Het moet dan op papier staan, met wat er gebeurt bij einde samenwerking. Zie eigendom en exitbepalingen voor de formuleringen.
Hetzelfde geldt voor de kosten van het platform zelf. Wie betaalt het abonnement, wie ziet het verbruik en wie krijgt de melding als het budget op raakt? Bij MM Montage hoort het bewaken van het verbruik bij de monitoring. Zoiets moet in jouw afspraken ook een naam hebben.
Documentatie en overdracht van de scenario's
Een scenario is leesbaar voor de maker en slecht leesbaar voor iedereen anders. Documentatie betekent per koppeling: wat doet hij, wat triggert hem, welke velden gaan in welke richting, welke sleutel wordt gebruikt en wat gebeurt er bij een fout. Eén pagina per koppeling is genoeg, als hij klopt. Wat daarbij hoort in een overdracht lees je in overdracht en documentatie, en wat je voor het beheer erna afspreekt in SLA en support afspreken.
Wat je doet als er geen API is
Niet elk systeem is te koppelen. Een oud pakket zonder API, of zonder gedocumenteerde route, laat zich niet betrouwbaar koppelen. Een bouwer die dat niet vooraf zegt, probeert iets met schermkopieën of geplande exports dat bij de eerste update stuk gaat. Wij bouwen geen koppeling op een systeem waar geen API op zit, en zeggen dat vooraf. Eerlijke alternatieven zijn een geplande export met een handmatige controle, of het andere systeem vervangen.
Dat laatste voelt als een grote stap voor een kleine koppeling, maar kan de goedkoopste route zijn. Een systeem dat je team al jaren met de hand bijwerkt omdat het niet te koppelen is, kost elke week uren die in geen enkele offerte staan.
Vragen die je aan elke bouwer stelt
Wie is eigenaar van het scenario en onder welk account staat het? Welk systeem is per veld leidend? Wie krijgt een melding bij een fout? Hoe voorkom je dubbele records? Waar staat de documentatie? Wat gebeurt er als een van de twee systemen zijn API wijzigt, en is dat onderdeel van een supportafspraak? Zie ook de supportclausule.
Je hoeft koppelingen niet bij ons te laten bouwen. Een standaardapp stel je zelf in, en voor een enkel scenario kan een freelancer of je eigen beheerder prima uit de voeten. Heb je meer dan één systeem dat met Pipedrive moet praten en leunt je team er dagelijks op, lees dan eerst voor operations met koppelingen en kom daarna via Bespreek je implementatie met de lijst van je systemen.