Hoe maak ik een ActiveCampaign API-interface (met voorbeelden)?

ActiveCampaign-koppelingen

Een API-koppeling met ActiveCampaign maakt een snelle en efficiënte verwerking mogelijk van gegevens uit andere systemen of Excel-bestanden met het CRM-pakket. Een ActiveCampaign API-koppeling bespaart veel tijd en voorkomt fouten bij het uitvoeren van herhalende acties.

ActiveCampaign heeft meer dan 60 API’s, die allemaal toegankelijk zijn via Invantive SQL. Met Invantive SQL blijft de techniek onder de motorkap en kun je je richten op de functionaliteit dankzij SQL-statements die in real-time worden omgezet in lees- en schrijfacties op ActiveCampaign en meer dan 70 andere (cloud)platformen. Technische kennis is niet vereist. Wel is het nodig om kennis te hebben van de betrokken bedrijfsprocessen en te weten wat je wilt bereiken.

Excel-bestanden worden ook vaak gebruikt als bron voor een ActiveCampaign API-koppeling. De meeste gebruikers kunnen een Excel-blad veel sneller voorbereiden dan bijvoorbeeld contactpersonen of hun events één voor één handmatig in te voeren met telkens vergelijkbare gegevens. Zowel interactief via de Excel-invoegtoepassing Invantive Control for Excel met ActiveCampaign als massaal via Invantive Data Hub of Invantive Cloud kunnen Excel-bestanden worden ingelezen.

Hoe maak ik een ActiveCampaign API-koppeling?

Bij het maken van een API-koppeling of meerdere API-koppelingen tussen verschillende systemen waarbij ActiveCampaign ook wordt gekoppeld, vormt ActiveCampaign één kant van de API-koppeling. Voor de andere kant van de API-verbinding kun je kiezen uit meer dan 70 platformen, zoals diverse Visma-producten, maar ook Chargebee, Exact Online, Teamleader, Twinfield of AFAS. Ook voor al deze platformen geldt dat de API-koppeling elke API kan benaderen: elke API is vooraf gedefinieerd en getest, en direct bruikbaar.

Een doorzoekbaar overzicht van de beschikbare ActiveCampaign-tabellen op basis van de ActiveCampaign API-documentatie is te vinden op:

De meest gebruikte tabellen voor een ActiveCampaign-koppeling staan vermeld op Meest populaire ActiveCampaign tabellen voor 2022 (Nederlands).

Complete voorbeelden van ActiveCampaign API-koppelingen

Voor veelvoorkomende combinaties met een ActiveCampaign-koppeling zijn al scripts voor API-koppelingen beschikbaar. Twijfel je of een ActiveCampaign API-koppeling al is uitgewerkt, dan is het advies om hieronder een reactie achter te laten.

Enkele populaire, concrete voorbeelden van koppelingen met ActiveCampaign met kant-en-klare statements zijn:

Handmatig of volledig automatisch

Het verwerken van gegevens met een ActiveCampaign API-koppeling kan op verschillende manieren: zowel handmatig als volledig automatisch is mogelijk. Over het algemeen is het verstandiger om te beginnen met een handmatige ActiveCampaign-koppeling als de processen en/of gegevens nog niet eerder automatisch zijn verwerkt. Als er weinig problemen optreden, kan men ActiveCampaign volledig automatisch koppelen.

Het is echter wel wenselijk om regelmatig de status van een volledig automatische koppeling te controleren. Dit kan via e-mails vanuit de koppelingen of door het verwerkingsrapport van de software te bekijken.

Gegevens ophalen uit ActiveCampaign

Het ophalen van gegevens uit ActiveCampaign werkt direct na het inloggen bij ActiveCampaign met gebruikersnaam, wachtwoord en verificatiecode, bijvoorbeeld met:

select *
from   Contacts

Deze aanpak is hetzelfde voor alle producten. Deze aanpak met select is naast voor een ActiveCampaign-koppeling ook hetzelfde voor de andere, verschillende systemen.

Het uitwisselen van gegevens met de koppeling tussen ActiveCampaign en het andere platform kan met de statements insert, update en delete, maar synchroniseren is nog handiger met synchronize. Een voorbeeld van synchronisatie met synchronize is te lezen op Synchronize Exact Online with Visma.net Financials. Aan het einde van het synchronize-statement zijn twee tabellen qua inhoud gesynchroniseerd. Het synchronize-statement zelf bepaalt snel welke wijzigingen nodig zijn en kan deze efficiënt verwerken.

API-prestaties

De API van een cloudtoepassing is trager dan het uitwisselen van gegevens met een lokaal apparaat. Voor ActiveCampaign is het verstandig om uit te gaan van 250 ms per wijziging. Vaak is snelheidswinst te behalen door updates ook als insert te behandelen. ActiveCampaign zet dit intern automatisch om.

Integratie van Power BI met ActiveCampaign

Voor Power BI is er een vooraf gedefinieerde koppeling waarmee alle 66 beschikbare tabellen kunnen worden geïmporteerd in Power BI Desktop, Power BI Service en Power Query voor Excel. Deze ActiveCampaign Power BI-koppeling is te vinden op:

Een stapsgewijze handleiding met video’s voor het koppelen van ActiveCampaign met Power BI is te vinden op:

Azure Data Factory integreren met ActiveCampaign

Voor Azure Data Factory is er een vooraf gedefinieerde koppeling voor het laden van alle 66 ActiveCampaign-tabellen in Azure Data Factory. Deze ActiveCampaign Azure Data Factory-koppeling is te vinden op:

Een stapsgewijze handleiding voor het koppelen van ActiveCampaign met Azure Data Factory is te vinden op:

ActiveCampaign API-status

Een koppeling met ActiveCampaign vereist een stabiele internetverbinding, maar ook de ActiveCampaign API’s kunnen last hebben van storingen, variërend van traag functioneren tot volledig onbereikbaar zijn. De status van de ActiveCampaign API’s is te vinden op:

De ActiveCampaign API-status kan ook worden geraadpleegd via de Invantive Status-pagina.

Storingen door ActiveCampaign API-wijzigingen voorkomen

De API ondergaat voortdurend wijzigingen. Dit leidt vaak tot onverwachte API-storingen. Soms wordt de oorzaak van een API-storing automatisch opgelost na een paar dagen, omdat iemand anders er al over heeft geklaagd. Maar soms is het nodig om zelf contact op te nemen met ActiveCampaign API Support. Bij gebruik van Invantive SQL zal dit normaal gesproken zelden nodig zijn, omdat voor de meest voorkomende problemen al oplossingen zijn geïmplementeerd onder de motorkap die je van Invantive krijgt.

Beveiliging, sleutels en rechten

De ActiveCampaign API heeft een eenvoudig beveiligingsmodel; de gebruikte sleutel geldt systeembreed en is te vinden in het scherm via het pad /app/settings/developer.

De sleutel voor het toevoegen van events is eveneens hetzelfde voor alle gebruikers en is te vinden via het pad /app/settings/tracking.

Hulp nodig?

Heb je hulp nodig? Laat dan een vraag achter op de site https://forums.invantive.com of neem telefonisch of per e-mail contact op met Invantive. Invantive kan de ActiveCampaign-koppeling ook voor je configureren op basis van de al beschikbare drivers.