Vai al contenuto
Rex, il tuo assistente IA: al lavoro di routine ci pensa lui. Le idee sono tue 👉 Scopri Rex

Collega Agillic

Crea una chiave API in Agillic, collegala con developer key e secret, e crea o aggiorna i destinatari con i campi che scegli.

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

  1. In Agillic, apri Settings e cerca le chiavi API (API credentials).
  2. Crea una nuova chiave e dalle un nome che riconosci, per esempio "Scratcher".
  3. 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

  1. In Scratcher, vai su Impostazioni > Integrazioni e clicca su Agillic.
  2. Incolla la Developer key e il Secret.
  3. Clicca su Installa integrazione. Scratcher accede ad Agillic per controllarli.

Passaggio 3: attivalo in una campagna

  1. Nell'editor, vai su Collega > Integrazioni > Agillic e clicca su Attiva.
  2. Se hai collegato più di un account, sceglilo in Seleziona account.
  3. In Mappature dei campi, abbina ogni Campo Scratcher a un campo person data di Agillic.
  4. 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.
  5. In Filtra per consensi (facoltativo), scegli la tua casella di consenso al marketing, così vengono inviate solo le persone che hanno detto sì.
  6. 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.
Ti serve una mano?

Hai ancora bisogno di aiuto?

Persone vere sono qui per aiutarti. Se usi già Scratcher, il modo più veloce è la chat all'interno della piattaforma.

  • Chatta con noi

    Accedi e clicca sul pulsante della chat in basso a destra. Rex risponde subito e il nostro team è a un clic di distanza.

  • Prenota un incontro

    Una videochiamata gratuita di 30 minuti con il nostro team: un tour, idee per campagne o aiuto con la configurazione.

  • Scrivici

    Scrivi a contact@scratcher.io e ti risponderemo.