Come Collegare Irelia.ai a Go High Level Tramite Webhook

~20 minuti di configurazione

​

Introduzione

Hai creato il tuo Agent conversazionale su Irelia.ai, e sta già chattando con i potenziali clienti su WhatsApp, Facebook e Instagram. Ma cosa succede quando accade qualcosa di importante — come quando un lead viene qualificato, quando il tuo Agent raccoglie informazioni chiave, o quando qualcuno prenota un appuntamento? In questo momento, potresti star controllando manualmente la tua Dashboard di Irelia e copiando le informazioni nel tuo CRM Go High Level. C’è un modo migliore. Questa guida ti mostra come inviare automaticamente le informazioni da Irelia al tuo account GHL nell’istante in cui accade qualcosa di importante — nessun lavoro manuale, nessun ritardo, nessun controllo continuo della dashboard. Alla fine di questa guida, avrai: ✅ Un’automazione funzionante che si attiva quando accadono eventi specifici nelle tue conversazioni Irelia
✅ Dati che fluiscono automaticamente da Irelia al tuo CRM GHL, alle pipeline o ad altri strumenti collegati
✅ Le competenze per creare automazioni aggiuntive illimitate

​

Come funziona

Pensa a questa connessione come a un sistema di videocitofono smart: La magia: Tutto avviene automaticamente in pochi secondi. Nessun lavoro manuale. Nessun ritardo. Nessun controllo della dashboard.

​

📡 Di quali eventi può notificarti Irelia?

Mentre il tuo Agent AI chatta con i potenziali clienti, Irelia tiene traccia dei momenti importanti chiamati eventi — i “momenti che contano” nelle tue conversazioni. Ecco alcuni esempi di eventi Irelia: Quando un evento si attiva, Irelia confeziona tutte le informazioni rilevanti — dettagli del potenziale cliente, cronologia della conversazione, stato di qualificazione, dati personalizzati — e le invia a Go High Level istantaneamente. Per questa guida, userai “Nuovo contatto in entrata” perché è facile da attivare e perfetto per imparare. Una volta capito come funziona, potrai facilmente configurare altri eventi.

​

Cosa farai

🔗 Ottenere un URL webhook da Go High Level — 3 min
📋 Incollare l’URL in Irelia — 2 min
🧪 Inviare dati di test — 2 min
⚡ Configurare la tua azione (Aggiorna CRM, Google Sheets, ecc.) — 5 min
✅ Testare tutto end-to-end — 3 min
🚀 Attivare e dare un nome — 1 min Totale: ~15–20 minuti

​

📋 Cosa ti serve

• Un account Irelia.ai con almeno un Agent attivo Obbligatorio
• Un account Go High Level con accesso ai Workflow — Registrati qui se necessario Obbligatorio
• Una destinazione per i tuoi dati (CRM GHL, Google Sheets o Slack) Obbligatorio

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

​

🎯 Casi d’uso comuni

L’80% dei lettori ha bisogno di una di queste due configurazioni. Trova la tua, prendi nota delle indicazioni, poi segui la Configurazione passo dopo passo qui sotto — dovrai semplicemente fare selezioni diverse al Passaggio 2 e al Passaggio 4. Non trovi il tuo caso d’uso? Nessun problema — rivedi la tabella completa degli eventi e segui la guida usando “Nuovo contatto in entrata” come evento di apprendimento. Il processo è identico per ogni evento; cambiano solo le tue selezioni al Passaggio 2 e al Passaggio 4.

​

⚡ Percorso rapido (Utenti esperti)

Hai già dimestichezza con i Workflow di Go High Level? Ecco la versione condensata:

1. GHL: Vai su “Automation” → “Workflows” → Clicca sul pulsante “Create Workflow” → Aggiungi Trigger: “Inbound Webhook” → Copia l’URL del webhook
2. Irelia: Vai su “Settings” (Impostazioni) → Seleziona l’Agent → “Events and Notifications” (Eventi e Notifiche) → Incolla l’URL nel campo dell’evento desiderato
3. Test: Clicca il pulsante “Test” in Irelia → Torna su GHL → Verifica che i dati siano arrivati
4. Azione: Aggiungi la tua azione (Aggiorna Contatto, Aggiungi a Pipeline, ecc.) → Mappa i campi → Testa → Pubblica

