API & Webhooks
Pro voegt twee manieren toe om PrimoCRM te verbinden met de rest van je stack: API-sleutels voor programmatische toegang, en uitgaande webhooks voor het pushen van gebeurtenissen naar andere systemen.
API-sleutels
Section titled “API-sleutels”Met API-sleutels kunnen externe applicaties en scripts programmatisch PrimoCRM-gegevens lezen en schrijven.
- Ga naar Instellingen en vervolgens naar API en maak een sleutel aan.
- Bewaar de sleutel veilig. Behandel deze als een wachtwoord.
- Gebruik de sleutel om verzoeken vanuit je applicatie te verifiëren.
Typische toepassingen:
- Contacten synchroniseren vanuit een systeem dat geen directe integratie heeft.
- Contacten toevoegen of bijwerken vanuit een aangepast registratieproces.
- Gegevens ophalen in een intern dashboard.
Uitgaande webhooks
Section titled “Uitgaande webhooks”De automatiseringsactie Uitgaande webhook verzendt een HTTP POST naar een URL naar keuze wanneer de flow die stap bereikt. Gebruik deze om andere services in realtime te informeren.
- Voeg een stap voor Uitgaande webhook toe aan een automatisering.
- Stel de doel-URL in.
- Configureer de payload. Je kunt contactgegevens opnemen via slimme codes.
Een uitgewerkt voorbeeld
Section titled “Een uitgewerkt voorbeeld”- Trigger: WooCommerce-bestelling aangemaakt.
- Uitgaande webhook: POST naar je fulfillment-service met het e-mailadres van het contact en bestelgegevens.
- Tag toevoegen:
customer.
Op het moment dat er een bestelling wordt geplaatst, wordt je externe systeem op de hoogte gebracht en krijgt het contact een tag, zonder handmatige stappen.
Beveiligingsnotities
Section titled “Beveiligingsnotities”- Richt webhooks alleen op eindpunten die je beheert of vertrouwt. Een webhook kan contactgegevens naar de doel-URL verzenden.
- Geef de voorkeur aan HTTPS-bestemmingen zodat de payload tijdens transport wordt versleuteld.
- Valideer inkomende webhook-verzoeken aan de ontvangende kant.
Waar deze zich in de catalogus bevinden, staat vermeld onder Triggers en acties.