Wijzigingen terugkoppelen via de API
APIHoud je je contacten ook bij in een eigen systeem, zoals je webshop of CRM? Met terugkoppelingen houdt Inboxify bij welke contacten zijn toegevoegd, gewijzigd, verwijderd of afgemeld. Je eigen systeem vraagt die wijzigingen op via de API. Zo blijven beide systemen gelijk, ook als een contact zich bijvoorbeeld via een campagne afmeldt.
Terugkoppelingen aanzetten
- Klik rechtsboven op je initialen en kies Instellingen.
- Kies API.
- Zet onder Terugkoppelingen de schakelaar Wijzigingen terugkoppelen aan.
De schakelaar gaat meteen in. Daarna kies je:
- Wijzigingen bijhouden voor: Alle lijsten of één lijst.
- Imports uitsluiten: contacten die je importeert, worden dan niet als nieuw aangemaakt teruggekoppeld. Handig als je je contacten juist vanuit je eigen systeem importeert.
- API-wijzigingen uitsluiten: wijzigingen die je eigen systeem via de API doet, worden dan niet teruggekoppeld. Zo krijg je je eigen wijzigingen niet terug.
De wijzigingen opvragen
Per lijst zijn er vier verzoeken:
GET /contacts/{lijst}/created: toegevoegde contacten;GET /contacts/{lijst}/updated: gewijzigde contacten;GET /contacts/{lijst}/deleted: verwijderde contacten;GET /contacts/{lijst}/unsubscribed: afgemelde contacten.
Je krijgt steeds de wijzigingen sinds de vorige keer. Een wijziging die je hebt opgevraagd, krijg je daarna niet nog een keer. Hoe je inlogt en wat je precies terugkrijgt, lees je in de API-documentatie bij REST API voor contacten.
Let op: Wijzigingen die je niet opvraagt, worden na een week automatisch verwijderd. Vraag ze dus minstens één keer per week op, bijvoorbeeld met een taak die elke dag draait.
Je hebt hiervoor een API-gebruiker nodig. Lees Hoe maak ik een API-gebruiker aan?