Ti servono più dettagli? Continua con la guida completa qui sotto.

​

🔧 Configurazione passo dopo passo

​

Passaggio 1: Configura Go High Level per ricevere le notifiche di Irelia

~3 minuti In questo passaggio, creerai un nuovo Workflow in Go High Level e lo configurerai per ascoltare gli eventi provenienti da Irelia.

​

Naviga ai Workflow

1. Accedi al tuo account Go High Level
2. Seleziona il tuo sub-account (se applicabile)
3. Vai su “Automation” → “Workflows” nella barra laterale sinistra

​

Crea il tuo Workflow

1. Clicca sul pulsante “Create Workflow” (in alto a destra)
2. Seleziona “Start from Scratch” (o scegli un template vuoto)

​

Aggiungi il trigger webhook

1. Vedrai il builder del Workflow con un prompt “Add New Trigger”
2. Clicca su “Add New Trigger”
3. Nella casella di ricerca del trigger, digita webhook
4. Seleziona “Inbound Webhook”

​

Ottieni il tuo URL webhook

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

1. Dopo aver selezionato “Inbound Webhook”, GHL mostrerà un URL webhook
2. Apparirà come: https://services.leadconnectorhq.com/hooks/...
3. Clicca sull’icona “Copy” (Copia) accanto all’URL

​

Passaggio 2: Indica a Irelia dove inviare le notifiche

~2 minuti Ora accederai a Irelia e incollerai l’URL webhook che hai appena copiato. Il pannello webhook di Go High Level dovrebbe essere ancora aperto in un’altra scheda.

​

Contesto rapido: agent ed eventi

In Irelia, ogni Agent AI può avere le proprie automazioni. Per questa guida, configurerai un evento per un Agent. Una volta capito come funziona, potrai facilmente configurarne altri.

​

Accedi alle impostazioni del tuo Agent

1. Accedi alla dashboard impostazioni di Irelia.ai
2. Seleziona l’Agent che vuoi collegare a Go High Level

3. Naviga su “Events and Notifications” (Eventi e Notifiche)

​

Configura il tuo webhook

Vedrai un elenco di eventi disponibili

1. Trova “New inbound contact reaching out to us” (Nuovo contatto in entrata che ci scrive) (o l’evento che desideri configurare) nell’elenco
2. Clicca nel campo “URL” accanto a questo evento
3. Incolla l’URL webhook che hai copiato da Go High Level (l’URL si salverà automaticamente)

​

Passaggio 3: Testa la connessione e completa la configurazione GHL

~2 minuti Ora inviamo dati di test da Irelia e configuriamo Go High Level per riconoscere la struttura dei dati. Questo passaggio è fondamentale — GHL ha bisogno di ricevere dati campione prima che tu possa salvare e utilizzare il trigger webhook.

​

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 su “Test”
3. Dovresti vedere un indicatore verde di successo in Irelia con scritto “Just sent a data sample successfully”

​

Recupera e seleziona i dati campione in Go High Level

1. Torna alla scheda Go High Level (il pannello di configurazione webhook che hai lasciato aperto)
2. Clicca sul pulsante “Fetch Sample Requests”

3. GHL recupererà i dati di test che hai appena inviato da Irelia
4. Vedrai un elenco di payload in arrivo — seleziona il più recente (il payload che hai appena inviato)

5. GHL mostrerà ora tutti i campi dati ricevuti da Irelia

6. Clicca sul pulsante “Save Trigger” per completare la configurazione del webhook

​

📦 Capire cosa ti invia Irelia

Prima di configurare le azioni, prendiamoci 60 secondi per capire cosa Irelia ha appena inviato a Go High Level. Puoi suddividere concettualmente questi dati in tre categorie.

​

1. 👤 Chi sono (Informazioni di contatto)

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

​

2. 💬 Cosa è successo (Dettagli della conversazione)

