Configurare Klaviyo o Mailchimp

Wavize sincronizza i contatti a un pubblico specifico

Klaviyo e Mailchimp hanno pagine di configurazione separate. Ogni integrazione richiede una chiave API, un ID lista/pubblico, una modalità di sincronizzazione e uno stato attivo. In caso di modifica, lasciare il campo chiave vuoto mantiene segreto quello già registrato.

Solo profilo crea o aggiorna il profilo senza richiedere il consenso marketing. Il double opt-in avvia il processo di conferma del provider: il contatto diventa iscritto solo dopo l'azione attesa.

Sicurezza comune
Crea una chiave dedicata Wavize, copiala una sola volta nel modulo cifrato, non inviarla via email o in screenshot, e revocala se esposta.

Configurare Klaviyo con chiave privata

Wavize usa gli endpoint server: la chiave pubblica di sei caratteri, chiamata Site ID, non è adeguata.

1. Crea la chiave

   In Klaviyo: Settings > API keys > Private API Keys > Create Private API Key. Serve ruolo Owner, Admin o Manager. Nominala Wavize e copia il valore che inizia per pk_ al momento della creazione.

2. Seleziona gli ambiti

   La verifica legge accounts e liste; la sincronizzazione crea/aggiorna profili e, se in double opt-in, le iscrizioni. Concedi almeno letture accounts/lists e scritture profiles/subscriptions corrispondenti agli endpoint.

3. Trova l'ID della lista

   Apri Audience > Lists & Segments poi la lista target. Copia l’ID lista dai suoi parametri o dall’URL, non dal nome visualizzato. Wavize lo valida con /lists/{id}.

Configurare Mailchimp con chiave e Audience ID

La chiave Mailchimp Marketing API contiene generalmente il data center dopo un trattino, per esempio -us21.

1. Crea la chiave

   In Mailchimp: icona Profilo > Profile > Extras > API keys > Create A Key. Nominala Wavize, genera e copia subito: Mailchimp mostra dopo solo il nome e i primi caratteri.

2. Mantieni il suffisso datacenter

   Wavize estrae il suffisso dopo l’ultimo trattino per chiamare l’host API corretto. Una chiave troncata senza -usXX non può essere indirizzata correttamente.

3. Trova Audience ID

   In Audience > All contacts > Settings > Audience name and defaults, copia Audience ID. Non è il nome pubblico né un ID campagna.

Scegli solo profilo o double opt-in

La modalità deve corrispondere alla tua base legale e al testo mostrato nel widget.

• Solo profilo

  Klaviyo riceve un profilo; Mailchimp usa lo stato transactional. Il contatto non è presentato come iscritto marketing e può essere usato per usi autorizzati non promozionali.

• Double opt-in

  Klaviyo avvia un task di iscrizione al profilo; Mailchimp pone il membro in pending. L'indirizzo deve essere confermato secondo il provider prima di essere attivo per marketing.

• Campi sincronizzati

  Email valida obbligatoria, telefono E.164 se esistente, nome, cognome, organizzazione, localizzazione e proprietà Wavize utili. I campi Mailchimp FNAME/LNAME devono esistere o essere compatibili nel pubblico.

Verifica e testa un contatto reale di prova

Wavize testa prima l’account e il pubblico prima di attivare la sincronizzazione.

1. Verifica Klaviyo

   Il server chiama /accounts poi /lists/{id}. Un 403 indica spesso un ambito mancante; un 404, un ID lista di account errato.

2. Verifica Mailchimp

   Il server chiama /ping poi /lists/{id}. Un errore data center deriva spesso dal suffisso chiave; un pubblico non trovato, da un ID errato.

3. Contatto di test

   Invia un indirizzo del team dal widget, verifica la sua creazione Wavize e poi l’arrivo al provider. In double opt-in, apri e conferma il messaggio prima di completare.

Rotazione e incidente

Una nuova chiave non sostituisce automaticamente la vecchia in Wavize.

• Crea — Nuova chiave dedicata con stesse autorizzazioni minime.
• Aggiorna e testa — Inserisci il nuovo valore, mantieni pubblico e modalità, poi verifica.
• Revoca — Cancella la chiave vecchia dal provider solo dopo test riuscito.