> ## 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 Make.com usando i Webhook

> Collega i tuoi agent conversazionali Irelia.ai a Make.com tramite webhook — così ogni lead qualificato, dato raccolto o obiettivo completato fluisce automaticamente nel tuo CRM, nei fogli di calcolo o nella 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-duso-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, router 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 creato il tuo agent conversazionale AI su Irelia.ai, e sta già chattando con i potenziali clienti su [WhatsApp](/Guide-ita/Come-Collegare-WhatsApp-Business-a-Irelia.ai), [Facebook e Instagram](/Guide-ita/Come-collegare-Meta-Messenger-e-Instant-Forms). 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](/Guide-ita/Come-configurare-la-prenotazione-con-calendario-in-Irelia)?
In questo momento, probabilmente controlli manualmente la tua Dashboard Irelia e copi le informazioni negli altri strumenti. C'è un modo migliore.
Irelia traccia questi momenti importanti come **eventi** — i "momenti che contano" nelle tue conversazioni. Questa guida ti mostra come inviare automaticamente i dati degli eventi da Irelia agli altri strumenti aziendali nell'istante in cui accadono — nessun lavoro manuale, nessun ritardo, niente più controlli continui sulla dashboard.
**Alla fine di questa guida, avrai:**
✅ Un'automazione funzionante che si attiva quando specifici eventi accadono 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 infinite automazioni aggiuntive

### Come funziona

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

| Sistema videocitofono                                                                                                                      | La tua automazione                                                                                      |
| :----------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------ |
| 🏠 Succede qualcosa alla porta (suona il campanello, arriva un pacco)                                                                      | Il tuo agent AI ha un momento importante (lead qualificato, obiettivo raggiunto, dati raccolti)         |
| 📹 La videocamera cattura l'evento e invia le info                                                                                         | Il webhook di Irelia impacchetta i dettagli (chi, cosa, quando)                                         |
| 📱 Il tuo telefono riceve la notifica                                                                                                      | Make.com riceve i dati istantaneamente                                                                  |
| ⚡ Si attiva un'azione automatica (salva il video, avvisa la famiglia)                                                                      | Le tue app fanno il loro lavoro (aggiungi al CRM, invia messaggio Slack, aggiorna il foglio di calcolo) |
| **La magia:** tutto avviene automaticamente in pochi secondi. Nessun lavoro manuale. Nessun ritardo. Niente più controlli sulla dashboard. |                                                                                                         |

### Cosa farai