Per agent — la specifica chat 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 — È qualificato da questo Agent? (“fit”, “not a fit” o “TBD”)
• interestScore — Quanto è interessato? (da 0.0 a 1.0, come da 0% a 100%)
• reasonNotQualified — Perché non si è qualificato (se applicabile)
• goalAchieved — Numero di obiettivi completati con questo Agent
• numberOfMessageSent — Messaggi inviati da questo Agent
• numberOfMessageReceived — Messaggi ricevuti dal potenziale cliente
• numberOfQuestionLackingData — Domande a cui l’AI non ha saputo rispondere dalla Knowledge Base
• creditConsumedForThisChat — Crediti utilizzati per questa conversazione

Complessivo (su tutti gli Agent):

• chatHistory — Cronologia completa della chat su tutti gli Agent
• optStatus — Stato di opt-in (es. “in”, “out”)
• creditConsumedForThisLead — Crediti totali consumati
• numberOfMessageSent — Messaggi totali inviati
• numberOfMessageReceived — Messaggi totali ricevuti
• numberOfQuestionLackingData — Domande totali senza risposta
• numberOfGoalAchieved — Obiettivi totali raggiunti

​

3. 📝 Cosa hai scoperto (Dati personalizzati)

customVariables — Informazioni specifiche raccolte dal tuo Agent (budget, dimensione azienda, tempistiche, ecc.) Ogni variabile personalizzata (chiamata custom variable nel testo, o customVariables nel payload API) ha:

• name — Di cosa hai chiesto (“Budget”)
• value — Risposta categorizzata (“$10k-50k”)
• valueRaw — Parole esatte usate (“Abbiamo circa 30k da spendere”)

​

Passaggio 4: Configura la tua azione

~5 minuti Ora arriva la parte divertente: decidere cosa deve succedere automaticamente quando Irelia invia dati a Go High Level.

​

Scegli la tua prima azione

Chiediti: “Quando qualcuno contatta il mio Agent per la prima volta, qual è la SINGOLA cosa più preziosa che dovrebbe succedere automaticamente?” Risposte comuni:

• ✅ Aggiornare il mio CRM → Create/Update Contact (nativo GHL, il più comune)
• ✅ Avvisare il mio team → Invia notifica interna o Slack (visibilità immediata)
• ✅ Registrare per i report → Google Sheets (tracking esterno)
• ✅ Avviare una sequenza → Aggiungi a Campaign o Workflow (inizia il processo di nurturing)

Il nostro consiglio per la tua prima automazione: Scegli “Create Contact” in GHL. Dato che stai già usando Go High Level, aggiornare il tuo CRM nativamente è l’opzione più fluida e offre valore immediato al tuo business. Una volta testata la connessione, puoi sempre aggiungere altre azioni. 👇 Qui sotto trovi istruzioni guidate per tre esempi.

​

Passaggio 5: Testa la tua automazione completa

~3 minuti Testiamo l’intero Workflow end-to-end per assicurarci che tutto funzioni correttamente.

​

Esegui il test

1. Nel builder del Workflow, clicca il pulsante “Test Workflow” (in alto a destra)

2. Seleziona un utente dal tuo CRM con cui eseguire il Workflow
3. Avvia il test

​

Verifica che abbia funzionato

Ora controlla la tua destinazione per confermare:

​

Passaggio 6: Attivala

~1 minuto

​

Pubblica il tuo Workflow

1. In alto a destra nel builder del Workflow, trova il toggle “Publish” (Pubblica)
2. Clicca per cambiare lo stato del Workflow a “Published”
3. Vedrai una conferma che il tuo Workflow è ora attivo

​

Dai un nome al tuo Workflow

1. Clicca sul nome del Workflow in alto (probabilmente dice qualcosa come “Untitled Workflow”)
2. Rinominalo con qualcosa di descrittivo come: Irelia: Nuovo Contatto → Aggiorna CRM

3. Clicca il pulsante “Save” (Salva)

​

🎉 Complimenti! Ce l’hai fatta!

Prenditi un momento per apprezzare quello che hai appena costruito: ✅ Il tuo Agent AI ora comunica con il tuo CRM Go High Level automaticamente
✅ I momenti importanti attivano azioni istantanee
✅ Niente più inserimento dati manuale o controllo delle dashboard — i tuoi sistemi sono sempre aggiornati
✅ I tuoi lead ricevono follow-up più veloci e migliori Cosa succede ora: Ogni volta che qualcuno contatta il tuo Agent Irelia per la prima volta → Irelia invia automaticamente le sue informazioni a Go High Level → GHL 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”, ripeti semplicemente i passaggi che hai appena completato e personalizza le azioni (Passaggio 4) per ottenere il risultato desiderato. Le tue opzioni da qui:

