> ## 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.
\~20 minuti di configurazione
***
Prerequisiti prima di iniziare
Parti da qui, trova il tuo caso d'uso
Passaggi condensati per utenti esperti
Guida completa (Passaggi 1–6)
Filtri, router ed esempi reali
Verifica che la tua configurazione sia completa
Problemi comuni e soluzioni
***
### Introduzione
Hai creato il tuo agent conversazionale AI su Irelia.ai, 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 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
✅ Dati che fluiscono automaticamente da Irelia al tuo CRM, fogli di calcolo o chat del team
✅ 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](/it/How-Irelia.ai-Works) con almeno un agent attivo Obbligatorio
* Un account Make.com (il piano gratuito va benissimo) — [Registrati qui](https://make.com) se necessario Obbligatorio
* Una destinazione per i tuoi dati (Google Sheets, Slack o il tuo CRM) Obbligatorio
**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).
**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"]
```
**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.
**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"]
```
### 📡 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. | | |
**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.
## ⚡ 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
\~3 minuti
In questo passaggio, creerai una nuova automazione 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)
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
7. Dalla lista dei trigger, seleziona **"Custom webhook"**
#### Crea il tuo webhook e ottieni l'URL
8. Si aprirà un pannello di configurazione. Clicca **"Add"** per creare un nuovo webhook
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"**
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)
**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.
**Tieni questa scheda di Make.com aperta esattamente come la vedi nell'immagine qui sotto!** Dovrai tornarci tra pochi minuti.
### Passaggio 2: Indica a Irelia dove inviare le notifiche
\~2 minuti
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
3. Vai a **"Events and Notifications"** (Eventi e notifiche)
#### Configura il tuo webhook
4. Vedrai una lista di eventi disponibili
5. Trova **"New inbound contact reaching out to us"** (o l'evento che desideri configurare)
**Stai scegliendo l'evento giusto?** Se stai seguendo uno specifico [caso d'uso tra quelli sopra](#-casi-d%E2%80%99uso-comuni), seleziona l'evento indicato lì invece di "New Inbound Contact".
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)
**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.
**Operazione riuscita!** Questo evento ora invierà dati a Make.com ogni volta che qualcuno contatta per la prima volta questo agent.
### Passaggio 3: Testa la connessione
\~2 minuti
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"**
**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.
#### 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
6. Clicca **"OK"** per chiudere il pannello di configurazione
**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.
**Fatto!** Irelia e Make.com sono collegati e comunicano tra loro.
### Comprendere i dati che Irelia invia
Prima di configurare le azioni, prenditi 60 secondi per capire cosa Irelia ha appena inviato a Make.com.
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](/it/How-to-Train-Your-AI-Agent-with-the-Knowledge-Base-in-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")
**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.
**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.
### Passaggio 4: Configura la tua azione
\~5 minuti
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.
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"*).
*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
3. Nella casella di ricerca, digita `Google Sheets`
4. Seleziona **"Google Sheets"** dai risultati
5. Dalla lista delle azioni, seleziona **"Add a Row"** (Aggiungi una riga)
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")
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.
11. Clicca **"OK"** per salvare la configurazione del modulo
**Vai al [Passaggio 5](#passaggio-5-testa-la-tua-automazione-completa) →**
*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"**
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
8. Clicca **"OK"** per salvare la configurazione del modulo
**Vai al [Passaggio 5](#passaggio-5-testa-la-tua-automazione-completa) →**
*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"**
### Passaggio 5: Testa la tua automazione completa
\~3 minuti
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)
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
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
#### Verifica che abbia funzionato
Ora controlla la tua destinazione per confermare:
* 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.
* Apri Slack e vai al canale selezionato
* Dovresti vedere il tuo messaggio formattato con i dati di test
* Apri il tuo CRM e cerca il contatto di test
* Verifica che i campi siano compilati correttamente
**Hai visto i tuoi dati nel posto giusto?** La tua automazione funziona!
### Passaggio 6: Attiva e dai un nome al tuo Scenario
\~1 minuto
#### 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**
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"**
6. Clicca il pulsante **"Save"** (icona del floppy disk) in basso nello schermo per salvare le modifiche
**La tua automazione è ora attiva!**
### 🎉 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
✅ I momenti importanti attivano azioni istantanee
✅ Niente più inserimento manuale di dati o controlli sulla dashboard — i tuoi sistemi sono sempre aggiornati
✅ 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)
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.
**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.
## 🚀 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.)
**Risultato:** Invece di creare righe duplicate, le informazioni del tuo lead esistente vengono aggiornate sul posto.
**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.
**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.
### 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
Il filtro appare come una piccola icona a imbuto sulla linea di connessione.
**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`
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.
### 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
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.
### 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
### 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.
### 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](/it/the-Chat-Panel)
2. Registra nel foglio "Lacune Knowledge Base"
**Impatto:** Migliora continuamente la [Knowledge Base](/it/How-to-Train-Your-AI-Agent-with-the-Knowledge-Base-in-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
### 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:
* 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
* 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
✅ **Tutto spuntato? Sei a posto!**
## 🛠️ Risoluzione dei problemi e FAQ
Niente panico! Ecco i problemi più comuni e come risolverli esattamente.
**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
**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"
**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
**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
**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
**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
**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
**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
**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