1. 🔗 **Ottenere un URL webhook da Make.com** — 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](/Guide-ita/Come-Funziona-Irelia.ai) con almeno un agent attivo <Badge color="orange" size="md" shape="pill">Obbligatorio</Badge>
* Un account Make.com (il piano gratuito va benissimo) — [Registrati qui](https://make.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 farlo.

## 🎯 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 qui sotto — dovrai solo fare selezioni diverse al [Passaggio 2](#passaggio-2-indica-a-irelia-dove-inviare-le-notifiche) e al [Passaggio 4](#passaggio-4-configura-la-tua-azione).

<Tabs>
  <Tab title="Lead qualificato / Obiettivo raggiunto">
    **Aggiornare il mio CRM o foglio di calcolo quando un lead si qualifica o un obiettivo viene completato**
    *Esempi: lead segnato come qualificato → aggiorna lo stato su HubSpot · appuntamento prenotato → registralo nel foglio · obiettivo completato → avvisa il team vendite*
    📡 **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 record esistenti](#cerca-e-aggiorna-record-esistenti) per il Passaggio 4.
    * **Il contatto è completamente nuovo** (non è ancora nel tuo sistema) → segui i Passaggi 1–6 così come sono scritti (Esempio A, B o C nel Passaggio 4).

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

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

  <Tab title="Dati raccolti">
    **Inviare i dati raccolti (budget, dimensione azienda, tempistiche, ecc.) al mio CRM o foglio di calcolo**
    *Esempi: l'agent raccoglie il budget → popola il campo CRM · dimensione azienda raccolta → aggiorna la riga del foglio · tempistiche catturate → 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 record esistenti](#cerca-e-aggiorna-record-esistenti) per il Passaggio 4.
    * **Il contatto è completamente nuovo** (non è ancora nel tuo sistema) → segui i Passaggi 1–6 così come sono scritti (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 usa Cerca e aggiorna per il Passaggio 4"]
    B -->|No| D["Segui i Passaggi 1-6 così come sono scritti"]
    ```
  </Tab>
</Tabs>

### 📡 Riferimento eventi disponibili

Il tuo agent AI traccia diversi tipi di eventi mentre chatta con i potenziali clienti. Ecco alcuni esempi di eventi di cui Irelia può notificarti:

| Evento                                                                                                                                                                                                                                  | Cosa significa                                                                 | Esempio d'uso                          |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------- | :------------------------------------- |
| 💬 **Nuovo contatto in entrata**                                                                                                                                                                                                        | Qualcuno ti scrive per primo                                                   | → Avvisa il team vendite               |
| 🎯 **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 potenziale cliente, cronologia della conversazione, stato di qualificazione, dati personalizzati — e le invia istantaneamente a Make.com. |                                                                                |                                        |

<Tip>
  **Non trovi il tuo caso d'uso?** Nessun problema — segui la guida usando "New Inbound Contact" come evento di apprendimento. Il processo è identico per ogni evento; cambiano solo le selezioni al Passaggio 2 e al Passaggio 4.
</Tip>

## ⚡ Percorso rapido (utenti esperti)

Già a tuo agio con Make.com? Ecco la versione condensata:

1. **Make.com:** Crea uno Scenario → Aggiungi un modulo: "Webhooks" → Seleziona "Custom webhook" → Crea il webhook → Copia l'URL
2. **Irelia:** Impostazioni → Seleziona l'Agent → Events and Notifications → Incolla l'URL nel campo dell'evento desiderato
3. **Test:** Clicca il pulsante "Test" in Irelia → Torna su Make.com → Verifica che la struttura dati sia stata determinata
4. **Azione:** Aggiungi il modulo azione → Mappa i campi → Esegui una volta → Attiva
   Hai bisogno di più dettagli? Continua con la guida completa qui sotto.

## 🔧 Configurazione passo dopo passo

### Passaggio 1: Configura Make.com 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="Make.com la chiama 'Scenario'">automazione</Tooltip> e la configurerai per ascoltare gli eventi di Irelia.
**Per questa guida, useremo "New Inbound Contact"** perché è facile da attivare e perfetto per imparare. Una volta che capisci come funziona, puoi facilmente configurare altri eventi.

#### Crea il tuo Scenario

1. Accedi al tuo account Make.com su [make.com](https://make.com)
2. Clicca sul pulsante **"Create a new scenario"** (Crea un nuovo scenario) (oppure l'icona **+** in alto a destra)

<Frame caption="Clicca 'Create a new scenario' per iniziare a costruire la tua automazione">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/37.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=5a2894c3a4f368e1d839dee6ad470e84" width="1920" height="874" data-path="images/Guida-Make-crm/37.png" />
</Frame>

3. Vedrai l'editor dello Scenario — un'area visuale dove costruirai la tua automazione

* Inizierai con un'area vuota che mostra una grande icona **+** al centro

#### Aggiungi il modulo webhook

4. Clicca l'icona **+** al centro dell'area
5. Apparirà una casella di ricerca — digita `webhooks`
6. Seleziona **"Webhooks"** dai risultati

<Frame caption="Cerca 'webhooks' e seleziona il modulo Webhooks">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/38.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=ba02b8d242cb9bb9a068ad1d51b78210" width="1920" height="874" data-path="images/Guida-Make-crm/38.png" />
</Frame>

7. Dalla lista dei trigger, seleziona **"Custom webhook"**

<Frame caption="Seleziona 'Custom webhook' come tipo di trigger">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/39.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=97bf9dd7398babb4077bd511cd657fa2" width="1920" height="874" data-path="images/Guida-Make-crm/39.png" />
</Frame>

#### Crea il tuo webhook e ottieni l'URL

8. Si aprirà un pannello di configurazione. Clicca **"Add"** per creare un nuovo webhook

<Frame caption="Clicca 'Add' per creare un nuovo endpoint webhook">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/40.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=09831aff6c2b11446d4fe2bce7ab3f8e" width="1920" height="874" data-path="images/Guida-Make-crm/40.png" />
</Frame>

9. Dai al tuo webhook un nome descrittivo (es. "Irelia - New Inbound Contact")
10. Lascia tutte le altre impostazioni ai valori predefiniti
11. Clicca **"Save"**

<Frame caption="Dai un nome al webhook e clicca Save per generare l'URL">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/41.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=b315a86386dee854963fa65d3f598b27" width="1920" height="874" data-path="images/Guida-Make-crm/41.png" />
</Frame>

12. Make.com genererà un URL webhook unico

* Ha un aspetto tipo: `https://hook.make.com/abc123xyz789...`

13. Clicca il pulsante **"Copy address to clipboard"** (Copia indirizzo negli appunti)

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

<Warning>
  **Tieni questa scheda di Make.com aperta esattamente come la vedi nell'immagine qui sotto!** Dovrai tornarci tra pochi minuti.
</Warning>

<Frame caption="Tieni aperta questa scheda — ci tornerai dopo aver configurato Irelia">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/42.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=990caa48240ce0417dec6cd19222fc5b" width="1920" height="874" data-path="images/Guida-Make-crm/42.png" />
</Frame>

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

<Badge color="blue" size="md" shape="pill" icon="clock">\~2 minuti</Badge>
Adesso accederai a Irelia e incollerai l'URL webhook che hai appena copiato.
In Irelia, **ogni agent AI può avere le proprie automazioni**. Per questa guida, configurerai UN evento per UN agent. Una volta che capisci come funziona, puoi facilmente configurarne altri.

#### Accedi alle impostazioni del tuo agent

1. Accedi alla dashboard delle impostazioni di Irelia.ai
2. Seleziona l'agent che vuoi collegare a Make.com

<Frame caption="Seleziona l'agent che vuoi collegare a Make.com">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/43.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=4e19726c482a233daef0e70249fb9f56" width="1920" height="874" data-path="images/Guida-Make-crm/43.png" />
</Frame>

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

<Frame caption="Apri la sezione Events and Notifications">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/44.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=5a366e59b5e75f515173586d4eb6d9aa" width="1920" height="874" data-path="images/Guida-Make-crm/44.png" />
</Frame>

#### Configura il tuo webhook

4. Vedrai una lista di eventi disponibili

<Frame caption="Tipi di eventi disponibili con campi URL per la configurazione webhook">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/45.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=3b0d629ba685605fd5879807c4442155" width="1920" height="874" data-path="images/Guida-Make-crm/45.png" />
</Frame>

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

<Tip>
  **Stai scegliendo l'evento giusto?** Se stai seguendo uno specifico [caso d'uso tra quelli sopra](#-casi-duso-comuni), seleziona l'evento indicato lì invece di "New Inbound Contact".
</Tip>

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

<Frame caption="Incolla l'URL webhook di Make.com nel campo URL dell'evento">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/46.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=e8e810d372fcfc28b24db94b82c40c86" width="1920" height="874" data-path="images/Guida-Make-crm/46.png" />
</Frame>

<Tip>
  **Hai bisogno di cambiare l'URL in futuro?** Se mai dovessi usare un nuovo URL webhook (hai cambiato Scenario, stai risolvendo un problema, ecc.), ti basta ottenere un nuovo URL da Make.com e incollarlo in Irelia. Il vecchio URL smetterà di funzionare e il nuovo entrerà in azione immediatamente.
</Tip>

<Check>
  **Operazione riuscita!** Questo evento ora invierà dati a Make.com ogni volta che qualcuno contatta per la prima volta questo agent.
</Check>

### Passaggio 3: Testa la connessione

<Badge color="blue" size="md" shape="pill" icon="clock">\~2 minuti</Badge>
Adesso verifichiamo che Irelia e Make.com 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 URL del webhook
2. Clicca **"Test"**
3. Dovresti vedere un indicatore verde di successo in Irelia 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/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/47.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=6f6585182a8f4c660e242570559642e2" width="1920" height="874" data-path="images/Guida-Make-crm/47.png" />
</Frame>

<Info>
  **Cosa è appena successo:** Irelia ha inviato dati di esempio a Make.com. Questi dati di esempio ti mostrano esattamente che tipo di informazioni Irelia invierà quando questo evento accadrà realmente in una conversazione.
</Info>

#### Verifica che Make.com abbia ricevuto i dati

4. Torna alla scheda di Make.com (quella che hai tenuto aperta)
5. Dovresti vedere un messaggio di successo: **"Successfully determined"** con un segno di spunta verde

<Frame caption="'Successfully determined' conferma che Make.com ha ricevuto i dati">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/48.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=0ad023d0d4766a4670f8cf056cf2b08c" width="1920" height="874" data-path="images/Guida-Make-crm/48.png" />
</Frame>

6. Clicca **"OK"** per chiudere il pannello di configurazione

<Info>
  **Cosa significa "Successfully determined":** Make.com ha analizzato i dati inviati da Irelia e ora ne comprende la struttura. Questo ti permette di usare qualsiasi campo dati nei passaggi successivi.
</Info>

<Check>
  **Fatto!** Irelia e Make.com sono collegati e comunicano tra loro.
</Check>

### Comprendere i dati che Irelia invia

Prima di configurare le azioni, prenditi 60 secondi per capire cosa Irelia ha appena inviato a Make.com.

<Frame caption="Tutti i campi dati disponibili dal webhook di Irelia">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/49.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=092fa31b471e64d69c7d35c5642f4c61" width="1920" height="874" data-path="images/Guida-Make-crm/49.png" />
</Frame>

Questi campi dati si dividono in tre categorie:
**1. 👤 Chi sono (Info contatto)**

* `userName` — Il nome del potenziale cliente
* `userNumber` — Il loro numero di telefono
* `inboundLead` — Hanno scritto loro per primi (`true`) o tu (`false`)?
  **2. 💬 Cosa è successo (Dettagli conversazione)**
  Per agent — la chat specifica che l'utente ha avuto con un agent specifico (nella sezione `conversationFlow`):
* `id` — Identificativo unico dell'agent
* `name` — Nome dell'agent conversazionale
* `chatHistory` — Trascrizione completa della conversazione con questo agent
* `leadQualification` — Sono qualificati da questo agent? (`"fit"`, `"not a fit"`, o `"TBD"`)
* `interestScore` — Quanto sono interessati? (da 0.0 a 1.0, come da 0% a 100%)
* `reasonNotQualified` — Perché non si sono qualificati (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](/Guide-ita/Come-addestrare-il-tuo-Agent-AI-con-la-Knowledge-Base-di-Irelia.ai)
* `creditConsumedForThisChat` — Crediti usati per questa conversazione
  Complessivo (tra tutti gli agent):
* `chatHistory` — Cronologia completa della chat tra tutti gli agent
* `optStatus` — Stato di 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 azienda, tempistiche, ecc.)
  Ogni variabile personalizzata ha:
* `name` — Su cosa hai chiesto ("Budget")
* `value` — Risposta categorizzata ("\$10k-50k")
* `valueRaw` — Le parole esatte usate dal potenziale cliente ("Abbiamo circa 30k da spendere")

<Frame caption="customVariables espanse che mostrano i campi name, value e valueRaw">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/50.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=85a89649fe4bf3b75ed3884c632fbb51" width="1920" height="874" data-path="images/Guida-Make-crm/50.png" />
</Frame>

<Info>
  **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.
</Info>

<Note>
  **Non tutti gli eventi inviano tutti i dati.** Il test che hai appena eseguito ti 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.
</Note>

### Passaggio 4: Configura la tua azione

<Badge color="blue" size="md" shape="pill" icon="clock">\~5 minuti</Badge>
Adesso arriva la parte divertente: decidere cosa deve succedere automaticamente quando Irelia invia dati a Make.com.

#### Scegli la tua prima azione

Chiediti: *"Quando qualcuno contatta il mio agent per la prima volta, qual è la SINGOLA cosa più preziosa che dovrebbe accadere automaticamente?"*
Risposte comuni:

* ✅ **Registralo subito** → Google Sheets (il più semplice, ottimo per testare)
* ✅ **Avvisa il mio team** → Slack (visibilità immediata)
* ✅ **Aggiungi al mio CRM** → HubSpot, Salesforce, Pipedrive (massimo valore aziendale)
* ✅ **Avvia 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 immediatamente quando la tua automazione funziona. Una volta testata la connessione, puoi sempre cambiare l'azione con qualcosa di più complesso.
  Qui sotto trovi istruzioni guidate per questi due esempi.

<Tip>
  Se vuoi creare automazioni più complesse o collegare strumenti aziendali diversi, ti consigliamo di cercare su YouTube il risultato esatto che vuoi ottenere (es. *"How to add a row in Google Sheets using Make.com"*).
</Tip>

<Tabs>
  <Tab title="Google Sheets">
    *Consigliato per chi è alla prima volta*

    1. Passa il mouse sul **lato destro del modulo webhook** finché non vedi apparire una piccola icona **+**
    2. Clicca l'icona **+** per aggiungere un nuovo modulo

    <Frame caption="Clicca l'icona + sul lato destro del modulo webhook">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/51.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=bd1237ce77aae1aba3e2dd6b45835c19" width="1920" height="874" data-path="images/Guida-Make-crm/51.png" />
    </Frame>

    3. Nella casella di ricerca, digita `Google Sheets`
    4. Seleziona **"Google Sheets"** dai risultati

    <Frame caption="Seleziona Google Sheets dalla lista delle app">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/52.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=cedea83137e067e3a57fcff46bbfaff2" width="1920" height="874" data-path="images/Guida-Make-crm/52.png" />
    </Frame>

    5. Dalla lista delle azioni, seleziona **"Add a Row"** (Aggiungi una riga)

    <Frame caption="Seleziona 'Add a Row' per registrare i dati dei lead nel tuo foglio di calcolo">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/53.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=cb14c5dd49c552aabc8e89541d75858d" width="1920" height="874" data-path="images/Guida-Make-crm/53.png" />
    </Frame>

    6. Clicca **"Add"** per collegare il tuo account Google (o seleziona una connessione esistente)
    7. Segui le istruzioni per accedere e concedere a Make.com l'accesso ai tuoi Google Sheets
    8. Seleziona il tuo **"Spreadsheet"** dal menu a tendina (o creane uno nuovo prima in Google Sheets)
    9. Seleziona il tuo **"Sheet"** (di solito "Sheet1")

    <Frame caption="Seleziona il foglio di calcolo e la scheda di destinazione">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/54.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=6f5fbef24615d36f7eeee81847eabfb7" width="1920" height="874" data-path="images/Guida-Make-crm/54.png" />
    </Frame>

    10. **Mappa i tuoi campi** — qui è dove dici a Make.com quali dati di Irelia vanno in quale colonna del foglio
        Make.com ti mostrerà tutte le colonne del tuo foglio di calcolo. Clicca in ogni campo e apparirà un pannello che mostra tutti i dati disponibili da Irelia. Clicca semplicemente sul dato che vuoi inserire.

    <Frame caption="Mappa i campi dati di Irelia alle colonne del tuo foglio di calcolo">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/55.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=6f1be90c317d85580866f6ae92dc50a5" width="1920" height="874" data-path="images/Guida-Make-crm/55.png" />
    </Frame>

    11. Clicca **"OK"** per salvare la configurazione del modulo
        **Vai al [Passaggio 5](#passaggio-5-testa-la-tua-automazione-completa) →**
  </Tab>

  <Tab title="Slack">
    *Ottimo per la visibilità del team*

    1. Clicca l'icona **+** sul lato destro del modulo webhook
    2. Cerca `Slack` e selezionalo
    3. Dalle azioni, scegli **"Send Message"**

    <Frame caption="Seleziona 'Send Message' dalla lista delle azioni Slack">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/56.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=082f39fc3fdbd1658b03d64dcc264d03" width="1920" height="874" data-path="images/Guida-Make-crm/56.png" />
    </Frame>

    4. Clicca **"Add"** per collegare il tuo workspace Slack
    5. Seleziona **"User"** e segui le istruzioni per autorizzare Make.com
    6. Seleziona il tuo **"Channel"** (es. #leads, #sales, #notifications)
    7. **Componi il testo del messaggio** cliccando nel campo di testo e inserendo i campi dati di Irelia

    <Frame caption="Costruisci il tuo messaggio di notifica usando i campi dati di Irelia">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/57.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=4f17b10e6bbbf50aa0760103a87b7ca0" width="1920" height="874" data-path="images/Guida-Make-crm/57.png" />
    </Frame>

    8. Clicca **"OK"** per salvare la configurazione del modulo
       **Vai al [Passaggio 5](#passaggio-5-testa-la-tua-automazione-completa) →**
  </Tab>

  <Tab title="CRM">
    *Massimo impatto aziendale*

    1. Clicca l'icona **+** sul lato destro del modulo webhook
    2. Cerca il tuo CRM (HubSpot, Salesforce, Pipedrive, ecc.)
    3. Scegli **"Create a Contact"** (la dicitura esatta varia a seconda del CRM)
    4. Collega il tuo account CRM
    5. Mappa i campi di Irelia ai campi del CRM
    6. Clicca **"OK"**
  </Tab>
</Tabs>

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

#### Esegui il test

1. In basso a sinistra nell'area di lavoro, clicca il pulsante **"Run once"** (Esegui una volta)

<Frame caption="Clicca 'Run once' per eseguire lo Scenario manualmente">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/58.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=198eab5ff784a8e88b0d5caf2a8e928d" width="1920" height="874" data-path="images/Guida-Make-crm/58.png" />
</Frame>

2. Make.com inizierà ad ascoltare. Vedrai **"Waiting for data..."** sul modulo webhook
3. Torna su Irelia e clicca di nuovo il pulsante **"Test"** per inviare dati freschi
4. Torna su Make.com — dovresti vedere i dati fluire attraverso entrambi i moduli

<Frame caption="Segni di spunta verdi su entrambi i moduli confermano l'elaborazione riuscita">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/59.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=16a4224aa6f5d3bf41d9a4e348073aac" width="1920" height="874" data-path="images/Guida-Make-crm/59.png" />
</Frame>

5. Ogni modulo mostrerà un numero (come "1") che indica quanti elementi sono stati elaborati
6. Clicca su qualsiasi modulo per vedere i dettagli di ciò che è stato elaborato

<Frame caption="Dettagli di esecuzione espansi che mostrano i dati Irelia elaborati">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/60.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=355c219c3791a4e2439df0fe2e506efa" width="1920" height="874" data-path="images/Guida-Make-crm/60.png" />
</Frame>

#### Verifica che abbia funzionato

Ora controlla la tua destinazione per confermare:

<Tabs>
  <Tab title="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 del lead di test aggiunta automaticamente">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/61.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=17f2ead3ebb9c5663c6183105184b224" width="1920" height="874" data-path="images/Guida-Make-crm/61.png" />
    </Frame>
  </Tab>

  <Tab title="Slack">
    * Apri Slack e vai al canale selezionato
    * Dovresti vedere il tuo messaggio formattato con i dati di test

    <Frame caption="Notifica automatica con i dati di test Irelia nel tuo canale Slack">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/62.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=a0ec5adbc442e0f86cdc3ab070487011" width="1920" height="874" data-path="images/Guida-Make-crm/62.png" />
    </Frame>
  </Tab>

  <Tab title="CRM">
    * Apri il tuo CRM e cerca il contatto di test
    * Verifica che i campi siano compilati correttamente
  </Tab>
</Tabs>

<Check>
  **Hai visto i tuoi dati nel posto giusto?** La tua automazione funziona!
</Check>

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

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

#### Attiva il tuo Scenario

1. In basso a sinistra nell'editor dello Scenario, trova l'interruttore (attualmente dice **"OFF"**)
2. Clicca l'interruttore per portare il tuo Scenario su **ON**

<Frame caption="Porta l'interruttore dello Scenario da OFF a ON per attivarlo">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/63.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=cfa94ce1b1aa661b9643792971ef9d96" width="1920" height="874" data-path="images/Guida-Make-crm/63.png" />
</Frame>

3. L'interruttore diventerà blu/viola e mostrerà **"ON"**

#### Dai un nome al tuo Scenario

4. Clicca sul nome dello Scenario in alto a sinistra (probabilmente dice **"New scenario"** o simile)
5. Rinominalo con qualcosa di descrittivo come: **"Irelia: New Contact → Google Sheet"**

<Frame caption="Rinomina il tuo Scenario per identificarlo facilmente">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/64.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=c61223c4c5970350fb1e2e4703ec7535" width="1920" height="874" data-path="images/Guida-Make-crm/64.png" />
</Frame>

6. Clicca il pulsante **"Save"** (icona del floppy disk) in basso nello schermo per salvare le modifiche

<Frame caption="Clicca l'icona di salvataggio per rendere permanente la configurazione del tuo Scenario">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/65.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=6309408ce02703a2843d1097cef8793e" width="1920" height="874" data-path="images/Guida-Make-crm/65.png" />
</Frame>

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

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

Prenditi un momento per apprezzare quello che hai appena costruito:
✅ Il tuo agent AI ora comunica con gli altri tuoi strumenti automaticamente<br />
✅ I momenti importanti attivano azioni istantanee<br />
✅ Niente più inserimento manuale di dati o controlli sulla dashboard — i tuoi sistemi sono sempre aggiornati<br />
✅ I tuoi lead ricevono un follow-up più rapido e migliore
**Cosa succede adesso:**
Ogni volta che qualcuno contatta il tuo agent Irelia per la prima volta → Irelia invia automaticamente le sue informazioni a Make.com → Make.com esegue immediatamente la tua azione → Tutto senza che tu muova un dito.

### Prossimi passi

Ora che hai un'automazione funzionante, le possibilità sono infinite.
Se vuoi collegare altri eventi come "Data Gathered", "Lead Qualified" o "Goal Achieved", ti basta ripetere i passaggi e personalizzare le azioni (Passaggio 4) per ottenere il risultato desiderato.
**Le tue opzioni da qui:**

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

### Monitorare la tua automazione

#### Controlla la cronologia dello Scenario

1. Apri il tuo Scenario
2. Clicca sulla scheda **"History"** in alto nell'editor
3. Qui puoi vedere ogni volta che il tuo Scenario è stato eseguito:

* ✅ Successo (indicatori verdi)
* ❌ Errore (indicatori rossi con dettagli)

<Frame caption="Cronologia dello Scenario che mostra esecuzioni riuscite con indicatori verdi">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/66.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=2de01f3945bac20b2a599deaf74c6a3b" width="1920" height="874" data-path="images/Guida-Make-crm/66.png" />
</Frame>

4. Clicca su qualsiasi esecuzione per vedere informazioni dettagliate su cosa è successo

#### Cosa monitorare

**Primi giorni:** Controlla quotidianamente per assicurarti che gli Scenario vengano eseguiti con successo e che i dati siano corretti.
**Nel tempo:** Make.com può inviarti notifiche via email quando gli Scenario generano errori, quindi non devi controllare costantemente. Verifica solo che tutto funzioni durante i primi giorni.

<Tip>
  **Suggerimento pro:** Vai alle impostazioni del tuo Scenario (menu con i tre puntini → **"Settings"**) per configurare le notifiche di errore e le opzioni di programmazione.
</Tip>

## 🚀 Automazioni avanzate

### 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à nel tuo sistema.
Questo richiede un approccio in due fasi: **prima cerca, poi aggiorna.**
**Esempio:** Aggiornare la riga di un lead esistente quando viene qualificato
**Trigger:** Lead Qualified (webhook)
**Moduli:**

1. **Cerca la riga esistente**

* Aggiungi modulo: **"Google Sheets"** → **"Search Rows"**
* Imposta **"Search Column"** su "Phone"
* Imposta **"Search 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 modulo: **"Google Sheets"** → **"Update a Row"**
* Imposta **"Row Number"** sul numero di riga restituito dalla ricerca
* Mappa i campi che vuoi aggiornare (stato del lead, punteggio di interesse, ecc.)

<Frame caption="Configurazione a tre moduli: Webhook → Search Rows → Update a Row">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/69.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=27e1fdeefe01caeb4ad67ebd16baa714" width="1920" height="874" data-path="images/Guida-Make-crm/69.png" />
</Frame>

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

<Warning>
  **Il formato del numero di telefono deve corrispondere.** Perché la ricerca funzioni, il formato del numero di telefono nei tuoi record esistenti deve corrispondere al formato che Irelia invia. Irelia invia i numeri di telefono **con il prefisso internazionale** (es. `393401234567`). Se i tuoi record esistenti memorizzano i numeri **senza** prefisso (es. `3401234567`), la ricerca non troverà corrispondenze — perché `3401234567` e `393401234567` sono tecnicamente valori diversi. Salva i numeri di telefono con il prefisso internazionale nei tuoi fogli di calcolo e CRM. Se hai record esistenti senza prefisso, aggiornali per includere il prefisso.
</Warning>

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

### Usare i filtri per controllare quando le azioni si eseguono

I filtri ti permettono di aggiungere condizioni così la tua azione non si esegue per OGNI evento.
**Esempio:** Aggiungere al CRM solo se il budget del potenziale cliente è "\$10k-50k" o superiore

1. Clicca con il tasto destro sulla linea di connessione tra il modulo webhook e il modulo azione
2. Seleziona **"Set up a filter"**
3. Imposta la tua condizione:

* **Label:** "Budget Filter"
* **Condition:** `customVariables[].value` → **"Text operators: Contains"** → `$10k`

4. Clicca **"OK"**
5. Solo i lead che soddisfano questi criteri proseguiranno verso la tua azione

<Frame caption="Configurazione del filtro sul campo value delle customVariables">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/70.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=69cf2992b0bcf2a4e1c20585c652c569" width="1920" height="874" data-path="images/Guida-Make-crm/70.png" />
</Frame>

Il filtro appare come una piccola icona a imbuto sulla linea di connessione.

<Frame caption="L'icona a imbuto sulla linea di connessione indica un filtro attivo">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/71.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=bf0caf3260e0b108f1b2a2cc08e0d9d1" width="1920" height="874" data-path="images/Guida-Make-crm/71.png" />
</Frame>

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

* Aggiungere al CRM solo se il budget corrisponde al tuo target → `customVariables[].value` **equals** `$10k-50k`
* Avvisare il team solo se la dimensione aziendale è "Enterprise" → `customVariables[].value` **contains** `Enterprise`
* Inviare alle vendite solo se il lead è qualificato → `leadQualification` **equals** `fit`

<Tip>
  Usa il campo `value` (la risposta categorizzata) per i filtri piuttosto che `valueRaw` (le parole esatte). Il valore categorizzato è più consistente e affidabile per la corrispondenza delle condizioni.
</Tip>

### Scenario 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 vendite
3. Aggiungi al foglio Google "Hot Leads"
4. Invia email di benvenuto
   **Come configurarlo:**
5. Dopo il primo modulo azione, passa il mouse sul suo bordo destro e clicca l'icona **+**
6. Seleziona la seconda app e azione
7. Configura il modulo
8. Ripeti per le azioni aggiuntive

<Tip>
  I moduli si eseguono da sinistra a destra. Se un modulo precedente fallisce, quelli successivi non si eseguiranno a meno che tu non configuri la gestione degli errori. Metti la tua azione più critica per prima.
</Tip>

### Usare i router per la logica condizionale

I router ti permettono di creare logica ramificata basata sui dati — simile ai "Paths" in altri strumenti di automazione.
**Esempio:** Instradare i lead in base allo stato di qualificazione

* **Se** `leadQualification` è uguale a `"fit"` → **Percorso 1:** Aggiungi a HubSpot + Avvisa le vendite
* **Altrimenti se** `leadQualification` è uguale a `"not a fit"` → **Percorso 2:** Aggiungi a campagna di nurturing
* **Altrimenti** (`"TBD"`) → **Percorso 3:** Aggiungi al foglio "Da revisionare"
  **Come configurarlo:**

1. Dopo il modulo webhook, clicca l'icona **+**
2. Cerca e seleziona **"Router"** (sotto Flow Control o Tools)
3. Il Router mostrerà percorsi di output multipli
4. Clicca **+** su ogni percorso per aggiungere moduli
5. Configura i filtri sulla connessione di ogni percorso per controllare quali dati vanno dove

<Frame caption="Modulo Router con tre percorsi di output per l'instradamento condizionale dei lead">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/72.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=2bd99315f54595fbf36eda4e03ad79c8" width="1920" height="874" data-path="images/Guida-Make-crm/72.png" />
</Frame>

### Usare gli strumenti integrati per la trasformazione dei dati

Make.com ha funzioni integrate che ti permettono di trasformare i dati prima di inviarli:

* 🔢 **Formattare i numeri di telefono** in modo consistente (aggiungere il prefisso internazionale)
* ✂️ **Dividere `userName`** in nome e cognome usando funzioni di testo
* 📊 **Convertire `interestScore`** da decimale (0.85) a percentuale (85%) usando funzioni matematiche
* 📅 **Cambiare i formati delle date** per farli corrispondere al tuo CRM usando funzioni data
  Per usarle, clicca in qualsiasi campo e poi clicca l'icona della funzione (ƒ) per accedere alle funzioni integrate di Make.com.

<Frame caption="Pannello di selezione funzioni per trasformare i dati prima dell'invio">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/74.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=db56f9a851be7add4e57a6af133983cc" width="1920" height="874" data-path="images/Guida-Make-crm/74.png" />
</Frame>

### Esempi di casi d'uso reali

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

**Trigger:** Lead Qualified
**Moduli:**

1. Crea contatto in HubSpot con stato "Hot Lead"
2. Invia notifica Slack al team vendite
3. Aggiungi al foglio Google "Qualified Leads"
4. Invia email di benvenuto tramite Gmail
   **Impatto:** Il team vendite ingaggia i lead qualificati in pochi minuti invece che ore.

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

**Trigger:** Lead Disqualified
**Moduli:**

1. Aggiungi alla campagna di nurturing Mailchimp
2. Registra nel foglio "Nurture Pipeline"
3. Crea task in Asana per 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

**Trigger:** Question Lacking Answer
**Moduli:**

1. Invia notifica Slack al team contenuti così possono rispondere manualmente tramite la [Dashboard Irelia](/Guide-ita/Il-Pannello-Chat)
2. Registra nel foglio "Lacune Knowledge Base"
   **Impatto:** Migliora continuamente la [Knowledge Base](/Guide-ita/Come-addestrare-il-tuo-Agent-AI-con-la-Knowledge-Base-di-Irelia.ai) del tuo agent AI.

#### Caso d'uso 4: Flusso per obiettivo raggiunto

**Trigger:** Goal Achieved
**Moduli:**

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 immediato e percorso cliente senza interruzioni.

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

**Trigger:** Data Gathered
**Moduli:**

1. Aggiorna il CRM con le variabili personalizzate (budget, tempistiche, dimensione azienda)
2. **Router** per aggiungere al foglio specifico del segmento (Enterprise vs. PMI)
3. Attiva email personalizzata basata sulle risposte
   **Impatto:** Dati ricchi sui potenziali clienti fluiscono automaticamente; nessun inserimento manuale.

### 💻 Suggerimenti specifici per Make.com

#### Scenario istantanei vs. programmati

Per gli Scenario attivati da webhook, Make.com li esegue **istantaneamente** quando riceve i dati. Tuttavia, puoi anche configurare controlli programmati se necessario.
Per verificare che il tuo Scenario si esegua istantaneamente:

1. Clicca il menu con i tre puntini → **"Scheduling"**
2. Assicurati che sia impostato per attivarsi tramite webhook

#### Operazioni e limiti

Make.com addebita in base alle **operazioni** (ogni esecuzione di un modulo = 1 operazione). Pianifica di conseguenza:

* Uno Scenario con 3 moduli usa 3 operazioni per ogni esecuzione
* Piano gratuito: \~1.000 operazioni/mese
* Monitora il tuo utilizzo nella dashboard

#### Gestione degli errori

Make.com ha potenti opzioni di gestione degli errori:

1. Clicca con il tasto destro su qualsiasi modulo → Seleziona **"Add error handler"**
2. Scegli come gestire i fallimenti (ignora, riprova, avvisa, ecc.)
3. Questo impedisce che un singolo fallimento blocchi l'intero Scenario

<Frame caption="Opzioni di gestione errori per controllare il comportamento dei moduli in caso di fallimento">
  <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/74.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=db56f9a851be7add4e57a6af133983cc" width="1920" height="874" data-path="images/Guida-Make-crm/74.png" />
</Frame>

### Suggerimenti finali

* 🎯 **Inizia semplice** — Un evento, un'azione. Padroneggia quello prima di espandere.
* 🧪 **Testa accuratamente** — Usa sempre **"Run once"** per verificare con dati reali prima di attivare.
* 📊 **Monitora regolarmente** — Controlla la cronologia dello Scenario settimanalmente, soprattutto all'inizio.
* 🔄 **Itera** — La tua prima automazione non deve essere perfetta. Perfeziona nel tempo.
* 💾 **Salva spesso** — Clicca l'icona di salvataggio dopo ogni modifica per evitare di perdere il lavoro.
* 🤝 **Chiedi aiuto** — Sia Irelia che Make.com hanno ottimi team di supporto e community.
  Ricorda: ogni esperto di automazione ha iniziato con un semplice Scenario. Tu hai appena costruito il tuo. Le possibilità da qui sono infinite. **Buona automazione! 🚀**

## ✅ Checklist rapida

Usala per verificare che la tua configurazione sia completa:

<AccordionGroup>
  <Accordion title="Configurazione essenziale" icon="list-check" defaultOpen={true}>
    * Webhook creato in Make.com
    * URL webhook copiato da Make.com
    * URL incollato in Irelia per l'evento scelto
    * Dati di test inviati da Irelia
    * Struttura dati determinata in Make.com (**"Successfully determined"**)
    * Modulo azione configurato (Google Sheets, Slack o CRM)
    * Test con **"Run once"** completato con successo
    * Scenario portato su ON
    * Scenario rinominato con un nome descrittivo
    * Scenario salvato
  </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 cronologia dello Scenario 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 esattamente.

<AccordionGroup>
  <Accordion title={`❌ Problema 1: "Make.com dice 'Waiting for data' e non succede nulla"`} description={`Make.com non ha ancora ricevuto dati da Irelia`}>
    **Come risolverlo:**
    **Step 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 Make.com (niente spazi extra)
      **Step 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 Make.com — il webhook dovrebbe mostrare **"Successfully determined"**
      **Step 3: Prova con un URL webhook nuovo**
    * Se ancora non funziona, clicca sul modulo webhook in Make.com
    * Crea un nuovo webhook con il pulsante **"Add"**
    * Copia il nuovo URL e incollalo in Irelia
    * Clicca di nuovo **"Test"** in Irelia
  </Accordion>

  <Accordion title={`❌ Problema 2: "I dati appaiono in Make.com ma l'azione fallisce"`} description={`Irelia sta inviando i dati correttamente, ma qualcosa non va nella configurazione del modulo azione`}>
    **Come risolverlo:**
    **Step 1: Leggi il messaggio di errore**

    * Clicca sul modulo che ha fallito (mostrato con un indicatore rosso)
    * Make.com mostra messaggi di errore dettagliati nei dettagli dell'esecuzione
    * Cerca frasi come "Required field missing" o "Invalid credentials"

    <Frame caption="Vista dettagliata dell'errore del modulo con informazioni diagnostiche chiave">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/67.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=6518f067cb675f6ee05708fab7909e8e" width="1920" height="874" data-path="images/Guida-Make-crm/67.png" />
    </Frame>

    **Step 2: Controlla i campi obbligatori**

    * Apri la configurazione del modulo azione
    * Cerca i campi contrassegnati come obbligatori
    * Assicurati che ogni campo obbligatorio abbia dei dati mappati
      **Step 3: Ricollega il tuo account**
    * Nel modulo azione, clicca sul menu a tendina della connessione
    * Seleziona **"Add"** per creare una nuova connessione
    * Accedi di nuovo e concedi i permessi
    * Esegui di nuovo il test con Run once
      **Step 4: Verifica che la destinazione esista**
    * Google Sheets: Conferma che il foglio di calcolo non sia stato eliminato o rinominato
    * 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 Scenario si esegue ma non vedo il risultato"`} description={`Lo Scenario dice che è riuscito, ma non riesci a trovare i dati`}>
    **Come risolverlo:**
    **Step 1: Controlla la cronologia dello Scenario per i dettagli**

    * Vai al tuo Scenario → scheda **"History"**
    * Clicca sulla tua esecuzione recente per espandere i dettagli
    * Guarda i dati di output di ogni modulo

    <Frame caption="Esecuzione espansa nella cronologia dello Scenario con dati di output da ogni modulo">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-Make-crm/68.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=98e67286f15d844bb9dd551093d7b831" width="1920" height="874" data-path="images/Guida-Make-crm/68.png" />
    </Frame>

    **Step 2: Cerca nel posto giusto**

    * **Google Sheets:** Scorri fino in fondo (le nuove righe vengono aggiunte alla fine). Prova Ctrl+F per cercare.
    * **Slack:** Controlla di essere nel canale giusto. Cerca messaggi da "Make."
    * **CRM:** Cerca per numero di telefono invece che per nome. Controlla se sei in una vista filtrata.
      **Step 3: Controlla i filtri**
    * Torna all'editor del tuo Scenario
    * Cerca eventuali moduli filtro (icone a imbuto) tra il webhook e l'azione
    * Clicca sul filtro per verificare che i tuoi dati soddisfino le condizioni
  </Accordion>

  <Accordion title={`❌ Problema 4: "Lo Scenario 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:**
    **Step 1: Controlla che il tuo Scenario sia su ON**

    * Apri il tuo Scenario
    * Guarda l'interruttore in basso a sinistra
    * Se mostra **"OFF"**, riaccendilo
      **Step 2: Controlla la programmazione**
    * Clicca il menu con i tre puntini → **"Settings"**
    * Assicurati che **"Scheduling"** sia impostato su **"Immediately"** (non programmato per orari specifici)
    * Per webhook in tempo reale, lo Scenario dovrebbe essere eseguito **"On demand"**
      **Step 3: Controlla l'autenticazione**
    * Cerca eventuali icone di avviso (⚠️) sui tuoi moduli
    * Ricollega le app che mostrano avvisi
    * Questo è particolarmente comune con gli account Google dopo il cambio password
      **Step 4: Verifica la configurazione di Irelia**
    * Vai su Irelia → **"Events and Notifications"**
    * Conferma che l'URL webhook sia ancora presente e corretto
      **Step 5: Controlla l'utilizzo delle operazioni Make.com**
    * Vai nella dashboard di Make.com → **"Organization"** → **"Operations"**
    * I piani gratuiti hanno operazioni limitate al mese
    * Se hai raggiunto il limite, fai un upgrade o aspetta il reset
  </Accordion>

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

    * Controlla tutti i tuoi Scenario attivi
    * Cerca duplicati con lo stesso trigger webhook
    * Disattiva o elimina gli Scenario duplicati
      **Step 2: Controlla la configurazione di Irelia**
    * Verifica che ogni evento abbia un URL webhook UNICO
    * Se hai incollato lo stesso URL in più eventi, quello è il problema
      **Step 3: Controlla i trigger multipli**
    * Nel tuo Scenario, assicurati di avere UN SOLO modulo webhook
    * Trigger multipli possono causare elaborazioni duplicate
  </Accordion>

  <Accordion title={`❌ Problema 6: "Le variabili personalizzate sono vuote"`} description={`Il campo customVariables è vuoto o non contiene i dati previsti`}>
    **Come risolverlo:**
    **Step 1: Usa l'evento giusto**

    * "New Inbound Contact" si attiva PRIMA della raccolta dati
    * Usa invece gli eventi "Data Gathered", "Goal Achieved" o "Lead Qualified" se hai bisogno dei dati raccolti
      **Step 2: Controlla gli indici delle variabili**
    * Le variabili personalizzate sono in un array (1, 2, 3, ecc.)
    * Assicurati di mappare l'indice corretto
    * Usa il selettore dati per navigare la struttura dell'array
      **Step 3: Testa con una conversazione completa**
    * Invece di usare il pulsante **"Test"**, fai una conversazione completa che arrivi alla 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 Make.com:**
  * Visita: [make.com/en/help](https://make.com/en/help)
  * Community: [community.make.com](https://community.make.com)
  * Controlla: [status.make.com](https://status.make.com) per eventuali interruzioni di servizio
</Card>