---
title: "Collega Agillic"
description: "Crea una chiave API in Agillic, collegala con developer key e secret, e crea o aggiorna i destinatari con i campi che scegli."
url: https://scratcher.io/it/help/integrations/agillic
language: it
---

1. [Centro assistenza](https://scratcher.io/it/help)
2. [Integrazioni](https://scratcher.io/it/help/integrations)
3. Collega Agillic

# 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.

Integrazioni

- [Come funzionano le integrazioni](https://scratcher.io/it/help/integrations/how-integrations-work)
- [Tutte le integrazioni](https://scratcher.io/it/help/integrations/other-integrations)
- [Controlla lo stato della consegna e invia di nuovo i lead](https://scratcher.io/it/help/integrations/delivery-status)
- [Collega HubSpot](https://scratcher.io/it/help/integrations/hubspot)
- [Collega Salesforce Marketing Cloud](https://scratcher.io/it/help/integrations/salesforce-marketing-cloud)
- [Collega Microsoft Dynamics 365 con Zapier](https://scratcher.io/it/help/integrations/microsoft-dynamics-365)
- [Collega Emarsys](https://scratcher.io/it/help/integrations/emarsys)
- [Collega Klaviyo](https://scratcher.io/it/help/integrations/klaviyo)
- [Collega Mailchimp](https://scratcher.io/it/help/integrations/mailchimp)
- [Collega ActiveCampaign](https://scratcher.io/it/help/integrations/activecampaign)
- [Collega Apsis One](https://scratcher.io/it/help/integrations/apsis-one)
- [Collega Drip](https://scratcher.io/it/help/integrations/drip)
- [Collega HeyLoyalty](https://scratcher.io/it/help/integrations/heyloyalty)
- [Collega Peytz](https://scratcher.io/it/help/integrations/peytz)
- [Collega Marketingplatform](https://scratcher.io/it/help/integrations/marketingplatform)
- [Collega Campaign Monitor con Zapier](https://scratcher.io/it/help/integrations/campaign-monitor)
- [Collega ActiveTrail con Zapier](https://scratcher.io/it/help/integrations/activetrail)
- [Collega Bloomreach](https://scratcher.io/it/help/integrations/bloomreach)
- [Collega Iterable](https://scratcher.io/it/help/integrations/iterable)
- [Collega Mapp](https://scratcher.io/it/help/integrations/mapp)
- [Collega Agillic](https://scratcher.io/it/help/integrations/agillic)
- [Collega Ortto](https://scratcher.io/it/help/integrations/ortto)
- [Collega Emarketeer](https://scratcher.io/it/help/integrations/emarketeer)
- [Collega Shopify](https://scratcher.io/it/help/integrations/shopify)
- [Collega Hello Retail](https://scratcher.io/it/help/integrations/hello-retail)
- [Collega oltre 8.000 app con Zapier](https://scratcher.io/it/help/integrations/zapier)
- [Collega monday.com con Zapier](https://scratcher.io/it/help/integrations/monday-com)
- [Collega Asana con Zapier](https://scratcher.io/it/help/integrations/asana)
- [Collega Podio con Zapier](https://scratcher.io/it/help/integrations/podio)
- [Collega Intercom con Zapier](https://scratcher.io/it/help/integrations/intercom)

Continua a imparare

## Articoli correlati

- [Come funzionano le integrazioni](https://scratcher.io/it/help/integrations/how-integrations-work): Collega una volta il tuo strumento di email marketing o il CRM, attivalo in ogni campagna, scegli una lista, abbina i campi e invia solo chi ha dato il consenso.
- [Controlla lo stato della consegna e invia di nuovo i lead](https://scratcher.io/it/help/integrations/delivery-status): Scopri quali lead sono stati inviati ai tuoi strumenti, capisci i messaggi di errore, risolvi il problema e inviali di nuovo.
- [Chiedi il consenso e aggiungi termini e condizioni](https://scratcher.io/it/help/forms/consent-and-permissions): Aggiungi caselle di consenso per le newsletter, collega il tuo regolamento, scegli quale casella iscrive le persone e invia al tuo strumento di email marketing solo chi ha detto sì.

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](https://platform.scratcher.io/it/login)**

    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](https://scratcher.io/it/book-a-meeting)**

    Una videochiamata gratuita di 30 minuti con il nostro team: un tour, idee per campagne o aiuto con la configurazione.
- **[Scrivici](mailto:contact@scratcher.io)**

    Scrivi a contact@scratcher.io e ti risponderemo.
