Brevo koppelen | Helpcentrum

Wat je nodig hebt

De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
Tweestapsverificatie (2FA) op je APIboard-account.
Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
Een Brevo-account waarin je een API-sleutel kunt genereren.
Geautoriseerde IP’s in Brevo uitgeschakeld (zie stap 4): APIboard haalt gegevens op vanaf wisselende adressen.

Verbinden

Ga in APIboard naar Koppelen > Koppelingen.
Zoek Brevo bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
Log in bij Brevo en ga naar Instellingen > SMTP & API, tabblad API-sleutels.
Klik op Nieuwe API-sleutel genereren en noem hem APIboard.
Brevo kent geen sleutel die alleen kan lezen. APIboard gebruikt de sleutel uitsluitend om gegevens op te halen.
Gebruik je Geautoriseerde IP’s (onder Beveiliging)? Zet die beperking uit.
Kopieer de sleutel meteen, want Brevo laat hem maar één keer zien, en plak hem in het veld API-sleutel in APIboard. Vul eventueel een Naam voor deze koppeling (optioneel) in.
Klik op Koppelen.
APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Brevo, met de dashboards die klaarstaan. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.

Account of administratie kiezen

Er is geen keuzescherm: één sleutel hoort bij één Brevo-account. De koppeling krijgt de bedrijfsnaam uit Brevo, tenzij je zelf een naam invult. Een ander Brevo-account is een aparte koppeling met een eigen sleutel.

Welke gegevens je krijgt

Onderwerp	Tabellen
Account	Account
Contacten	Lijsten, Contacten dagelijks
E-mailcampagnes	Emailcampagnes, Campagne links
Sms en transactionele mail	Smscampagnes, Transactioneel dagelijks

Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van Brevo.

Hoe vaak vernieuwd

Campagnes en sms worden in de eerste vulling vanaf de grens van je pakket opgehaald. Campagnes ouder dan 170 dagen beschouwt APIboard als bevroren; daarna haalt APIboard alleen het recente venster (170 plus 14 dagen) opnieuw op. Bij een upgrade van je pakket wordt weer alles opgehaald. Transactionele mail komt de eerste keer vanaf de grens van je pakket binnen, daarna dagelijks de laatste 30 dagen. Links worden incrementeel opgehaald op basis van het aantal kliks.

Het aantal contacten houdt APIboard vanaf vandaag dagelijks bij; Brevo bewaart zelf geen historie daarvan. Er is dus geen terugwerkende historie voor contacten.

De eerste vulling van gegevens met een datum (zoals facturen, uren of mutaties) begint op 1 januari van het jaar dat bij je pakket hoort: Proefperiode en Basis dit kalenderjaar, Team ook vorig jaar, Pro ook twee jaar terug. Stamgegevens (zoals relaties of rekeningen) worden altijd volledig opgehaald. Wat al is opgehaald, verwijdert APIboard niet als je pakket kleiner wordt.

Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.

Goed om te weten

Brevo kent geen sleutel die alleen kan lezen. Geef de sleutel een herkenbare naam, zodat je hem later in Brevo kunt terugvinden en intrekken.
Brevo heeft een laag quotum voor de meeste leesaanroepen. APIboard leest de quotum-gegevens van Brevo, stopt zodra de helft is verbruikt en wacht tot het quotum is hersteld.
Campagnetypes zijn Standaard of Automatisch.
Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan, de status gaat terug naar Actief en de volgende synchronisatie haalt alleen wijzigingen op. Het verbindscherm opent direct, zonder bevestigingsvraag. Plak een nieuwe API-sleutel van hetzelfde Brevo-account. Log je in met een ander account, dan weigert APIboard dat met de melding “Dit is een ander account dan de koppeling die je opnieuw verbindt. Log in met hetzelfde account.” Dan is het een nieuwe koppeling.
Je vindt Opnieuw verbinden (pijlicoon) in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
Een koppeling of account verwijderen (Koppeling verwijderen of het verwijderpictogram bij een account) wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.

Problemen oplossen

Vul je Brevo API-sleutel in. Het veld is leeg.
Deze Brevo API-sleutel werkt niet. Controleer of je de hele sleutel hebt gekopieerd en of hij nog actief is. Plak de sleutel opnieuw, of maak in Brevo een nieuwe aan.
Brevo blokkeert aanroepen van onbekende IP-adressen. Zet in Brevo onder Beveiliging, Geautoriseerde IP’s de IP-beperking uit. Doe dat en klik opnieuw op Koppelen.
Brevo is even druk. Probeer het over een paar minuten opnieuw. Wacht even en probeer het nog eens.
Brevo gaf een onverwacht antwoord. Probeer het later opnieuw. Probeer het later nog eens. Houdt het aan, neem dan contact op met support.
Dit Brevo-account is al gekoppeld. Dit account staat al in je organisatie.
Viewers kunnen geen koppelingen beheren. Je hebt de rol Viewer. Vraag een Admin van je organisatie om je de rol Member te geven, of om de koppeling te maken.
Dit account is al gekoppeld. Wat je probeert te koppelen, staat al in je organisatie. Zoek het op onder Koppelen > Koppelingen.
Je hebt je koppelingen-limiet bereikt voor je pakket. (of Je hebt je accounts-limiet bereikt voor je pakket.) Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling of extra account.
De pil Fout bij de koppeling. Een synchronisatie is mislukt of de toegang is verlopen of ingetrokken. APIboard probeert het bij een tijdelijke fout later zelf opnieuw; bij een verlopen toegang gebruik je Opnieuw verbinden.