Klaviyo of Mailchimp instellen

Wavize synchroniseert contacten naar een specifieke doelgroep

Klaviyo en Mailchimp hebben aparte configuratiepagina's. Elke integratie vraagt om een API-sleutel, een lijst-/doelgroepen-ID, een synchronisatiemodus en een actieve status. Als u iets wijzigt, laat het sleutelfield leeg om het reeds opgeslagen geheim te behouden.

Alleen profiel maakt een profiel aan of werkt het bij zonder marketingtoestemming na te streven. Double opt-in start het bevestigingsproces bij de provider: het contact wordt abonnee nadat de verwachte actie is uitgevoerd.

Algemene veiligheid
Maak een speciale Wavize-sleutel, kopieer die eenmalig in het versleutelde formulier, verstuur nooit per e-mail of screenshot, en herroep zodra de sleutel wordt blootgesteld.

Klaviyo configureren met een private key

Wavize gebruikt server endpoints: de publieke sleutel van zes karakters, genaamd Site ID, is niet geschikt.

1. Maak de sleutel aan

   In Klaviyo: Settings > API keys > Private API Keys > Create Private API Key. Een rol als Owner, Admin of Manager is vereist. Noem de sleutel Wavize en kopieer de waarde die met pk_ begint bij aanmaak.

2. Scopes kiezen

   De controle leest accounts en de lijst; synchronisatie maakt profielen aan/bij en bij double opt-in ook abonnementen. Verleen minimaal leesrechten voor accounts/lijsten en schrijfrechten voor profielen/abonnementen volgens de endpoints.

3. Lijst-ID vinden

   Open Audience > Lists & Segments en dan de doelijst. Kopieer het ID van de lijst uit de instellingen of URL, niet de weergavenaam. Wavize valideert die met /lists/{id}.

Mailchimp configureren met sleutel en Audience ID

De Mailchimp Marketing API-sleutel bevat normaal het datacenter achter een streepje, bijvoorbeeld -us21.

1. Maak de sleutel aan

   In Mailchimp: profielicoon > Profile > Extras > API keys > Create A Key. Noem de sleutel Wavize, genereer en kopieer direct: Mailchimp toont daarna alleen naam en begintekens.

2. Datacenter suffix behouden

   Wavize haalt het suffix na de laatste streep op om de juiste API host aan te spreken. Een verkorte sleutel zonder -usXX kan niet goed gerouteerd worden.

3. Audience ID vinden

   In Audience > All contacts > Settings > Audience name and defaults, kopieer Audience ID. Dit is geen publieke naam of campagne-ID.

Kies alleen profiel of double opt-in

De modus moet overeenkomen met uw rechtsgrondslag en de tekst in de widget.

• Alleen profiel

  Klaviyo ontvangt een profiel; Mailchimp gebruikt de transactional status. Contact wordt niet als marketingabonnee aangeduid en kan voor toegestane niet-promotionele doeleinden gebruikt worden.

• Double opt-in

  Klaviyo start een profielabonnementstaken; Mailchimp zet lid in pending. Het adres moet bevestigen bij provider voor actieve marketingstatus.

• Gesynchroniseerde velden

  Geldig e-mailadres verplicht, telefoon E.164 indien aanwezig, naam, achternaam, organisatie, locatie en nuttige Wavize-eigenschappen. Mailchimp FNAME/LNAME velden moeten bestaan of compatibel zijn in de audience.

Controleer en test een echt testcontact

Wavize test eerst account en audience vóór synchronisatie activeren.

1. Klaviyo controle

   Server roept /accounts en /lists/{id} aan. Een 403 wijst vaak op een ontbrekende scope; een 404 op een lijst-ID van een verkeerd account.

2. Mailchimp controle

   Server roept /ping en /lists/{id} op. Een datacenter fout komt vaak door sleutel suffix; een audience niet gevonden door onjuiste ID.

3. Testcontact

   Dien een adres van het team in via de widget in, controleer aanmaak in Wavize en ontvangst bij de provider. Bij double opt-in open en bevestig bericht voordat u afrondt.

Rotatie en incident

Een nieuwe sleutel vervangt niet automatisch de oude in Wavize.

• Maak — Nieuwe sleutel met gelijke minimale permissies.
• Bijwerken en testen — Voer nieuwe waarde in, laat audience en modus gelijk, test daarna.
• Intrekken — Verwijder oude sleutel providerzijde pas na geslaagde test.