API gebruikers en koppelingen
Laatst aangepast: 20-08-2024Via een API-key kun je (geautomatiseerd) informatie ophalen over het platform. Er zijn meerdere partijen die koppelingen hebben gelegd met systemen als bijvoorbeeld Salesforce, Collectekracht, Microsoft Dynamics.
Inhoud artikel
API-key
Je kunt kosteloos zelf een API-key genereren en gebruiken. Met een API-key kun je API-calls doen en informatie ophalen uit de database die bij het platform hoort. Een API-key is gekoppeld aan een site en daarmee kun je dus alleen informatie over die site ophalen.
Limiet
Er zit standaard een limiet op van 100 requests per minuut en 500 requests per uur. Dat is ook voldoende om de gegevens mee op te halen. Als je dit aantal wilt verhogen kun je contact opnemen met support@kentaa.nl.
Gebruik API-key
In ons developer portal kun je alle technische informatie vinden over het gebruik van de API-key. Zo zie je precies welke informatie je kunt ophalen. Zo zie je daar de Kentaa API, de Digicollect API en de technische informatie over Kentaa Connect.
API-key genereren
Via Integraties > API gebruikers kom je op de overzichtspagina met API gebruikers. Hier kun je als volgt een nieuwe key genereren:
Klik op Toevoegen en voeg daar de naam van de gebruiker in. Je kunt vervolgens kiezen of de gebruiker alleen informatie mag lezen, of ook mag wijzigen (via schrijfrechten). In dit menu kun je de gebruiker op een later moment ook weer deactiveren.
Als je op opslaan klikt is de API-gebruiker aangemaakt. Klik op het i'tje om de key te zien
Je ziet daar ook informatie over de bekende ip-adressen waar deze key door is gebruikt en wat voor calls er gedaan zijn.
API-key delen
Met een API-key krijg je in principe toegang tot alle data die op de site te vinden is. Let er daarom op dat je een key op een veilige wijze deelt. Als een integrator deze bijvoorbeeld nodig heeft voor het leggen van de koppeling adviseren we je deze via een met wachtwoord beveiligd bestand te sturen en het wachtwoord bijvoorbeeld per sms te delen.
Koppeling met CRM
Je kunt op verschillende manieren data uit het Kentaa platform in je eigen CRM krijgen. Wij bieden hierin een vaste vorm aan waarop je de data uit het platform kunt halen en dan dien je deze zelf te verwerken en in jullie CRM te krijgen. Vaak is er nog een omzetting nodig om ervoor te zorgen dat de data omgezet wordt naar het formaat van data in het CRM en dient deze goed gekoppeld te worden. Om dat proces in te richten wordt daarom ook vaak gebruik gemaakt van een integrator.
Op basis van downloads
Vanuit het Kentaa dashboard kun je downloads maken, bijvoorbeeld van de acties, teams en donaties. Er zijn klanten van ons die op basis van deze downloads periodiek een import in een CRM doen. Vaak moet er dan nog een bewerking plaatsvinden om de data geschikt te maken voor import, of is de import afgestemd op het Excel-bestand dat je kunt genereren vanuit Kentaa. Wijzigingen in de kolommen kondigen wij doorgaans aan, om ervoor te zorgen dat dit het proces van klanten niet verstoort.
Automatische koppeling (niet realtime)
Met behulp van de api-key kun je periodiek de data ophalen uit het Kentaa platform. Als je bijvoorbeeld een keer per uur of per dag de data ophaalt en die verwerkt in het CRM. Het maken van zo'n koppeling vereist wel technische kennis en doorgaans heb je hier een integrator voor nodig.
Koppeling via Kentaa Connect (realtime)
Je kunt ook een realtime koppeling realiseren via Kentaa Connect. Dit werkt op basis van webhooks. We krijgen een endpoint door waar we een bericht naar moeten sturen bij een bepaalde gebeurtenis en op basis daarvan kun je met de api-key alle bijbehorende gegevens ophalen en daarna zelf verwerken. We kunnen eventueel instellen bij welke gebeurtenissen er zo'n bericht gestuurd wordt. Het maken van zo'n koppeling vereist wel technische kennis en doorgaans heb je hier een integrator voor nodig. Daarnaast komen er bij het installeren van de koppeling aan onze kant ook kosten kijken. Als je hier meer over wilt weten kun je contact opnemen met je accountmanager.
Salesforce koppeling (realtime via Kentaa objecten)
Je kunt een koppeling met Salesforce leggen op basis van Kentaa Connect. We hebben echter met Salesforce ook een standaard koppeling gelegd. Het verschil met de koppeling via Kentaa Connect is dat we in Salesforce alle informatie in kant en klare Kentaa objecten (een soort pakketten met alle data erin) direct in Salesforce zetten. Het hoeft dan door jullie opgehaald en in Salesforce gezet te worden. Wel heb je technische kennis nodig om ervoor te zorgen dat de data vervolgens verwerkt wordt in Salesforce. Zo moet je kijken welke data je precies wilt hebben en kan het zijn dat je de data nog moet omzetten naar een ander formaat zodat deze matcht met jullie data. Om dit te automatiseren maken klanten van ons vaak gebruik van een integrator. De technische informatie kun je op deze pagina vinden onder het kopje Salesforce. Bij het installeren van de koppeling aan onze kant ook kosten kijken. Als je hier meer over wilt weten kun je contact opnemen met je accountmanager.
Bekende integrators
CM
CM biedt koppelingen aan met het hun CDP (Customer Data Platform) waar alle informatie in komt. Hiervandaan kun je mails, maar met name mobiele journeys inrichten tijdens bijvoorbeeld events. Ze kunnen ook koppelen met Digicollect voor tijdens een collecte. Meer informatie.
STB Eudonet
STB Eudonet heeft een koppeling met haar CRM gebouwd voor zowel Kentaa als Digicollect. Realtime wordt een donatie of actie direct ook zichtbaar in het CRM van Eudonet. Meer informatie.
Ifunds (Engage)
Via Ifunds kan Kentaa gekoppeld worden met Engage 365. Alle actievoerders, donateurs en donaties en nieuwsbriefinschrijvingen die worden geworven landen automatisch in Engage 365. Meer informatie.
Cisis (Converse/Collectekracht)
Cisis kan een Kentaa platform koppelen aan Converse en Digicollect platforms koppelen met Collectekracht. Meer informatie.
Xapti
Xapti biedt een online CRM oplossing aan waarin alles rondom het geefproces vastgelegd kan worden. De data van Kentaa kan hieraan gekoppeld worden. Meer informatie.
Civicoop (automatische koppeling, niet realtime)
Civicoop heeft de koppeling met CiviCRM gelegd. CiviCRM is een open source CRM gericht op non-profits en CiviCooP is al een flink aantal jaren actief in de Nederlandstalige CiviCRM wereld. Daarbij zitten ze vooral veel in Vlaanderen.
De extensie die is ontwikkeld is open source en is dus te gebruiken door meer organisaties die met CiviCRM werken en data uit Kentaa op zouden willen halen. De existentie is hier te vinden.
Salesforce koppelingen (via onze Salesforce koppeling)
Xebia (voormalig Gcompany)
Xebia heeft als integrator al veel klanten geholpen met het leggen van Salesforcekoppelingen en zorgt ervoor dat data vanuit Kentaa verwerkt wordt in jullie eigen Salesforce-omgeving. Meer informatie.
Cobra
Cobra werkt ook met de standaard Salesforce koppeling en helpt de klantprocessen te stroomlijnen met Salesforce. Meer informatie.
Bluedesk
Bluedesk integreert via de Salesforce koppeling de data van het Kentaa platform in Salesforce. Meer informatie
Outbirds (voorheen Bridgin.it)
Outbirds zorgt voor een op maat gemaakte koppeling tussen het Kentaa platform en Salesforce. Meer informatie.
Voorbeelden klanten
De api kan ook op andere manieren gebruikt worden, bijvoorbeeld tijdens events. Hier enkele voorbeelden:
Maarten van der Weijden Foundation - streaming
De Maarten van der Weijden Foundation heeft zelf via de api een link met hun stream gemaakt. Hierbij haalden ze periodiek recente donaties op en toonden ze die op de stream:
Ze hebben hiervoor ook een library aangemaakt, waar andere klanten (met technische kennis) ook gebruik van kunnen maken. Ze maakten geen gebruik van een Kentaa Connect koppeling, maar hielden rekening met eventuele limieten tijdens het ophalen van data.
Dutch gaming marathon - streaming
De Dutch Gaming Marathon heeft in 2020 gebruik gemaakt van Kentaa Connect om realtime donaties en bijbehorende berichten te tonen op de stream. Je kunt in dit artikel hier meer over lezen.
KNRM - Veilingsite
Kikz heeft een koppeling met de KNRM gerealiseerd via de api. Ze hebben een speciale veilingsite waar actiestarters kunnen inloggen met hun Kentaa-account (dit wordt via de api gecheckt of de gegevens kloppen) en hun eigen items kunnen veilen. Na het veilen wordt het bedrag via een handmatige donatie op de juiste plek toegevoegd in het Kentaa platform.
Erasmus MC Foundation - koppeling met Eroutes
Na het starten van een actie voor de Tocht tegen Kanker kregen actiestarters een uitnodiging vanuit eRoutes. Op basis van de eigen gekozen afstand en je GPS locatie stelt de app routes voor om te lopen.