• 🎯 Vuoi tracciare un altro evento? Crea un nuovo Workflow e ripeti questa guida — seleziona semplicemente un evento diverso al Passaggio 2
• ➕ Vuoi che questo Workflow faccia più cose? Modifica il tuo Workflow e clicca il pulsante ”+” sotto la tua azione per aggiungerne altre
• 🤖 Hai un altro Agent da collegare? Ripeti questa guida per i tuoi altri Agent — ognuno può avere le proprie automazioni
• ⚡ Pronto per Workflow avanzati? Consulta la sezione Automazioni avanzate qui sotto

​

Monitorare la tua automazione

​

Controlla la cronologia del Workflow

1. Vai su “Automation” → “Workflows” nella barra laterale sinistra
2. Clicca sul tuo Workflow
3. Clicca sulla scheda “Enrollment History”
4. Qui puoi vedere ogni contatto che è entrato nel Workflow

Cerca:

• ✅ Finished (completato)
• ❌ Error (con dettagli)

Clicca su “View Execution History” su un contatto specifico per vedere i log di esecuzione (dettagli passo dopo passo di cosa è successo)

​

Cosa monitorare

Primi giorni: Controlla quotidianamente per assicurarti che i Workflow vengano eseguiti con successo e che i dati siano corretti. In seguito: GHL mostra gli errori dei Workflow nel tuo centro notifiche, quindi non devi controllare costantemente. Verifica solo che tutto funzioni durante i primi giorni.

​

🚀 Automazioni avanzate

Pronto a fare di più? Queste sezioni ti mostrano come costruire Workflow sofisticati che vanno oltre un singolo trigger e una singola azione.

​

Cercare e aggiornare record esistenti

Dato che l’azione “Create Contact” di GHL gestisce automaticamente la de-duplicazione in base al numero di telefono, sei già coperto per gli aggiornamenti base dei contatti. Tuttavia, per scenari più avanzati come aggiornare opportunità o fasi della pipeline, potrebbe servirti un approccio a due passaggi. Esempio: Aggiorna un’opportunità esistente quando un lead viene qualificato. Trigger: Lead Qualified Azioni:

1. Trova il contatto
   • Aggiungi azione: “Find Contact”
   • Imposta i criteri di ricerca su userNumber dal webhook
   • Questo trova il contatto corrispondente al numero di telefono del potenziale cliente
2. Aggiorna la sua opportunità
   • Aggiungi azione: “Update Opportunity”
   • Usa l’ID contatto dall’azione precedente
   • Aggiorna la fase della pipeline a “Qualified”
   • Aggiungi note con i dettagli della qualificazione

Risultato: Invece di creare nuovi record, lo stato della pipeline del tuo lead esistente viene aggiornato automaticamente.

​

Usare le condizioni per controllare quando le azioni vengono eseguite

Le condizioni ti permettono di aggiungere logica di ramificazione così che azioni diverse vengano eseguite in base ai valori dei dati. Esempio: Aggiungi alla pipeline “Hot Leads” solo se il budget del potenziale cliente è “$10k+” o superiore.

1. Nel tuo Workflow, clicca il pulsante ”+” tra il trigger e l’azione
2. Seleziona “If/Else” (o “Condition”)
3. Imposta la tua condizione: customVariables Value contains $10k
4. Aggiungi la tua azione “Update Pipeline” sotto il ramo “If Yes”
5. Aggiungi un’azione diversa (o nulla) sotto il ramo “If No”

Casi d’uso comuni delle condizioni:

• Aggiungi alla pipeline hot solo se il budget corrisponde al tuo target → customVariables Value equals $10k-50k
• Notifica il sales manager solo se la dimensione aziendale è “Enterprise” → customVariables Value contains Enterprise
• Invia al reparto vendite solo se il lead è qualificato → leadQualification equals “fit”

​

Workflow multi-step

Perché fare una cosa sola quando puoi farne diverse? Esempio: Quando un lead viene qualificato:

