> ## Documentation Index
> Fetch the complete documentation index at: https://docs.irelia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Come collegare Irelia.ai a Zapier tramite Webhook: guida passo dopo passo

> Collega i tuoi Agent conversazionali di Irelia.ai a Zapier tramite webhook — così ogni lead qualificato, dato raccolto o obiettivo completato fluisce automaticamente verso il tuo CRM, i tuoi fogli di calcolo o la chat del team in tempo reale, senza alcun lavoro manuale.

<Badge color="blue" size="md" shape="pill" icon="clock">\~20 minuti di configurazione</Badge>

***

<Columns cols={3}>
  <Card title="Cosa ti serve" icon="clipboard-list" href="#-cosa-ti-serve">
    Prerequisiti prima di iniziare
  </Card>

  <Card title="Casi d'uso comuni" icon="bullseye" href="#-casi-d%E2%80%99uso-comuni">
    Parti da qui, trova il tuo caso d'uso
  </Card>

  <Card title="Percorso rapido" icon="bolt" href="#-percorso-rapido-utenti-esperti">
    Passaggi condensati per utenti esperti
  </Card>

  <Card title="Configurazione passo dopo passo" icon="wrench" href="#-configurazione-passo-dopo-passo">
    Guida completa (Passaggi 1–6)
  </Card>

  <Card title="Automazioni avanzate" icon="rocket" href="#-automazioni-avanzate">
    Filtri, percorsi ed esempi reali
  </Card>

  <Card title="Checklist rapida" icon="check" href="#-checklist-rapida">
    Verifica che la tua configurazione sia completa
  </Card>

  <Card title="Risoluzione dei problemi e FAQ" icon="screwdriver-wrench" href="#-risoluzione-dei-problemi-e-faq">
    Problemi comuni e soluzioni
  </Card>
</Columns>

***

### Introduzione

Hai costruito il tuo Agent conversazionale su [Irelia.ai](/it/How-Irelia.ai-Works), e sta già chattando con i potenziali clienti su [WhatsApp](/it/How-to-Connect-WhatsApp-Business-to-Irelia.ai), [Facebook e Instagram](/it/How-to-Connect-Meta-Messenger-and-Instant-Forms-to-Irelia.ai). Ma cosa succede quando avviene qualcosa di importante — come quando un lead viene qualificato, quando il tuo Agent raccoglie informazioni chiave, o quando qualcuno [prenota un appuntamento](/it/How-to-Set-Up-Calendar-Booking-in-Irelia)?

In questo momento, probabilmente controlli manualmente la tua [Dashboard di Irelia](/it/the-Chat-Panel) e copi le informazioni in altri strumenti. C'è un modo migliore.

Questa guida ti mostra come inviare automaticamente le informazioni da Irelia ai tuoi altri strumenti aziendali nell'istante in cui succede qualcosa di importante — niente lavoro manuale, niente ritardi, niente dashboard da controllare.

**Alla fine di questa guida, avrai:**

✅ Un'automazione funzionante che si attiva quando accadono momenti importanti nelle tue conversazioni Irelia<br />
✅ Dati che fluiscono automaticamente da Irelia al tuo CRM, fogli di calcolo o chat del team<br />
✅ Le conoscenze per creare un numero illimitato di automazioni aggiuntive

### Come funziona

Pensa a questa connessione come a un sistema di videocitofono smart:

| Sistema videocitofono                                                       | La tua automazione                                                                                               |
| :-------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
| 🏠 Qualcosa succede alla tua porta (suonano il campanello, arriva un pacco) | Il tuo Agent ha un momento importante (lead qualificato, obiettivo raggiunto, dati raccolti)                     |
| 📹 La videocamera cattura l'evento e invia le informazioni                  | Il webhook di Irelia impacchetta i dettagli (chi, cosa, quando)                                                  |
| 📱 Il tuo telefono riceve la notifica                                       | Zapier riceve i dati istantaneamente                                                                             |
| ⚡ Si attiva un'azione automatica (salva il video, avvisa la famiglia)       | Le tue app fanno il loro lavoro (aggiungono al CRM, inviano un messaggio Slack, aggiornano il foglio di calcolo) |

**La magia:** Tutto avviene automaticamente in pochi secondi. Niente lavoro manuale. Niente ritardi. Niente dashboard da controllare.

### 📡 Di quali eventi può notificarti Irelia?

Mentre il tuo Agent chatta con i potenziali clienti, Irelia traccia traguardi importanti chiamati **eventi** — i "momenti che contano" nelle tue conversazioni.

Ecco alcuni esempi di eventi Irelia:

| Evento                           | Cosa significa                                                                 | Esempio d'uso                          |
| :------------------------------- | :----------------------------------------------------------------------------- | :------------------------------------- |
| 💬 **Nuovo contatto in entrata** | Qualcuno ti scrive per primo                                                   | → Notifica il team commerciale         |
| 🎯 **Lead qualificato**          | Il potenziale cliente soddisfa i tuoi criteri                                  | → Aggiungi al CRM                      |
| ❌ **Lead non qualificato**       | Il potenziale cliente non è in target                                          | → Aggiungi a una campagna di nurturing |
| ✅ **Obiettivo raggiunto**        | Il potenziale cliente ha completato un obiettivo                               | → Invia email di conferma              |
| 📝 **Dati raccolti**             | L'Agent ha raccolto informazioni specifiche                                    | → Aggiorna il foglio di calcolo        |
| ❓ **Domanda senza risposta**     | Il potenziale cliente ha fatto una domanda a cui l'Agent non sapeva rispondere | → Crea un task per il team             |

Quando un evento si attiva, Irelia impacchetta tutte le informazioni rilevanti — dettagli del contatto, cronologia della conversazione, stato di qualificazione, dati personalizzati — e le invia a Zapier istantaneamente.

**Per questa guida useremo "New Inbound Contact"** (Nuovo contatto in entrata) perché è facile da attivare e perfetto per imparare. Una volta capito come funziona, potrai configurare facilmente anche gli altri eventi.

### 📝 Cosa farai

1. 🔗 **Ottenere un URL webhook da Zapier** — 3 min
2. 📋 **Incollare l'URL in Irelia** — 2 min
3. 🧪 **Inviare dati di test** — 2 min
4. ⚡ **Configurare la tua azione** (Google Sheets, Slack, ecc.) — 5 min
5. ✅ **Testare tutto dall'inizio alla fine** — 3 min
6. 🚀 **Attivare e dare un nome** — 1 min

**Totale: \~15–20 minuti**

## 📋 Cosa ti serve

