Con l'integrazione Agillic, chiunque si iscriva viene creato o aggiornato come destinatario (recipient) in Agillic. Qui Agillic non usa liste: i destinatari vengono aggiunti ai tuoi dati in Agillic, e i gruppi target li crei in Agillic.
Cosa ti serve
- Un account Agillic sulla piattaforma europea di Agillic e un utente che possa creare chiavi API (di solito un amministratore).
Passaggio 1: crea una chiave API in Agillic
- In Agillic, apri Settings e cerca le chiavi API (API credentials).
- Crea una nuova chiave e dalle un nome che riconosci, per esempio "Scratcher".
- Copia la Developer key (chiamata anche API key) e il Secret. Il secret viene mostrato una sola volta.
I permessi di cui ha bisogno la chiave
Scratcher usa la chiave per leggere i tuoi campi person data, trovare i destinatari per email e creare e aggiornare i destinatari. Se Agillic ti permette di limitare la chiave, le servono accesso in lettura e scrittura ai destinatari e accesso in lettura ai person data. Non serve nessun altro accesso.
Passaggio 2: collega Agillic a Scratcher
- In Scratcher, vai su Impostazioni > Integrazioni e clicca su Agillic.
- Incolla la Developer key e il Secret.
- Clicca su Installa integrazione. Scratcher accede ad Agillic per controllarli.
Passaggio 3: attivalo in una campagna
- Nell'editor, vai su Collega > Integrazioni > Agillic e clicca su Attiva.
- Se hai collegato più di un account, sceglilo in Seleziona account.
- In Mappature dei campi, abbina ogni Campo Scratcher a un campo person data di Agillic.
- In Campo email univoco, scegli il campo di Agillic che usi per l'email: "Scegli il campo di Agillic che usi per l’email (assicurati che sia univoco anche in Agillic)". Compaiono solo i campi di testo univoci. Se lo lasci vuoto, Scratcher usa il campo EMAIL.
- In Filtra per consensi (facoltativo), scegli la tua casella di consenso al marketing, così vengono inviate solo le persone che hanno detto sì.
- Clicca su Salva e poi su Test.
Buono a sapersi: in Agillic non c'è una lista da scegliere, quindi Scratcher inizia a inviare appena clicchi su Attiva. Attivalo prima che la campagna vada online, oppure configuralo subito.
Mappatura dei campi
- L'indirizzo email viene sempre inviato al campo email univoco. Non devi mapparlo.
- L'elenco dei campi mostra i tuoi person data di Agillic, con i rispettivi tipi. Le date vengono inviate nel formato di Agillic, per esempio 31.12.2025.
- Se hai un campo person data per l'opt-in, mappaci sopra il campo Accettato di un consenso.
Cosa viene inviato e quando
Scratcher cerca il destinatario per email. Se non esiste, viene creato; altrimenti viene aggiornato. I nuovi iscritti vengono inviati entro un paio di minuti, e i lead già presenti vengono inviati quando attivi l'integrazione. In Impostazioni > Integrazioni > Stato della consegna vedi se ogni lead era nuovo o esisteva già in Agillic.
Risoluzione dei problemi
- "Agillic API request failed with status code ...": Agillic non ha accettato la richiesta. 401 o 403 significa che la chiave è stata eliminata o non ha accesso; collega una nuova chiave.
- Un messaggio di Agillic su un campo: un valore non è adatto al tipo del campo, oppure manca un campo obbligatorio. Controlla le mappature.