1. Aggiorna il contatto con il tag “Qualified”
2. Sposta l’opportunità alla fase “Qualified”
3. Invia notifica interna al team vendite
4. Aggiungi alla campagna di nurturing via email
5. Registra in Google Sheet per la reportistica

Come configurarlo:

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

​

Sfruttare la potenza nativa di Go High Level

GHL ha potenti funzionalità integrate che puoi attivare dal tuo webhook Irelia:

• 🔄 Create/Update Opportunity — Aggiungi lead alle pipeline automaticamente e aggiorna le fasi del deal in base al progresso della conversazione
• 👤 Assign to User — Instrada i lead a commerciali specifici in base a criteri, o usa l’assegnazione round-robin per una distribuzione equa
• ✅ Create Task — Genera task di follow-up per il tuo team con il contesto della conversazione da Irelia
• 🔔 Send Internal Notification — Avvisa i membri del team istantaneamente con i dettagli del lead e lo stato di qualificazione

​

Esempi di casi d’uso reali

​

Fast track per lead qualificati

Trigger: Lead Qualified Azioni:

1. Aggiorna il contatto con i tag “Qualified” e “AI-Qualified”
2. Crea opportunità nella pipeline “Hot Leads”
3. Invia notifica interna al team vendite via SMS
4. Aggiungi al Workflow di sequenza email “Hot Lead Welcome”
5. Registra in Google Sheet “Lead Qualificati” per la reportistica

Impatto: Il team vendite ingaggia i lead qualificati in minuti invece che in ore.

​

Nurturing per lead non qualificati

Trigger: Lead Disqualified Azioni:

1. Aggiorna il contatto con il tag “Nurture”
2. Aggiungi al Workflow di sequenza email di nurturing a lungo termine
3. Crea task per follow-up tra 3 mesi
4. Registra in Google Sheet “Lista Nurture”

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

​

Tracciamento lacune nella Knowledge Base

Trigger: Question Lacking Answer Azioni:

1. Invia notifica Slack al team contenuti con la domanda
2. Crea task in GHL per risposta manuale
3. Registra in Google Sheet “Lacune Knowledge Base” per la revisione

Impatto: Migliori continuamente le conoscenze della tua AI assicurandoti che nessuna domanda dei potenziali clienti resti senza risposta.

​

Flusso per obiettivo raggiunto

Trigger: Goal Achieved Azioni:

1. Aggiorna il contatto con il tag “Goal Completed” e campo personalizzato
2. Sposta l’opportunità alla fase successiva della pipeline
3. Invia SMS di conferma al potenziale cliente
4. Notifica l’account manager tramite notifica interna
5. Attiva il Workflow di sequenza email “Post-Goal”

Impatto: Rinforzo positivo istantaneo e percorso cliente senza interruzioni.

​

Cattura dati approfondita

Trigger: Data Gathered Azioni:

1. Aggiorna campi personalizzati del contatto (budget, tempistiche, dimensione azienda, punti critici)
2. Aggiungi tag appropriati in base alle risposte
3. Instrada alla pipeline specifica del segmento (Enterprise vs PMI)
4. Attiva email personalizzata in base alle risposte
5. Registra dati completi in Google Sheet per l’analisi

Impatto: Dati ricchi sui potenziali clienti fluiscono automaticamente; nessun inserimento manuale.

​

Suggerimenti finali

• 🎯 Parti semplice — Un evento, un’azione. Padroneggia quello prima di espandere.
• 🧪 Testa a fondo — Verifica sempre con dati reali prima di affidarti all’automazione.
• 📊 Monitora regolarmente — Controlla i log di esecuzione settimanalmente, specialmente all’inizio.
• 🔄 Itera — La tua prima automazione non deve essere perfetta. Perfezionala nel tempo.
• 🔗 Sfrutta la potenza di GHL — Usa pipeline, campagne e opportunità per massimizzare il valore.
• 🤝 Chiedi aiuto — Sia Irelia che Go High Level hanno ottimi team di supporto e community.

Ogni esperto di automazione ha iniziato con un semplice Workflow. Tu hai appena costruito il tuo. Le possibilità da qui sono infinite.

​

✅ Checklist rapida

Usala per verificare che la tua configurazione sia completa: ✅ Tutto spuntato? Sei pronto a partire!

​

🛠️ Risoluzione dei problemi e FAQ

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

---