Naar de inhoud
Rex, je AI-assistent: het routinewerk geregeld. De ideeën van jou 👉 Maak kennis met Rex

Apsis One koppelen

Maak een API-sleutel in Apsis One, koppel die, en stuur nieuwe aanmeldingen met hun attributen en aanmeldingen naar een sectie, stap voor stap.

Met de integratie voor Apsis One wordt iedereen die zich aanmeldt als profiel in Apsis One aangemaakt of bijgewerkt, in de sectie die jij kiest, en kan die worden aangemeld voor een van je abonnementen (subscriptions) in Apsis One.

Wat je nodig hebt

  • Een Apsis One-account en een gebruiker die API-sleutels kan beheren (meestal een beheerder).
  • Weten of je Apsis One-account in de regio Europa of Azië staat. De meeste accounts staan in Europa.

Stap 1: Een API-sleutel maken in Apsis One

  1. Open in Apsis One Account settings en ga naar API keys (onder integraties).
  2. Klik om een nieuwe API-sleutel te maken. Geef die een naam die je herkent, bijvoorbeeld "Scratcher".
  3. Geef de sleutel toegang tot de sectie of secties waar Scratcher profielen naartoe moet sturen, met de rechten hieronder.
  4. Sla op en kopieer de Client ID en het Client secret. Het secret wordt maar één keer getoond.

Apsis heeft hiervoor een eigen stap-voor-staphandleiding. Die staat gelinkt in de Installatiehandleiding in het installatievenster in Scratcher ("Volg deze handleiding om de integratie te installeren").

Rechten die de sleutel nodig heeft

Scratcher gebruikt de sleutel om:

  • je secties te lezen, met de attributen, abonnementen (toestemmingsonderwerpen) en events daarin, zodat je ze in de campagne kunt kiezen;
  • profielen aan te maken en hun attributen bij te werken;
  • toestemmingen (opt-ins) aan profielen toe te voegen;
  • events aan profielen toe te voegen.

De sleutel heeft dus leestoegang tot secties nodig en schrijftoegang tot profielen, toestemmingen en events in de secties die je gebruikt. Zonder schrijftoegang mislukken leveringen met een eigen foutmelding van Apsis One.

Stap 2: Apsis One koppelen aan Scratcher

  1. Ga in Scratcher naar Instellingen > Integraties en klik op Apsis One.
  2. Kies de API-regio: Europa of Azië.
  3. Plak de Client-ID en het Client secret.
  4. Klik op Integratie installeren. Scratcher logt in bij Apsis One om de gegevens te controleren.

Stap 3: Aanzetten in een campagne

  1. Open in de editor Koppelen > Integraties > Apsis One en klik op Activeren.
  2. Heb je meer dan één Apsis One-account gekoppeld, kies het dan onder Account selecteren.
  3. Kies onder Apsis-sectie de sectie (Selecteer een sectie).
  4. Klik onder Veldkoppelingen voor elk veld op Veldkoppeling toevoegen en koppel het Scratcher-veld aan het attribuut in Apsis One bij Doelveld. De lijst toont de attributen van de gekozen sectie, ook je eigen attributen.
  5. Kies onder Aanmeldingen (toestemmingen) het abonnement waarvoor mensen moeten worden aangemeld, of Geen. "Kies een abonnement waarvoor de deelnemer moet worden aangemeld."
  6. Kies onder Filteren op toestemmingen (optioneel) je toestemmingsvakje voor marketing, zodat alleen mensen die het hebben aangevinkt worden verstuurd.
  7. Klik op Opslaan en daarna op Testen om een testprofiel te versturen.

Velden koppelen

  • Het e-mailadres wordt altijd verstuurd en wordt gebruikt om het profiel te herkennen. Je hoeft het niet te koppelen.
  • Gebruik voor telefoonnummers de instelling Format om het nummer te versturen zoals je attribuut het verwacht.
  • Ja/nee-attributen krijgen true of false, dus koppel het veld Geaccepteerd van een toestemming aan een ja/nee-attribuut.

Toestemming

Kies je een abonnement, dan wordt elke persoon daarvoor aangemeld met de reden "Subscribed via" en de naam van de campagne, en de bron "Scratcher". Is de persoon al aangemeld, dan verandert er niets. Gebruik Filteren op toestemmingen zodat alleen mensen die je toestemmingsvakje voor marketing hebben aangevinkt worden aangemeld.

Heeft je sectie het event voor toestemmingsformulieren van Apsis One, dan registreert Scratcher de aanmelding ook als event op het profiel, met het adres van de campagne.

Wat wordt er verstuurd en wanneer

Nieuwe aanmeldingen worden binnen een minuut of twee verstuurd. Als je de integratie activeert, worden ook de bestaande leads van de campagne verstuurd. Doet iemand opnieuw mee, dan wordt het profiel bijgewerkt. Controleer elke levering onder Instellingen > Integraties > Leveringsstatus; daar zie je ook of het profiel nieuw was of al bestond. Zie De leveringsstatus controleren en leads opnieuw verzenden.

Problemen oplossen

  • "Sommige of alle velden zijn ongeldig..." bij het installeren: controleer de regio en kopieer de client-ID en het secret opnieuw.
  • Leveringen mislukken met een toegangsfout van Apsis One: de sleutel heeft geen toegang tot de sectie of mist schrijfrechten. Pas de sleutel aan in Apsis One.
  • Aanmeldingen (toestemmingen) is leeg: de sectie heeft nog geen abonnementen. Maak er een aan in Apsis One en open de integratie opnieuw.
Hulp nodig?

Nog steeds hulp nodig?

Echte mensen staan klaar om je te helpen. Gebruik je Scratcher al? Dan is de chat in het platform de snelste weg.

  • Chat met ons

    Log in en klik op de chatknop rechtsonder. Rex antwoordt meteen, en ons team is maar één klik verwijderd.

  • Plan een gesprek

    Een gratis videogesprek van 30 minuten met ons team: een rondleiding, campagne-ideeën of hulp bij je opzet.

  • Mail ons

    Schrijf naar contact@scratcher.io en we nemen contact met je op.