* Un account Irelia.ai con almeno un Agent attivo <Badge color="orange" size="md" shape="pill">Obbligatorio</Badge>
* Un account Zapier (il piano gratuito va benissimo) — [Registrati qui](https://zapier.com) se necessario <Badge color="orange" size="md" shape="pill">Obbligatorio</Badge>
* Una destinazione per i tuoi dati (Google Sheets, Slack o il tuo CRM) <Badge color="orange" size="md" shape="pill">Obbligatorio</Badge>

**Non serve saper programmare.** Se sai copiare e incollare, puoi farcela.

## 🎯 Casi d'uso comuni

**L'80% dei lettori ha bisogno di una di queste due configurazioni.** Trova la tua, prendi nota delle indicazioni, poi segui la [Configurazione passo dopo passo](#-configurazione-passo-dopo-passo) qui sotto — dovrai solo fare scelte diverse al Passaggio 2 e al Passaggio 4.

<Tabs>
  <Tab title="Aggiornare il CRM alla qualificazione">
    *Esempi: lead segnato come qualificato → aggiorna lo stato su HubSpot · appuntamento prenotato → registralo nel foglio di calcolo · obiettivo completato → notifica il team commerciale*

    📡 **Seleziona questo evento al Passaggio 2:** `Lead Qualified` o `Goal Achieved`

    **Quali passaggi devo seguire?**

    * **Il contatto esiste già** nel tuo CRM o foglio di calcolo → Segui i Passaggi 1–3, poi usa il pattern [Cerca e aggiorna](#cerca-e-aggiorna-record-esistenti) per il Passaggio 4.
    * **Il contatto è nuovo** (non è ancora nel tuo sistema) → Segui i Passaggi 1–6 come scritto (Esempio A, B o C nel Passaggio 4).

    ```mermaid actions placement="bottom-right" theme={null}
    flowchart TD
        A["Il lead si qualifica o un obiettivo viene completato"] --> B{"Questo contatto esiste già nel tuo CRM / foglio di calcolo?"}
        B -->|Sì| C["Segui i Passaggi 1-3, poi vai a Cerca e Aggiorna per il Passaggio 4"]
        B -->|No| D["Segui i Passaggi 1-6 come scritto"]
    ```

    <Warning>
      **Errore più comune:** Il contatto probabilmente esiste già nel tuo sistema (lo avrai aggiunto al primo contatto). Se usi di nuovo "Create Row" o "Create Contact", otterrai dei **duplicati**. Usa il pattern [Cerca e aggiorna record esistenti](#cerca-e-aggiorna-record-esistenti) per il Passaggio 4 al suo posto.
    </Warning>
  </Tab>

  <Tab title="Inviare i dati raccolti">
    *Esempi: l'Agent raccoglie il budget → popola un campo del CRM · dimensione aziendale raccolta → aggiorna la riga del foglio di calcolo · tempistiche acquisite → segmenta il lead automaticamente*

    📡 **Seleziona questo evento al Passaggio 2:** `Data Gathered`

    **Quali passaggi devo seguire?**

    * **Il contatto esiste già** nel tuo CRM o foglio di calcolo → Segui i Passaggi 1–3, poi usa il pattern [Cerca e aggiorna](#cerca-e-aggiorna-record-esistenti) per il Passaggio 4.
    * **Il contatto è nuovo** (non è ancora nel tuo sistema) → Segui i Passaggi 1–6 come scritto (Esempio A, B o C nel Passaggio 4).

    ```mermaid actions placement="bottom-right" theme={null}
    flowchart TD
        A["L'Agent raccoglie un'informazione"] --> B{"Questo contatto esiste già nel tuo CRM / foglio di calcolo?"}
        B -->|Sì| C["Segui i Passaggi 1-3, poi vai a Cerca e Aggiorna per il Passaggio 4"]
        B -->|No| D["Segui i Passaggi 1-6 come scritto"]
    ```
  </Tab>
</Tabs>

<Tip>
  **Non trovi il tuo caso d'uso?** Nessun problema — dai un'occhiata alla [tabella completa degli eventi](#-di-quali-eventi-può-notificarti-irelia) e segui la guida usando "New Inbound Contact" come evento di apprendimento. Il processo è identico per ogni evento; cambiano solo le tue selezioni al Passaggio 2 e al Passaggio 4.
</Tip>

## ⚡ Percorso rapido (utenti esperti)

Già a tuo agio con Zapier? Ecco la versione condensata:

1. **Zapier:** Crea uno Zap → Trigger: "Webhooks by Zapier" → Event: "Catch Hook" → Copia l'URL del webhook
2. **Irelia:** Settings → Seleziona l'Agent → Events and Notifications → Incolla l'URL nel campo dell'evento desiderato
3. **Test:** Clicca il pulsante "Test" in Irelia → Torna su Zapier → Verifica che i dati siano arrivati
4. **Azione:** Aggiungi la tua app di destinazione → Mappa i campi → Testa → Pubblica

Hai bisogno di più dettagli? Continua con la guida completa qui sotto.

## 🔧 Configurazione passo dopo passo

### Passaggio 1: Configura Zapier per ricevere le notifiche di Irelia

<Badge color="blue" size="md" shape="pill" icon="clock">\~3 minuti</Badge>

In questo passaggio creerai una nuova <Tooltip tip="Zapier chiama ogni automazione uno Zap">automazione</Tooltip> e la configurerai per ascoltare gli eventi provenienti da Irelia.

#### Crea il tuo Zap

1. Accedi al tuo account Zapier su [zapier.com](https://zapier.com)
2. Clicca il pulsante **"Create Zap"** (in alto a sinistra o al centro della tua dashboard)

<Frame caption="Clicca su Create Zap per iniziare a costruire la tua automazione">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/1.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=e0a2ff051cdce05fbdd692c2fd4032f7" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 1 - Configura Zapier per ricevere le notifiche di Irelia. Dashboard di Zapier con il pulsante arancione più Create evidenziato in alto a sinistra, vicino al riquadro What would you like to automate con la barra di ricerca Copilot e le schede Start from scratch sotto. Cliccando questo pulsante si apre l'editor dello Zap dove inizia l'automazione tra Irelia e Zapier." width="1920" height="874" data-path="images/Guida-Zapier-crm/1.png" />
</Frame>

3. Vedrai l'editor dello Zap con due sezioni principali:
   * **"Trigger"** (cosa avvia l'automazione) ← lo configurerai ora
   * **"Action"** (cosa succede dopo) ← lo configurerai al Passaggio 4

<Frame caption="L'editor dello Zap con le sezioni Trigger e Action">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/2.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=fe225cc49e4b6d10fcd748f3620a4ff0" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 1 - Configura Zapier per ricevere le notifiche di Irelia. Editor dello Zap con i due blocchi Trigger, Select the event that starts your Zap, e Action, Select the event for your Zap to run, entrambi incorniciati e indicati da freccette rosse. È la tela vuota su cui il lettore configurerà cosa avvia l'automazione e cosa succede dopo." width="1920" height="874" data-path="images/Guida-Zapier-crm/2.png" />
</Frame>

#### Scegli i webhook come trigger

4. Clicca sulla barra di ricerca nella sezione **"Trigger"**
5. Digita `webhooks` e seleziona **"Webhooks by Zapier"**

<Frame caption="Cerca e seleziona Webhooks by Zapier">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/3.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=0b5e5db5048fbc685d850cf829aa2cf2" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 1 - Configura Zapier per ricevere le notifiche di Irelia, Scegli i webhook come trigger. Pannello di configurazione del Trigger con la barra di ricerca dove è digitato webhooks e il risultato Webhooks by Zapier Premium evidenziato da una freccia rossa nell'elenco a tendina sotto. Selezionare questa app indica a Zapier di rimanere in ascolto dei dati inviati da Irelia." width="1920" height="874" data-path="images/Guida-Zapier-crm/3.png" />
</Frame>

6. Per l'**"Event"**, seleziona **"Catch Hook"**

<Frame caption="Seleziona Catch Hook come tipo di evento">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/4.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=46cb43acaceab0c5d06e54070d1b88c5" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 1 - Configura Zapier per ricevere le notifiche di Irelia, Scegli i webhook come trigger. Menu a tendina del Trigger event per Webhooks by Zapier con l'opzione Catch Hook, descritta come triggers when a POST, PUT, or GET request is made to a Zapier URL, evidenziata in rosso sopra Catch Raw Hook e Retrieve Poll. È esattamente l'evento da selezionare perché Zapier resti in attesa dei dati che Irelia invierà." width="1920" height="874" data-path="images/Guida-Zapier-crm/4.png" />
</Frame>

7. Clicca il pulsante **"Continue"** due volte (attraversando le sezioni **"Setup"** e **"Configure"**)

#### Ottieni il tuo URL webhook

Questa è la **parte più importante** — stai ottenendo un URL unico che indica a Irelia esattamente dove inviare le informazioni.

8. Zapier mostrerà un **Custom Webhook URL** che assomiglia a: `https://hooks.zapier.com/hooks/catch/123456/abcdef/`
9. Clicca il pulsante **"Copy"** accanto all'URL

<Frame caption="Copia l'URL univoco del webhook da incollare in Irelia">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/5.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=e3d6ea7d8c9eac1f637fd8e9f4be51ac" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 1 - Configura Zapier per ricevere le notifiche di Irelia, Ottieni il tuo URL webhook. Scheda di test di Catch Hook con il riquadro generato Your webhook URL contenente un indirizzo hooks.zapier.com/hooks/catch parzialmente oscurato e il pulsante blu Copy incorniciato in rosso, sopra il messaggio We're listening e il pulsante Test trigger. Copiare questo URL univoco è ciò che il lettore incollerà in Irelia al passaggio successivo." width="1920" height="874" data-path="images/Guida-Zapier-crm/5.png" />
</Frame>

<Callout icon="lock" color="#007BFF">
  **Tratta questo URL come una password.** Chiunque abbia il tuo URL webhook può inviare dati al tuo account Zapier. Non condividerlo pubblicamente e non includerlo negli screenshot che pubblichi online.
</Callout>

<Warning>
  **Tieni aperta questa scheda di Zapier!** Dovrai tornarci tra qualche minuto.
</Warning>

### Passaggio 2: Indica a Irelia dove inviare le notifiche

<Badge color="blue" size="md" shape="pill" icon="clock">\~2 minuti</Badge>

Ora accederai a Irelia e incollerai l'URL webhook che hai appena copiato.

<Note>
  **Contesto rapido:** In Irelia, ogni Agent può avere le proprie automazioni. Per questa guida configurerai un evento per un Agent. Una volta capito come funziona, potrai configurarne facilmente di più.
</Note>

#### Accedi alle impostazioni del tuo Agent

1. Accedi alla dashboard delle impostazioni di Irelia.ai
2. Seleziona l'Agent che vuoi collegare a Zapier

<Frame caption="Seleziona l'Agent che vuoi collegare a Zapier">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/6.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=4e4965c40f2205fdcd91056e6e4a0f74" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 2 - Indica a Irelia dove inviare le notifiche, Accedi alle impostazioni del tuo Agent. Elenco Agents dello spazio di lavoro NextWave AI con tre card, Nuovo Agente, Agente creato da Wizard 1 e Agente creato da Wizard, con quella centrale incorniciata in rosso e una freccia che la indica, accanto al pulsante blu New Agent in alto a destra. È qui che il lettore scegliere l'Agent specifico da collegare a Zapier." width="1920" height="874" data-path="images/Guida-Zapier-crm/6.png" />
</Frame>

3. Vai su **"Events and Notifications"** (Eventi e notifiche)

<Frame caption="Naviga su Events and Notifications">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/7.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=c6b37081ece10ed0e005a2a0ce85e5f1" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 2 - Indica a Irelia dove inviare le notifiche. Pagina delle impostazioni dell'Agente creato da Wizard con la barra di tab superiore Trigger, Prompt, Follow-up ed Events and notifications, quest'ultima evidenziata in rosso e già aperta, con il campo Email address to notify e l'inizio del pannello Events, integrations and notifications. Questo conferma che il lettore ha raggiunto la schermata giusta per configurare il webhook." width="1920" height="874" data-path="images/Guida-Zapier-crm/7.png" />
</Frame>

#### Configura il tuo webhook

4. Vedrai un elenco di eventi disponibili

<Frame caption="Il pannello Events and Notifications con gli eventi disponibili">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/8.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=02210b2e51ed33158273e9b22920ab94" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 2 - Indica a Irelia dove inviare le notifiche, Configura il tuo webhook. Pannello Events, integrations and notifications con tre eventi, ciascuno con il proprio campo URL https e pulsante Test, New inbound contact reaching out to us, New contact for outbound outreach e New information gathered, tutti e tre i campi URL segnati da freccette rosse. Questo mostra al lettore gli eventi disponibili e dove va incollato l'URL webhook specifico per ciascuno." width="1920" height="874" data-path="images/Guida-Zapier-crm/8.png" />
</Frame>

5. Trova **"New inbound contact reaching out to us"** (o l'evento che vuoi configurare)

<Tip>
  **Stai scegliendo l'evento giusto?** Se stai seguendo un [caso d'uso specifico tra quelli sopra](#-casi-d%E2%80%99uso-comuni), seleziona l'evento indicato lì anziché "New inbound contact."
</Tip>

6. Clicca sul campo **"URL"** accanto a questo evento
7. **Incolla** l'URL webhook che hai copiato da Zapier (l'URL si salverà automaticamente)

<Frame caption="URL webhook incollato con il pulsante Test visibile">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/9.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=ed0bafe57aab761c83b3f3531a5ce09c" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 2 - Indica a Irelia dove inviare le notifiche, Configura il tuo webhook. Primo piano del campo New inbound contact reaching out to us con l'indirizzo webhook incollato hooks.zapier.com/hooks/catch/2 dentro un riquadro rosso, e il pulsante blu Test incorniciato in rosso subito a fianco. Questo conferma che l'URL di Zapier è stato incollato correttamente prima di inviare un test." width="1920" height="874" data-path="images/Guida-Zapier-crm/9.png" />
</Frame>

<Tip>
  **Hai bisogno di cambiare l'URL in seguito?** Puoi aggiornarlo in qualsiasi momento — basta incollare quello nuovo e cliccare di nuovo **"Test"**. Il vecchio URL smetterà di funzionare e quello nuovo prenderà il suo posto immediatamente.
</Tip>

<Check>
  **Operazione riuscita!** Questo evento invierà i dati a Zapier ogni volta che qualcuno contatta questo Agent per la prima volta.
</Check>

### Passaggio 3: Testa la connessione

<Badge color="blue" size="md" shape="pill" icon="clock">\~2 minuti</Badge>

Ora verifichiamo che Irelia e Zapier riescano a comunicare tra loro.

#### Invia dati di test da Irelia

1. Nella configurazione webhook di Irelia (dove hai appena incollato l'URL), trova il pulsante blu **"Test"** accanto al campo dell'URL webhook
2. Clicca **"Test"**

<Frame caption="Clicca Test per inviare dati di esempio a Zapier">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/10.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=277220722b578ae4d9c928dcbc0c3567" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 3 - Testa la connessione, Invia dati di test da Irelia. Lo stesso campo webhook New inbound contact reaching out to us in Irelia con il pulsante blu Test incorniciato in rosso e una freccia rossa che lo indica, pronto per essere cliccato. Cliccando questo pulsante si invia un pacchetto di dati di esempio da Irelia all'URL webhook di Zapier appena configurato." width="1920" height="874" data-path="images/Guida-Zapier-crm/10.png" />
</Frame>

3. Dovresti vedere un indicatore verde di successo che dice **"Just sent a data sample successfully"**

<Frame caption="Conferma verde di successo dopo l'invio dei dati di test">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/11.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=83f9c84beecdb70bb98e57ad4fe1d2c7" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 3 - Testa la connessione, Invia dati di test da Irelia. Banner verde di successo in fondo al pannello Events and notifications di Irelia con il testo Just sent a data sample successfully, con una freccia rossa che punta verso il basso dalla sezione New information gathered sopra. Questo conferma che Irelia ha inviato correttamente i dati di esempio a Zapier." width="1920" height="874" data-path="images/Guida-Zapier-crm/11.png" />
</Frame>

<Info>
  **Cosa è appena successo:** Irelia ha inviato dati di esempio a Zapier. Questi dati di esempio ti mostrano esattamente che tipo di informazioni Irelia invierà quando questo evento si verificherà davvero in una conversazione reale.
</Info>

#### Verifica che Zapier abbia ricevuto i dati

4. Torna alla scheda di Zapier (quella che hai tenuto aperta)
5. Clicca il pulsante **"Test trigger"** per ricevere il campione di dati

<Frame caption="Clicca Test trigger per verificare che i dati siano arrivati">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/12.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=b811a9241c892504289a3c07bb3334fd" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 3 - Testa la connessione, Verifica che Zapier abbia ricevuto i dati. Passaggio Catch Hook di Zapier con le tab Setup e Configure già completate e la tab Test attiva, con il messaggio We're listening e il pulsante viola Test trigger in basso incorniciato in rosso con una freccia che lo indica. Cliccando Test trigger si chiede a Zapier di cercare i dati di esempio appena inviati da Irelia." width="1920" height="874" data-path="images/Guida-Zapier-crm/12.png" />
</Frame>

6. Apparirà un elenco di campioni di dati — selezionane uno

<Frame caption="Seleziona un campione di dati e clicca Continue with selected record">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/13.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=a633d7128453f2d5691f37032e5ba747" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 3 - Testa la connessione, Verifica che Zapier abbia ricevuto i dati. Risultati del test di Catch Hook in Zapier con due record di esempio, request B e request A, con request A selezionato e incorniciato in rosso e una freccia rossa che lo indica, sopra il pulsante viola Continue with selected record. Scegliere un record di esempio permette a Zapier di apprendere la struttura dei dati che Irelia invia per questo evento." width="1920" height="874" data-path="images/Guida-Zapier-crm/13.png" />
</Frame>

7. Clicca il pulsante **"Continue with selected record"**

<Check>
  **Operazione riuscita!** Irelia e Zapier sono collegati e comunicano tra loro.
</Check>

### Capire cosa ti invia Irelia

Prima di configurare la tua azione, prenditi 60 secondi per capire cosa Irelia ha appena inviato a Zapier.

<Frame caption="Payload completo del webhook di Irelia con tutti i campi dati disponibili">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/14.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=df94586f6292e55cdc26a0980b7124e8" alt="Guida Irelia.ai all'integrazione con Zapier, Capire cosa ti invia Irelia. Pannello dei dati di esempio del test di Catch Hook incorniciato in rosso, con il gruppo conversationFlow contenente Conversation Flow Id e Conversation Flow Name, oltre ai campi User Name Test Name, User Number 393123456789, User Message Test Message, Date e querystring. Questo è l'insieme completo dei campi dati che Irelia inserisce nel payload del webhook per un evento New inbound contact." width="1920" height="874" data-path="images/Guida-Zapier-crm/14.png" />
</Frame>

Puoi suddividere concettualmente questi dati in tre categorie.

**1. 👤 Chi sono (Informazioni di contatto)**

* `userName` — Il nome del potenziale cliente
* `userNumber` — Il suo numero di telefono
* `inboundLead` — Ha scritto per primo (`true`) o hai scritto tu (`false`)?

**2. 💬 Cosa è successo (Dettagli della conversazione)**

Per Agent — la chat specifica che l'utente ha avuto con un Agent specifico (nella sezione `conversationFlow`):

* `id` — Identificativo univoco dell'Agent
* `name` — Nome dell'Agent conversazionale
* `chatHistory` — Trascrizione completa della conversazione con questo Agent
* `leadQualification` — Il contatto è qualificato da questo Agent? (`"fit"`, `"not a fit"`, o `"TBD"`)
* `interestScore` — Quanto è interessato? (da 0.0 a 1.0, come da 0% a 100%)
* `reasonNotQualified` — Perché non si è qualificato (se applicabile)
* `goalAchieved` — Numero di obiettivi completati con questo Agent
* `numberOfMessageSent` — Messaggi inviati da questo Agent
* `numberOfMessageReceived` — Messaggi ricevuti dal potenziale cliente
* `numberOfQuestionLackingData` — Domande a cui l'AI non ha saputo rispondere dalla [Knowledge Base](/it/How-to-Train-Your-AI-Agent-with-the-Knowledge-Base-in-Irelia.ai)
* `creditConsumedForThisChat` — Crediti utilizzati per questa conversazione

Complessivi (su tutti gli Agent):

* `chatHistory` — Cronologia completa della chat su tutti gli Agent
* `optStatus` — Stato dell'opt-in (es. `"in"`, `"out"`)
* `creditConsumedForThisLead` — Crediti totali consumati
* `numberOfMessageSent` — Messaggi totali inviati
* `numberOfMessageReceived` — Messaggi totali ricevuti
* `numberOfQuestionLackingData` — Totale domande senza risposta
* `numberOfGoalAchieved` — Totale obiettivi raggiunti

**3. 📝 Cosa hai scoperto (Dati personalizzati)**

* `customVariables` — Informazioni specifiche raccolte dal tuo Agent (budget, dimensione aziendale, tempistiche, ecc.)

Ogni variabile personalizzata ha:

* `name` — Di cosa hai chiesto (es. "Budget")
* `value` — Risposta categorizzata (es. "\$10k-50k")
* `valueRaw` — Parole esatte usate dal contatto (es. "Abbiamo circa 30k da spendere")

<Frame caption="Variabili personalizzate con i campi name, value e valueRaw">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/15.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=4707a14f9ecd41ceb60534bd7e32fdd1" alt="Guida Irelia.ai all'integrazione con Zapier, Capire cosa ti invia Irelia. Sezione customVariables del payload di esempio incorniciata in rosso con freccette rosse, con quattro gruppi di variabili numerati ciascuno con i campi name, value e valueRaw, ad esempio name Email, name Nome, name Prodotto di interesse e name Note/richieste particolari, con i valori segnaposto Categorization Value Test e Raw Value Test. È qui che compaiono le informazioni specifiche raccolte dall'Agent AI su un potenziale cliente." width="1920" height="874" data-path="images/Guida-Zapier-crm/15.png" />
</Frame>

<Tip>
  **Usali per:** compilare i campi del CRM, personalizzare le email, segmentare i lead, dare contesto ai commerciali, indirizzare i lead a team diversi e dare priorità ai [follow-up](/it/How-to-Set-Up-Follow-ups).
</Tip>

<Info>
  **Non tutti gli eventi inviano tutti i dati.** Il test che hai appena eseguito mostra i dati per gli eventi **"New inbound contact"**. Eventi diversi inviano dati diversi. Non preoccuparti se non vedi tutti i campi menzionati sopra — stai vedendo esattamente ciò che è rilevante per il tuo evento.
</Info>

### Passaggio 4: Configura la tua azione

<Badge color="blue" size="md" shape="pill" icon="clock">\~5 minuti</Badge>

Ora arriva la parte divertente: decidere cosa deve succedere automaticamente quando Irelia invia i dati a Zapier.

#### Scegli la tua prima azione

Chiediti: *"Quando qualcuno contatta il mio Agent per la prima volta, qual è la COSA più utile che dovrebbe succedere automaticamente?"*

Risposte comuni:

* ✅ **Registrarlo subito** → Google Sheets (il più semplice, ottimo per testare)
* ✅ **Avvisare il mio team** → Slack (visibilità immediata)
* ✅ **Aggiungerlo al CRM** → HubSpot, Salesforce, Pipedrive (massimo valore di business)
* ✅ **Avviare una sequenza** → Strumento di email marketing (inizia il processo di nurturing)

**Il nostro consiglio per la tua prima automazione:** Scegli **Google Sheets** o **Slack**. Sono semplici da configurare e vedrai subito quando la tua automazione funziona. Una volta testata la connessione, potrai sempre cambiare l'azione con qualcosa di più complesso.

Qui sotto trovi istruzioni guidate per questi due esempi.

<Tip>
  **Vuoi qualcosa di diverso?** Se vuoi creare automazioni più complesse o collegare strumenti aziendali diversi, ti suggeriamo di cercare su YouTube il risultato esatto che vuoi ottenere (es. *"How to update contact information on HubSpot using Zapier"*).
</Tip>

#### Esempio A: Registra i nuovi contatti in Google Sheets

*Consigliato per chi è alla prima esperienza*

1. Nella sezione **"Action"**, clicca sulla barra di ricerca
2. Cerca e seleziona **"Google Sheets"**

<Frame caption="Seleziona Google Sheets come app di destinazione">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/16.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=1e16ea5202cb9fa1087762838a57ed35" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 4 - Configura la tua azione, Esempio A - Registra i nuovi contatti in Google Sheets. Pannello di ricerca dell'app di azione con Google Sheets evidenziato in rosso sotto Your top apps, vicino ad altri suggerimenti come Zoom, Google Calendar e HubSpot, e agli strumenti integrati Filter, Formatter e Paths sulla destra. Selezionare Google Sheets qui la imposta come app di destinazione che riceverà i dati di Irelia." width="1920" height="874" data-path="images/Guida-Zapier-crm/16.png" />
</Frame>

3. Scegli **"Create Spreadsheet Row"** come evento
4. Clicca il pulsante **"Continue"**
5. Collega il tuo account Google (clicca **"Sign in"** e segui le istruzioni)

<Frame caption="Accedi al tuo account Google per autorizzare l'accesso a Zapier">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/18.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=c0324eb98c301df7bbd29391b5326760" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 4 - Configura la tua azione, Esempio A - Registra i nuovi contatti in Google Sheets. Finestra di scelta dell'account Google titolata Accedi con Google, apertasi da Zapier, con l'account Paolo Scirpoli e la sua email incorniciati in rosso e una freccia che li indica, sopra l'opzione Utilizza un altro account. Scegliere un account Google qui concede a Zapier il permesso di creare righe nei fogli di calcolo di quell'account." width="1920" height="874" data-path="images/Guida-Zapier-crm/18.png" />
</Frame>

6. Seleziona il tuo **"Spreadsheet"** (o creane uno nuovo prima)
7. Seleziona il tuo **"Worksheet"** (di solito "Sheet1")

<Frame caption="Seleziona il tuo foglio di calcolo e il foglio di lavoro">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/19.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=3c7a9e7321d552bb4208a9df5977c993" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 4 - Configura la tua azione, Esempio A - Registra i nuovi contatti in Google Sheets. Pannello di configurazione Create Spreadsheet Row con tre freccette rosse che indicano il campo Drive impostato su My Google Drive, il campo Spreadsheet impostato su Irelia.ai e il campo Worksheet impostato su Foglio1. Questi menu a tendina indicano a Zapier esattamente in quale file e in quale foglio scrivere le nuove righe con i dati di Irelia." width="1920" height="874" data-path="images/Guida-Zapier-crm/19.png" />
</Frame>

8. **Mappa i campi** — qui dici a Zapier quali dati di Irelia vanno in quale colonna del foglio di calcolo. Clicca dentro ogni campo e Zapier ti mostrerà tutti i dati disponibili da Irelia. Seleziona quello che vuoi.

<Frame caption="Mappa i campi dati di Irelia alle colonne del foglio di calcolo">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/20.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=6b041e2cac91572ff42366bbf0636195" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 4 - Configura la tua azione, Esempio A - Registra i nuovi contatti in Google Sheets. Finestra di mappatura dei campi titolata Insert data for Numero di telefono, con le opzioni dati di Irelia provenienti dal passaggio Catch Hook come User Message, User Name e User Number 393123456789, con User Number selezionato e incorniciato in rosso; la colonna Numero di telefono a destra mostra già questo valore mappato. È il momento in cui il lettore collega un campo di Irelia a una colonna specifica del foglio di calcolo." width="1920" height="874" data-path="images/Guida-Zapier-crm/20.png" />
</Frame>

9. Clicca il pulsante **"Continue"**

**Vai al [Passaggio 5](#passaggio-5-testa-la-tua-automazione-completa) →**

#### Esempio B: Invia notifiche su Slack

*Ottimo per la visibilità del team*

1. Nella sezione **"Action"**, cerca **"Slack"**
2. Scegli **"Send Channel Message"**
3. Collega il tuo workspace Slack
4. Seleziona il tuo **"Channel"** (es. #leads, #sales, #notifications)

<Frame caption="Seleziona il canale Slack per le notifiche">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/23.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=dcec775e8a6522740cc4e090ccf20afa" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 4 - Configura la tua azione, Esempio B - Invia notifiche su Slack. Finestra Select value for Channel nell'azione Send Channel Message, con il canale generale selezionato tramite pulsante radio e incorniciato in rosso, elencato sopra automations-and-systems-bros e i controlli Load more, Refresh e Clear selection. È qui che il lettore indica all'azione Slack il canale specifico che dovrà ricevere le notifiche di Irelia." width="1920" height="874" data-path="images/Guida-Zapier-crm/23.png" />
</Frame>

5. **Componi il testo del messaggio** usando i campi dati di Irelia

<Frame caption="Componi il tuo messaggio Slack usando i campi dati di Irelia">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/24.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=ea067d8ca8713790963605e6853f7181" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 4 - Configura la tua azione, Esempio B - Invia notifiche su Slack. Campo Message Text dell'azione Send Channel Message incorniciato in rosso, con il testo composto New Prospect Inbound! seguito da Name: il token mappato User Name Test Name e Phone: il token mappato User Number 393123456789, con il campo User Number evidenziato nell'elenco dei dati a sinistra. Questo mostra come i campi dati di Irelia vengano inseriti direttamente nel modello del messaggio Slack." width="1920" height="874" data-path="images/Guida-Zapier-crm/24.png" />
</Frame>

6. Clicca il pulsante **"Continue"**

**Vai al [Passaggio 5](#passaggio-5-testa-la-tua-automazione-completa) →**

#### Esempio C: Crea un contatto nel CRM

*Massimo impatto sul business*

1. Nella sezione **"Action"**, cerca il tuo CRM (HubSpot, Salesforce, Pipedrive, ecc.)
2. Scegli **"Create Contact"** (la dicitura esatta varia in base al CRM)
3. Collega il tuo account CRM
4. Mappa i campi di Irelia ai campi del CRM
5. Clicca il pulsante **"Continue"**

### Passaggio 5: Testa la tua automazione completa

<Badge color="blue" size="md" shape="pill" icon="clock">\~3 minuti</Badge>

Testiamo l'intero flusso dall'inizio alla fine per assicurarci che tutto funzioni.

#### Esegui il test

1. In fondo alla configurazione della tua azione, clicca il pulsante **"Test action"** (o **"Test & Continue"**)

<Frame caption="Clicca Test action per eseguire l'automazione completa">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/25.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=5e4d27bf24521ea7ab6c1ddf839a6405" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 5 - Testa la tua automazione completa, Esegui il test. Scheda di test di Create Spreadsheet Row con il riepilogo Send Row(s) to Google Sheets e i campi Data in di esempio come timezone, spreadsheet, worksheet e Nome e Cognome Test Name, con il pulsante viola Test step in basso a destra incorniciato in rosso e una freccia che lo indica. Cliccando questo pulsante si esegue l'azione con i dati di esempio per confermare che l'intera pipeline funzioni." width="1920" height="874" data-path="images/Guida-Zapier-crm/25.png" />
</Frame>

2. Zapier invierà i tuoi dati di test all'app che hai selezionato
3. Vedrai un messaggio di successo: **"Test successful!"**

<Frame caption="Conferma verde di successo — la tua pipeline di automazione funziona">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/26.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=18b246fc3fdb52d9f317f77dd2592039" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 5 - Testa la tua automazione completa, Esegui il test. Pannello di test completato di Create Spreadsheet Row con un banner blu di conferma A Row(s) was sent to Google Sheets about 0 seconds ago, le tab Data in e Data out sopra, e il pulsante viola Publish in basso a destra incorniciato in rosso con una freccia che lo indica. Questo conferma che la riga di test è stata creata correttamente e che lo Zap è pronto per essere pubblicato." width="1920" height="874" data-path="images/Guida-Zapier-crm/26.png" />
</Frame>

#### Verifica che abbia funzionato

Ora controlla la tua destinazione per confermare:

**Se hai scelto Google Sheets:**

* Apri il tuo foglio di calcolo
* Cerca una nuova riga in fondo con i dati di test
* Dovresti vedere il nome del potenziale cliente, il numero di telefono, lo stato, ecc.

<Frame caption="Nuova riga con i dati di test di Irelia nel tuo foglio di calcolo">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/27.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=17a7e9e944ed8e758dee689a555fb0f9" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 5 - Testa la tua automazione completa, Verifica che abbia funzionato. Foglio Google di Irelia.ai nella tab Foglio1 con le colonne Nome e Cognome, Mail, Numero di telefono, Ref e Webinar, con una nuova riga che mostra Test Name e il numero di telefono 393123456789 compilati, evidenziata da una freccia rossa. Questo conferma che i dati di test inviati da Irelia sono arrivati correttamente nel foglio di calcolo." width="1920" height="874" data-path="images/Guida-Zapier-crm/27.png" />
</Frame>

**Se hai scelto Slack:**

* Apri Slack e vai al canale selezionato
* Dovresti vedere il tuo messaggio formattato con i dati di test

<Frame caption="Notifica Slack con i dati di test di Irelia">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/28.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=beb9783efcfbe5b9fb90bafe634b6aa6" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 5 - Testa la tua automazione completa, Verifica che abbia funzionato. Workspace Slack aperto sul canale cancelletto generale, con un messaggio di Kristian incorniciato in rosso che dice New Prospect Inbound! Name: Test Name e Phone: 393123456789. Questo mostra la notifica di test arrivare esattamente nel canale scelto durante la configurazione dell'azione Slack." width="1920" height="874" data-path="images/Guida-Zapier-crm/28.png" />
</Frame>

**Se hai scelto un CRM:**

* Apri il tuo CRM e cerca il contatto di test
* Verifica che i campi siano compilati correttamente

<Check>
  **Operazione riuscita!** I tuoi dati sono apparsi nel posto giusto — la tua automazione funziona!
</Check>

### Passaggio 6: Attiva e dai un nome al tuo Zap

<Badge color="blue" size="md" shape="pill" icon="clock">\~1 minuto</Badge>

#### Attiva il tuo Zap

1. In cima all'editor dello Zap, clicca il toggle o il pulsante **"Publish"** per impostare il tuo Zap su **ON**
2. Vedrai una conferma: **"Your Zap is ON"**

#### Dai un nome al tuo Zap

3. Clicca sul nome dello Zap in alto (probabilmente dice qualcosa come "Webhooks by Zapier + Google Sheets")
4. Rinominalo con qualcosa di descrittivo come: `Irelia: New Contact → Google Sheet`

<Frame caption="Dai al tuo Zap un nome descrittivo per gestirlo facilmente">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/29.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=6e94f189f5e50130a9e3d1aaf91f4d71" alt="Guida Irelia.ai all'integrazione con Zapier, Passaggio 6 - Attiva e dai un nome al tuo Zap, Dai un nome al tuo Zap. Barra superiore dell'editor dello Zap con il titolo in fase di modifica che riporta Irelia: New Contact → Google Sheet, cursore ancora attivo nel campo di testo, con una freccia rossa che punta verso l'alto da sotto. Rinominare lo Zap in questo modo lo rende facile da riconoscere in seguito tra le altre automazioni." width="1920" height="874" data-path="images/Guida-Zapier-crm/29.png" />
</Frame>

<Check>
  **Operazione riuscita!** La tua automazione è ora attiva!
</Check>

### 🎉 Complimenti! Ce l'hai fatta!

Prenditi un momento per apprezzare quello che hai appena costruito:

✅ Il tuo Agent ora comunica automaticamente con gli altri tuoi strumenti<br />
✅ I momenti importanti attivano azioni istantanee<br />
✅ Niente più inserimento manuale dei dati o dashboard da controllare — i tuoi sistemi sono sempre aggiornati<br />
✅ I tuoi lead ricevono follow-up più rapidi e migliori

**Cosa succede ora:**

Ogni volta che qualcuno contatta il tuo Agent Irelia per la prima volta → Irelia invia automaticamente le sue informazioni a Zapier → Zapier esegue immediatamente la tua azione → Tutto senza che tu muova un dito.

**Consigli rapidi per il successo:**

* 🎯 **Inizia in modo semplice** — Un evento, un'azione. Padroneggia quello prima di espandere.
* 🧪 **Testa a fondo** — Verifica sempre con dati reali prima di affidarti all'automazione.
* 📊 **Monitora regolarmente** — Controlla la Zap History settimanalmente, soprattutto all'inizio.
* 🔄 **Migliora nel tempo** — La tua prima automazione non deve essere perfetta. Affinala con il tempo.
* 🤝 **Chiedi aiuto** — Sia Irelia che Zapier hanno ottimi team di supporto.

Ricorda: ogni esperto di automazione ha iniziato con un semplice Zap. Tu hai appena costruito il tuo. Le possibilità da qui in poi sono infinite. **Buona automazione! 🚀**

### Monitorare la tua automazione

**Primi giorni:** Controlla ogni giorno per assicurarti che i tuoi Zap funzionino correttamente e che i dati siano corretti.

**Nel tempo:** Zapier ti invia notifiche email quando gli Zap generano errori, quindi non devi controllare costantemente. Verifica solo che tutto funzioni durante i primi giorni.

#### Controlla la Zap History

1. Vai su **"Zap History"** (nella barra laterale sinistra della tua dashboard Zapier)
2. Qui puoi vedere ogni esecuzione del tuo Zap:
   * ✅ Successo (segno di spunta verde)
   * ❌ Errore (X rossa con dettagli)

<Frame caption="Zap History che mostra le esecuzioni riuscite con segni di spunta verdi">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/30.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=b659d50d47084a7c835018a8f871e299" alt="Guida Irelia.ai all'integrazione con Zapier, Monitorare la tua automazione, Controlla la Zap History. Pannello laterale Zap runs apertosi dall'icona a orologio evidenziata in rosso nella barra laterale sinistra, con quattro esecuzioni recenti Successful con segni di spunta verdi e orari per uno Zap da Gravity Forms a Webhooks by Zapier, con una freccia rossa che indica l'elenco. È qui che il lettore può verificare rapidamente che le automazioni funzionino senza errori." width="1920" height="874" data-path="images/Guida-Zapier-crm/30.png" />
</Frame>

<Tip>
  **Consiglio avanzato:** Vai su **"Account Settings"** → **"Notifications"** per attivare gli avvisi email in caso di errori degli Zap.
</Tip>

### Prossimi passi

Ora che hai un'automazione funzionante, le possibilità sono infinite.

Se vuoi collegarti ad altri eventi come "Data Gathered," "Lead Qualified," o "Goal Achieved," ripeti semplicemente i passaggi sopra e personalizza l'azione (Passaggio 4) per ottenere il risultato desiderato.

**Le tue opzioni da qui:**

1. 🎯 **Vuoi tracciare un altro evento?** Crea un nuovo Zap e ripeti questa guida — seleziona semplicemente un evento diverso al Passaggio 2
2. ➕ **Vuoi che questo Zap faccia più cose?** Modifica il tuo Zap e clicca il pulsante **+** sotto la tua azione per aggiungerne altre
3. 🤖 **Hai un altro Agent da collegare?** Ripeti questa guida per i tuoi altri Agent — ognuno può avere le proprie automazioni
4. ⚡ **Pronto per flussi avanzati?** Dai un'occhiata alla sezione [Automazioni avanzate](#-automazioni-avanzate) qui sotto

## 🚀 Automazioni avanzate

Pronto a fare di più? Queste sezioni ti mostrano come costruire flussi sofisticati.

### Cerca e aggiorna record esistenti

A volte non vuoi creare un nuovo record — vuoi aggiornarne uno esistente. Ad esempio, quando un lead che hai già aggiunto viene qualificato, o quando vengono raccolti nuovi dati per qualcuno già presente nel tuo sistema.

Questo richiede un approccio in due fasi: **prima cerca, poi aggiorna.**

**Esempio:** Aggiorna la riga di un lead esistente quando viene qualificato.

**Trigger:** Lead Qualified

**Azioni:**

1. **Cerca la riga esistente**

   * Aggiungi azione: **"Google Sheets"** → **"Lookup Spreadsheet Row"**
   * Imposta **"Lookup Column"** su "Phone"
   * Imposta **"Lookup Value"** su `userNumber` da Irelia
   * Questo trova la riga corrispondente al numero di telefono del potenziale cliente

2. **Aggiorna quella riga con i nuovi dati**

   * Aggiungi azione: **"Google Sheets"** → **"Update Spreadsheet Row"**
   * Imposta **"Row"** sul numero di riga restituito dall'azione di ricerca
   * Mappa i campi che vuoi aggiornare (stato del lead, punteggio di interesse, ecc.)

<Frame caption="Zap in tre passaggi: trigger Webhook, Lookup Row, Update Row">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/33.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=3274cacc4f05568543e650890de03028" alt="Guida Irelia.ai all'integrazione con Zapier, Automazioni avanzate, Cerca e aggiorna record esistenti. Tela dello Zap con tre passaggi collegati, 1. Catch Hook sotto Webhooks by Zapier, 2. Lookup Spreadsheet Row e 3. Update Spreadsheet Row entrambi sotto Google Sheets, gli ultimi due incorniciati da freccette rosse, accanto al pannello Configure di Catch Hook con il campo Pick off a Child Key vuoto. Questa struttura mostra il pattern cerca-poi-aggiorna usato per aggiornare un lead esistente invece di creare una riga duplicata." width="1920" height="874" data-path="images/Guida-Zapier-crm/33.png" />
</Frame>

**Risultato:** Invece di creare righe duplicate, le informazioni del tuo lead esistente vengono aggiornate direttamente sul posto.

<Warning>
  **Il formato del numero di telefono deve corrispondere.** Affinché la ricerca funzioni, il formato del numero di telefono nei tuoi record esistenti deve corrispondere al formato inviato da Irelia. Irelia invia i numeri di telefono **con il prefisso internazionale** (es. `393401234567`). Se i tuoi record esistenti memorizzano i numeri di telefono **senza** il prefisso (es. `3401234567`), la ricerca non troverà una corrispondenza — perché `3401234567` e `393401234567` sono tecnicamente valori diversi. Memorizza i numeri di telefono con il prefisso internazionale nei tuoi fogli di calcolo e CRM per assicurarti che i dati di Irelia corrispondano sempre ai tuoi record esistenti.
</Warning>

<Tip>
  **La stessa logica si applica ai CRM.** La maggior parte dei CRM (HubSpot, Salesforce, Pipedrive) ha azioni simili "Find Contact" e "Update Contact". Cerca per numero di telefono, poi aggiorna con i nuovi dati. Alcuni CRM offrono anche azioni "Create or Update" che gestiscono entrambi gli scenari automaticamente.
</Tip>

### Usare i filtri per controllare quando le azioni vengono eseguite

I filtri ti permettono di aggiungere condizioni in modo che la tua azione non venga eseguita per ogni evento.

**Esempio:** Aggiungi al CRM solo se il budget del potenziale cliente è "\$10k-50k" o superiore.

1. Nel tuo Zap, clicca il pulsante **+** tra il trigger e l'azione
2. Seleziona **"Filter"**
3. Imposta la tua condizione: `customVariables Value` **(text) contains** `$10k`
4. Solo i lead che soddisfano questo criterio proseguiranno verso la tua azione

<Frame caption="Configurazione del filtro sul campo customVariables Value">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/34.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=dace8385362c5d731a0e5e627d385d57" alt="Guida Irelia.ai all'integrazione con Zapier, Automazioni avanzate, Usare i filtri per controllare quando le azioni vengono eseguite. Passaggio Filter by Zapier incorniciato in rosso sulla tela dello Zap, con il pannello Filter conditions aperto a destra che mostra Only continue if su un campo Custom Variables, Text Contains, valore 10k, oltre alla nota Nice work, now let's test it out. Questo mostra come una condizione possa fermare lo Zap a meno che i dati del potenziale cliente non corrispondano a un valore specifico." width="1920" height="874" data-path="images/Guida-Zapier-crm/34.png" />
</Frame>

**Casi d'uso comuni per i filtri:**

* Aggiungi al CRM solo se il budget corrisponde al tuo target → `customVariables Value` **equals** `$10k-50k`
* Notifica il team solo se la dimensione aziendale è "Enterprise" → `customVariables Value` **contains** `Enterprise`
* Invia al commerciale solo se il lead è qualificato → `leadQualification` **equals** `"fit"`

<Tip>
  **Suggerimento:** Usa il campo `value` (la risposta categorizzata) per i filtri anziché `valueRaw` (le parole esatte). Il valore categorizzato è più coerente e affidabile per le condizioni di corrispondenza.
</Tip>

### Zap multi-step

Perché fare una sola cosa quando puoi farne diverse?

**Esempio:** Quando un lead viene qualificato:

1. Aggiungi a HubSpot CRM
2. Invia notifica Slack al team commerciale
3. Aggiungi al foglio Google "Hot Leads"
4. Invia email di benvenuto

**Come configurarlo:**

1. Dopo la tua prima azione, clicca il pulsante **+** sotto di essa
2. Seleziona **"Action"**
3. Aggiungi la tua seconda app e configurala
4. Ripeti per le azioni aggiuntive

<Frame caption="Zap multi-step con più azioni da un singolo trigger webhook">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/35.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=6636b8883ceacb13b35c0b3786f51782" alt="Guida Irelia.ai all'integrazione con Zapier, Automazioni avanzate, Zap multi-step. Zap chiamato Irelia: New Contact → Google Sheet con cinque passaggi in sequenza, Catch Hook, Filter conditions, Lookup Spreadsheet Row, Update Spreadsheet Row e un passaggio Slack per cui va ancora scelto l'evento, tutti mostrati in un unico flusso verticale. Questo illustra come più azioni possano essere eseguite una dopo l'altra a partire da un singolo trigger webhook di Irelia." width="1920" height="874" data-path="images/Guida-Zapier-crm/35.png" />
</Frame>

<Tip>
  **Suggerimento:** Le azioni vengono eseguite dall'alto verso il basso. Se un'azione precedente fallisce, quelle successive non verranno eseguite. Posiziona l'azione più critica per prima.
</Tip>

### Usare i percorsi per la logica Se/Allora

I percorsi ti permettono di creare logiche ramificate basate sui dati.

**Esempio:** Indirizza i lead in base allo stato di qualificazione:

* **Se** `leadQualification` è uguale a `"fit"` → **Percorso A:** Aggiungi a HubSpot + Notifica il commerciale
* **Altrimenti se** `leadQualification` è uguale a `"not a fit"` → **Percorso B:** Aggiungi a campagna di nurturing
* **Altrimenti** (`"TBD"`) → **Percorso C:** Aggiungi al foglio "Da revisionare"

<Frame caption="Uno Zap diviso in tre percorsi, ognuno con la sua regola e le sue azioni">
  <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/36.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=0897eeb9c6d6858b1a798bd6f4372fd9" alt="Guida Irelia.ai all'integrazione con Zapier, Automazioni avanzate, Usare i percorsi per la logica Se/Allora. Tela dello Zap che si ramifica in Path A, Path B e Path C sotto un passaggio Paths - Split into paths, che portano rispettivamente a una coppia Lookup e Update Spreadsheet Row su Google Sheets, a un evento Slack e a un evento HubSpot, con il pannello Path conditions a destra che mostra i menu Choose field e Choose condition ancora vuoti sotto Only continue if. Qui il lettore vede come un unico Zap si divide in rami separati, ognuno con la propria regola da impostare nel pannello Path conditions e le proprie azioni." width="1920" height="874" data-path="images/Guida-Zapier-crm/36.png" />
</Frame>

### Usare il Formatter per la trasformazione dei dati

Lo strumento Formatter di Zapier ti permette di trasformare i dati prima di inviarli:

* Formattare i numeri di telefono in modo coerente (aggiungere il prefisso internazionale)
* Dividere `userName` in nome e cognome
* Convertire `interestScore` da decimale (0.85) a percentuale (85%)
* Cambiare i formati delle date per adattarli al tuo CRM

### Esempi di casi d'uso reali

#### Caso d'uso 1: Corsia preferenziale per lead qualificati

**Trigger:** Lead Qualified

**Azioni:**

1. Crea contatto in HubSpot con stato "Hot Lead"
2. Invia notifica Slack al team commerciale
3. Aggiungi al foglio Google "Lead qualificati"
4. Invia email di benvenuto tramite Gmail

**Impatto:** Il team commerciale contatta i lead qualificati in pochi minuti anziché in ore.

#### Caso d'uso 2: Nurturing dei lead non qualificati

**Trigger:** Lead Disqualified

**Azioni:**

1. Aggiungi alla campagna di nurturing su Mailchimp
2. Registra nel foglio "Pipeline Nurturing"
3. Crea un task in Asana per il follow-up tra 3 mesi

**Impatto:** Nessun lead viene sprecato; tutti ricevono un follow-up appropriato.

#### Caso d'uso 3: Tracciamento delle lacune nella [Knowledge Base](/it/How-to-Train-Your-AI-Agent-with-the-Knowledge-Base-in-Irelia.ai)

**Trigger:** Question Lacking Answer

**Azioni:**

1. Invia notifica Slack al team contenuti in modo che possano rispondere manualmente tramite la [Dashboard di Irelia](/it/the-Chat-Panel)
2. Registra nel foglio "Lacune Knowledge Base"

**Impatto:** Migliora continuamente le conoscenze del tuo Agent.

#### Caso d'uso 4: Flusso per obiettivi raggiunti

**Trigger:** Goal Achieved

**Azioni:**

1. Invia email di conferma con i prossimi passi
2. Aggiorna il CRM con il completamento dell'obiettivo
3. Notifica l'account manager su Slack

**Impatto:** Rinforzo positivo istantaneo e percorso cliente fluido.

#### Caso d'uso 5: Raccolta dati avanzata

**Trigger:** Data Gathered

**Azioni:**

1. Aggiorna il CRM con le variabili personalizzate (budget, tempistiche, dimensione aziendale)
2. Aggiungi al foglio specifico del segmento (Enterprise vs PMI)
3. Attiva email personalizzata in base alle risposte

**Impatto:** Dati dettagliati sui potenziali clienti fluiscono automaticamente; niente inserimento manuale.

## ✅ Checklist rapida

Usa questa checklist per verificare che la tua configurazione sia completa:

<AccordionGroup>
  <Accordion title="Configurazione essenziale" icon="list-check" defaultOpen={true}>
    * URL webhook copiato da Zapier
    * URL incollato in Irelia per l'evento scelto
    * Dati di test inviati da Irelia
    * Dati di test ricevuti in Zapier
    * Azione configurata (Google Sheets, Slack o CRM)
    * Azione testata con successo
    * Zap impostato su ON
    * Zap rinominato con un nome descrittivo
  </Accordion>

  <Accordion title="Verifica" icon="circle-check">
    * Attivato un evento reale (o usato il pulsante **"Test"**)
    * Confermato che i dati sono apparsi nell'app di destinazione
    * Controllato che la Zap History mostri un'esecuzione riuscita
  </Accordion>
</AccordionGroup>

✅ **Tutto spuntato? Sei a posto!**

## 🛠️ Risoluzione dei problemi e FAQ

Niente panico! Ecco i problemi più comuni e come risolverli passo passo.

<AccordionGroup>
  <Accordion title={`❌ Problema 1: "Zapier dice 'Waiting for data' o 'No request found'"`} description={`Zapier non ha ancora ricevuto dati da Irelia`}>
    **Come risolverlo:**

    **Fase 1: Verifica l'URL webhook in Irelia**

    * Vai su Irelia → **"Events and Notifications"**
    * Controlla che l'URL webhook sia compilato per il tuo evento
    * Assicurati che corrisponda esattamente all'URL di Zapier (niente spazi extra)

    **Fase 2: Invia di nuovo i dati di test**

    * Clicca il pulsante blu **"Test"** in Irelia accanto all'URL del tuo webhook
    * Aspetta 5–10 secondi
    * Torna su Zapier e clicca di nuovo il pulsante **"Test trigger"**

    **Fase 3: Prova con un nuovo URL webhook**

    * Se ancora non funziona, modifica il trigger del tuo Zap e copia un nuovo URL webhook
    * Cancella il vecchio URL in Irelia e incolla quello nuovo
    * Clicca di nuovo **"Test"** in Irelia
  </Accordion>

  <Accordion title={`❌ Problema 2: "I dati appaiono in Zapier ma l'azione fallisce"`} description={`Irelia sta inviando i dati correttamente, ma c'è un problema con la configurazione della tua azione`}>
    **Come risolverlo:**

    **Fase 1: Leggi il messaggio di errore**

    * Zapier mostra messaggi di errore dettagliati in rosso
    * Cerca frasi come "Required field missing" o "Authentication failed"

    **Fase 2: Controlla i campi obbligatori**

    * Cerca i campi contrassegnati con un asterisco rosso (\*)
    * Assicurati che ogni campo obbligatorio abbia un dato mappato

    **Fase 3: Ricollega il tuo account**

    * Nella configurazione della tua azione, clicca **"Reconnect"** o il nome dell'account
    * Accedi di nuovo e concedi i permessi
    * Testa di nuovo l'azione

    **Fase 4: Verifica che la tua destinazione esista**

    * **Google Sheets:** Conferma che il foglio di calcolo non sia stato eliminato
    * **Slack:** Controlla che il canale non sia stato archiviato
    * **CRM:** Verifica che i valori di pipeline/stato esistano ancora
  </Accordion>

  <Accordion title={`❌ Problema 3: "Lo Zap viene eseguito ma non vedo il risultato"`} description={`Lo Zap dice che è andato a buon fine, ma non riesci a trovare i dati`}>
    **Come risolverlo:**

    **Fase 1: Controlla la Zap History per i dettagli**

    * Vai su Zapier → **"Zap History"**
    * Clicca sulla tua esecuzione recente per espandere i dettagli
    * Guarda **"Data Out"** per vedere esattamente cosa è stato inviato

    <Frame caption="Esecuzione espansa della Zap History che mostra i dettagli di Data Out">
      <img src="https://mintcdn.com/irelia/5BTgrUYIeAPG-OkV/images/Guida-Zapier-crm/32.png?fit=max&auto=format&n=5BTgrUYIeAPG-OkV&q=85&s=5b8a71f13a2e62355c2d1332b4b113e4" alt="Guida Irelia.ai all'integrazione con Zapier, Risoluzione dei problemi e FAQ, Problema 3 - Lo Zap viene eseguito ma non vedo il risultato. Esecuzione espansa della Zap History per uno Zap da Gravity Forms a Webhooks by Zapier, con la tab Data out selezionata sul passaggio POST in Webhooks by Zapier incorniciata in rosso, che mostra i campi Error true, Message Il tuo account è senza crediti e Phone Number. Questo mostra al lettore esattamente dove guardare nei dettagli di un'esecuzione per vedere quali dati sono stati effettivamente inviati." width="1920" height="874" data-path="images/Guida-Zapier-crm/32.png" />
    </Frame>

    **Fase 2: Cerca nel posto giusto**

    * **Google Sheets:** Scorri fino in fondo (le nuove righe vengono aggiunte alla fine). Prova Ctrl+F per cercare.
    * **Slack:** Verifica di essere nel canale giusto. Cerca i messaggi da "Zapier."
    * **CRM:** Cerca per numero di telefono anziché per nome. Controlla se stai vedendo una vista filtrata.

    **Fase 3: Controlla i filtri**

    * Torna all'editor del tuo Zap
    * Cerca eventuali passaggi Filter tra trigger e azione
    * Verifica che i tuoi dati superino le condizioni del filtro
  </Accordion>

  <Accordion title={`❌ Problema 4: "Lo Zap ha funzionato una volta ma poi si è fermato"`} description="La tua automazione ha funzionato durante i test ma ha smesso di funzionare per gli eventi reali">
    **Come risolverlo:**

    **Fase 1: Controlla se il tuo Zap è su ON**

    * Vai alla tua dashboard Zapier
    * Verifica che il tuo Zap mostri **"ON"** in verde
    * Se dice **"OFF"** o **"Paused"**, riattivalo

    **Fase 2: Controlla l'autenticazione**

    * Modifica il tuo Zap e cerca icone di avviso gialle
    * Ricollega le app che mostrano avvisi
    * Questo è particolarmente comune con gli account Google

    **Fase 3: Verifica la configurazione di Irelia**

    * Vai su Irelia → **"Events and Notifications"**
    * Conferma che l'URL webhook sia ancora presente

    **Fase 4: Controlla l'utilizzo dei task Zapier**

    * Vai su **"Account"** → **"Usage"**
    * I piani gratuiti hanno 100 task al mese
    * Se hai raggiunto il limite, fai l'upgrade o aspetta il reset
  </Accordion>

  <Accordion title={`❌ Problema 5: "Ottengo voci duplicate"`} description="Lo stesso contatto viene elaborato più volte">
    **Come risolverlo:**

    **Fase 1: Verifica i tuoi Zap**

    * Controlla tutti i tuoi Zap attivi
    * Cerca duplicati con lo stesso trigger
    * Disattiva o elimina gli Zap duplicati

    **Fase 2: Controlla la configurazione di Irelia**

    * Verifica che ogni evento abbia un URL webhook univoco
    * Se hai incollato lo stesso URL in più eventi, il problema è quello
  </Accordion>

  <Accordion title={`❌ Problema 6: "Le variabili personalizzate sono vuote"`} description={`Il campo customVariables è vuoto o non contiene i dati attesi`}>
    **Come risolverlo:**

    **Fase 1: Usa l'evento giusto**

    * "New Inbound Contact" si attiva **prima** della raccolta dati
    * Usa gli eventi "Data Gathered," "Goal Achieved," o "Lead Qualified" al suo posto se hai bisogno dei dati raccolti

    **Fase 2: Controlla gli indici delle variabili**

    * Le variabili personalizzate sono numerate nell'interfaccia Zapier
    * Assicurati di mappare l'indice corretto per ogni variabile

    **Fase 3: Testa con una conversazione completa**

    * Invece di usare il pulsante **"Test"**, fai una conversazione completa che arrivi alla fase di raccolta dati
    * Poi controlla se i dati fluiscono correttamente
  </Accordion>
</AccordionGroup>

<div id="need-help" />

<Card title="🆘 Hai bisogno di aiuto?" icon="life-ring">
  **Supporto Irelia.ai:**

  * Contatta il supporto nel gruppo WhatsApp di supporto prioritario o invia un'email a [info@irelia.ai](mailto:info@irelia.ai)
  * Includi: screenshot della tua configurazione, il messaggio di errore, e cosa ti aspettavi rispetto a cosa è successo

  **Supporto Zapier:**

  * Visita: help.zapier.com
  * Controlla: status.zapier.com per eventuali disservizi
</Card>
