> ## 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 usare Irelia Forms per acquisire lead e avviare conversazioni WhatsApp

> Crea una landing page personalizzata con un modulo di contatto che invia automaticamente il tuo template WhatsApp a chiunque lo compili — senza API, senza automazioni, senza codice.

<Badge color="blue" size="md" shape="pill" icon="clock">\~10 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="Percorso rapido" icon="bolt" href="#-percorso-rapido-utenti-esperti">
    Passaggi sintetici per utenti esperti
  </Card>

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

  <Card title="Checklist rapida" icon="check" href="#-checklist-rapida">
    Verifica che tutto funzioni
  </Card>

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

***

### Introduzione

Hai costruito il tuo AI agent, scritto il template WhatsApp perfetto, e ha appena ricevuto l'approvazione. Ora vuoi iniziare a inviarlo a prospect reali. Ma come fai concretamente a ottenere i loro numeri di telefono e far partire quel primo messaggio in uscita?
Se hai già traffico in arrivo da landing page, campagne email, Google Ads o dal tuo sito — e non sei ancora pronto per usare l'API di Irelia o configurare strumenti di automazione esterni — **Irelia Forms è il modo più veloce per passare da "template approvato" a "prospect che ricevono messaggi WhatsApp."** In circa dieci minuti, non ore.
Irelia Forms ti permette di creare una semplice landing page personalizzabile con un modulo di contatto. Quando un prospect inserisce il suo nome e numero di telefono, Irelia invia automaticamente il tuo template WhatsApp — il primo messaggio in uscita che avvia una conversazione gestita interamente dal tuo AI agent. Nessun webhook, nessun Zapier, nessun Make.com, nessun codice.

<Note>
  Irelia Forms è ideale quando il tuo traffico proviene da fonti web come landing page, email marketing, Google Ads, codici QR o CTA sul sito. Se stai facendo **campagne pubblicitarie Meta** (Facebook o Instagram), l'approccio più rapido è l'integrazione nativa di Irelia con i Meta Instant Forms — che acquisisce lead direttamente dalle tue inserzioni e invia messaggi WhatsApp senza bisogno di una landing page. [Scopri come configurare i Meta Instant Forms qui](/it/Connect-Meta-Instant-Forms).
</Note>

**Alla fine di questa guida, avrai:**
✅ Una landing page attiva con un modulo di contatto collegato al tuo template WhatsApp<br />
✅ Pieno controllo sull'aspetto del modulo — titoli, colori, immagini e font<br />
✅ Un URL condivisibile su cui iniziare subito a dirigere traffico<br />
✅ L'opzione di incorporare il modulo sul tuo sito web, se preferisci

### Come funziona

Pensa a Irelia Forms come un ponte con un solo click tra il tuo traffico web e WhatsApp.
Ecco il percorso che vive un prospect:

1. Clicca un link nella tua email, annuncio, sito web o post social — e atterra sulla tua pagina Irelia Form (o sul tuo sito con il modulo incorporato)
2. Inserisce il suo nome e numero di telefono e clicca su invia
3. Irelia invia istantaneamente il template WhatsApp collegato — il primo messaggio in uscita
4. Il tuo AI agent prende in carico la conversazione da quel momento, qualificando e assistendo automaticamente il prospect
   Il concetto chiave: **ogni Irelia Form è collegato a esattamente un template WhatsApp** — una relazione uno a uno. Il modulo non esiste da solo; vive all'interno della configurazione di uno specifico template. Quando qualcuno invia il modulo, è *quel* template che viene spedito.
   Questo significa che se vuoi moduli diversi per offerte o campagne diverse, dovrai creare template WhatsApp separati, ciascuno con il proprio Irelia Form.

<Note>
  **Limite dei placeholder nel template:** Irelia Forms supporta template **senza placeholder o con un singolo placeholder `X`**. Se il tuo template include un placeholder `X`, verrà automaticamente compilato con il **nome** che il prospect inserisce nel modulo. Template con più placeholder (es. `X` e `X`) non sono supportati tramite Irelia Forms — usa l'[API o un'integrazione di automazione](/it/How-to-Start-Conversations-with-Irelia) per quelli.
</Note>

<Tip>
  **Più metodi di invio possono coesistere.** Attivare Irelia Forms non disabilita gli altri metodi. Puoi avere Irelia Forms attivo per il traffico della tua landing page mentre usi anche automazioni API o Meta Instant Forms per altri canali — tutti collegati allo stesso template.
</Tip>

### Cosa farai

1. **Selezionare Irelia Forms** per il tuo template WhatsApp approvato (\~2 minuti)
2. **Personalizzare il contenuto e lo stile** del tuo modulo (\~5 minuti)
3. **Salvare e pubblicare** il modulo (\~1 minuto)
4. **Condividere l'URL del modulo** o incorporarlo sul tuo sito web (\~2 minuti)

## 📋 Cosa ti serve

* Un account Irelia.ai con almeno un AI agent attivo <Badge color="orange" size="md" shape="pill">Obbligatorio</Badge>
* Un template WhatsApp approvato **con al massimo un placeholder** (`X`) — [scopri come crearne uno qui](/it/How-to-Create-a-WhatsApp-Template-in-Irelia) se non ne hai ancora uno <Badge color="orange" size="md" shape="pill">Obbligatorio</Badge>
* Crediti Irelia sufficienti per inviare messaggi in uscita (ogni invio del modulo consuma un credito) <Badge color="orange" size="md" shape="pill">Obbligatorio</Badge>
* Il copy della tua landing page pronto (titolo, sottotitolo, testo del pulsante) <Badge color="orange" size="md" shape="pill">Obbligatorio</Badge>
* Un logo o un'immagine da mostrare sul modulo <Badge color="gray" size="md" shape="pill">Opzionale</Badge>
* Accesso al codice del tuo sito web (solo se vuoi incorporare il modulo sul tuo sito) <Badge color="gray" size="md" shape="pill">Opzionale</Badge>
  **Non serve saper programmare per la configurazione base.** Se sai scrivere in campi di testo e cliccare un pulsante di salvataggio, puoi farcela. Incorporare il modulo sul tuo sito richiede di incollare un frammento di codice — e ti guideremo anche in quello.

## ⚡ Percorso rapido (utenti esperti)

Hai già dimestichezza con Irelia? Ecco la versione sintetica:

1. **Apri il tuo template approvato** → Nel popup **"Set up the sending of the WhatsApp template"** (Configura l'invio del template WhatsApp), clicca sulla scheda **"Irelia Forms"** sotto **"Configure form"**
2. **Crea il modulo** → Clicca il pulsante **"Create your Irelia form"** → Si apre una nuova scheda con l'editor del modulo
3. **Personalizza** → Compila la scheda **"Content"** (titolo, sottotitolo, immagine, testo del pulsante, footer, testo della pagina di ringraziamento) → Passa alla scheda **"Style"** (colore di sfondo, colore del pulsante, tipografia, font)
4. **Salva** → Clicca **"Save and update content"** e/o **"Save and update style"**
5. **Distribuisci** → Copia l'URL del modulo direttamente dalla scheda dell'editor, *oppure* torna al popup del template e clicca **"Copy Irelia Form URL"** o **"Copy the code to insert on your website"**
6. **Finalizza** → Clicca **"I completed the configuration"** nel popup del template
   Vuoi più dettagli? Continua con la guida completa qui sotto.

## 🔧 Configurazione passo dopo passo

<Steps>
  <Step title="Seleziona Irelia Forms come metodo di invio" id="step-1-select-irelia-forms">
    <Badge color="blue" size="md" shape="pill" icon="clock">\~2 minuti</Badge>
    Prima di poter creare un Irelia Form, ti serve un template WhatsApp approvato. Se non ne hai ancora creato uno, segui prima la nostra [guida alla creazione di un template WhatsApp](/it/How-to-Create-a-WhatsApp-Template-in-Irelia).

    1. Nella tua dashboard Irelia, vai ai tuoi template WhatsApp
    2. Clicca sul template approvato che vuoi collegare a un modulo
    3. Comparirà il popup **"Set up the sending of the WhatsApp template"**
       Vedrai i dettagli del tuo template sul lato sinistro — nome del template, stato di approvazione, anteprima del messaggio e l'AI agent associato. Sul lato destro troverai i metodi di invio disponibili.

    <Frame caption="Popup di invio del template con opzioni di automazione e configurazione del modulo">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-irelia-form/159.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=c3c28dc022fa8ed62f9eddaddf31aeae" alt="Guida Irelia.ai alla configurazione di Irelia Forms, Passaggio 1 — Seleziona Irelia Forms come metodo di invio. Lo screenshot mostra il popup Set up the sending of the WhatsApp template per il template Initial Outreach, con le opzioni Sending method sulla destra: una scheda Configure automation in alto, poi sotto Otherwise Configure form, la scheda Irelia Forms evidenziata in rosso accanto alla scheda Meta. Qui il lettore sceglie Irelia Forms invece di una piattaforma di automazione o di Meta Instant Forms." width="1920" height="874" data-path="images/Guida-irelia-form/159.png" />
    </Frame>

    4. Scorri verso il basso fino alla sezione **"Configure form"**
    5. Clicca sulla scheda **"Irelia Forms"**
       Il popup si aggiornerà mostrando la schermata **"Configure the landing page"** (Configura la landing page).

    <Frame caption="Schermata Configure the landing page con il pulsante Create your Irelia form">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-irelia-form/160.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=58e9e084c50636ab843e46f4e264679d" alt="Guida Irelia.ai alla configurazione di Irelia Forms, Passaggio 1 — Seleziona Irelia Forms come metodo di invio. Lo screenshot mostra la schermata Configure the landing page, che spiega che il modulo della landing page invierà automaticamente il messaggio WhatsApp una volta compilato, accanto al logo Irelia Forms e al pulsante blu Create your Irelia form sulla destra. Questa è la schermata da cui il lettore avvia per la prima volta l'editor del modulo." width="1920" height="874" data-path="images/Guida-irelia-form/160.png" />
    </Frame>

    6. Clicca il pulsante blu **"Create your Irelia form"**
       Si aprirà una nuova scheda del browser con l'editor di Irelia Forms — qui personalizzerai il tuo modulo.
  </Step>

  <Step title="Personalizza il tuo modulo" id="step-2-customize-form">
    <Badge color="blue" size="md" shape="pill" icon="clock">\~5 minuti</Badge>
    L'editor del modulo si apre in una nuova scheda. Vedrai un'**anteprima live** del modulo sul lato destro e una **barra laterale delle impostazioni** sulla sinistra con due schede: **"Content"** e **"Style"**.

    <Frame caption="Editor del modulo con la scheda Content, campi modificabili a sinistra e anteprima live a destra">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-irelia-form/161.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=b6c0f8f1cadfdc816ec92d08004123b6" alt="Guida Irelia.ai alla configurazione di Irelia Forms, Passaggio 2 — Personalizza il tuo modulo, contenuto. Lo screenshot mostra l'editor di Irelia Forms con la scheda Contenuto selezionata nella barra laterale sinistra, che elenca i campi Nome pagina, Testo headline, Testo sub-headline, Immagine, Testo pulsante, Testo in fondo e Testo headline dopo l'invio, sopra il pulsante Salva e aggiorna contenuto, accanto a un'anteprima live sulla destra con un campo Nome e un campo telefono italiano. Qui il lettore compila il titolo, il sottotitolo, l'immagine e il testo del pulsante che i prospect vedranno sulla landing page." width="1920" height="874" data-path="images/Guida-irelia-form/161.png" />
    </Frame>

    Ogni modifica che fai nella barra laterale aggiorna l'anteprima in tempo reale, così vedrai sempre esattamente quello che vedranno i tuoi prospect.

    <Note>
      La barra laterale di modifica è visibile solo quando sei loggato nell'account Irelia che possiede questo modulo. Chiunque altro visiti l'URL della pagina — come i tuoi prospect — vedrà solo la landing page pulita con il modulo.
    </Note>

    #### Personalizza il contenuto

    La scheda **"Content"** controlla tutto il testo e i media del tuo modulo. Ecco cosa fa ogni campo:

    | Campo                             | Cosa controlla                                      | Suggerimenti                                                                            |
    | :-------------------------------- | :-------------------------------------------------- | :-------------------------------------------------------------------------------------- |
    | **"Page name"**                   | Nome interno del modulo (solo per tuo riferimento)  | Usa qualcosa di descrittivo, come "Modulo Lead Promo Estiva"                            |
    | **"Headline text"**               | Il titolo grande e in grassetto in cima alla pagina | Mantienilo chiaro e focalizzato sui benefici (es. "Ottieni la tua consulenza gratuita") |
    | **"Sub-headline text"**           | Testo di supporto più piccolo sotto il titolo       | Aggiungi contesto o rafforza la tua proposta di valore                                  |
    | **"Image"**                       | Un'immagine opzionale mostrata sul modulo           | Carica il tuo logo, una foto prodotto o una grafica della campagna                      |
    | **"Button text"**                 | Il testo sul pulsante di invio                      | Usa un linguaggio orientato all'azione (es. "Inizia ora", "Prenota il mio posto")       |
    | **"Footer text"**                 | Testo mostrato sotto il modulo                      | Crea aspettativa sul messaggio WhatsApp che stanno per ricevere                         |
    | **"Thank-you page headline"**     | Titolo mostrato dopo l'invio riuscito               | Conferma l'azione e spiega cosa succederà                                               |
    | **"Thank-you page sub-headline"** | Testo di supporto nella pagina di ringraziamento    | Rafforza il messaggio che verranno contattati su WhatsApp a breve                       |

    <Tip>
      **Il testo del footer è la tua arma segreta.** Usalo per creare aspettativa e ridurre le resistenze. Qualcosa come: *"Dopo aver inviato questo modulo, riceverai un messaggio WhatsApp dal nostro assistente AI per aiutarti a trovare la soluzione perfetta."* Questo crea aspettative chiare, così i prospect non saranno sorpresi quando arriva il messaggio — e saranno più propensi a rispondere.
    </Tip>

    <Tip>
      **Non sottovalutare la pagina di ringraziamento.** Dopo l'invio, il prospect vede questa schermata di conferma. Usala per fare da ponte tra il modulo e WhatsApp — qualcosa come: *"Controlla il tuo WhatsApp! Ti abbiamo appena inviato un messaggio per iniziare."* Più chiara è l'istruzione, più alto sarà il tuo tasso di risposta.
    </Tip>

    #### Personalizza lo stile

    Clicca la scheda **"Style"** in cima alla barra laterale per controllare l'aspetto visivo del tuo modulo:

    | Impostazione                                       | Cosa controlla                                 |
    | :------------------------------------------------- | :--------------------------------------------- |
    | **"Background color"**                             | Il colore di sfondo dell'intera pagina         |
    | **"Button color"**                                 | Il colore di riempimento del pulsante di invio |
    | **"Headline"** — colore, dimensione (px), peso     | Tipografia del titolo principale               |
    | **"Sub-headline"** — colore, dimensione (px), peso | Tipografia del testo di supporto               |
    | **"Button text"** — colore, dimensione (px), peso  | Tipografia del testo del pulsante              |
    | **"Footer text"** — colore, dimensione (px), peso  | Tipografia del testo del footer                |
    | **"Font"**                                         | La famiglia di font usata in tutto il modulo   |

    <Frame caption="Scheda Style con selettori di colore, controlli tipografici e selettore del font">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-irelia-form/162.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=e4abe0494a9bab1c8fac7b7934e48a8a" alt="Guida Irelia.ai alla configurazione di Irelia Forms, Passaggio 2 — Personalizza il tuo modulo, stile. Lo screenshot mostra la scheda Stile dell'editor di Irelia Forms, con Colore sfondo, Colore pulsante impostato su blu, i controlli colore-grandezza-peso per headline, sub-headline, testo pulsante e testo in fondo, e un selettore Carattere, sopra il pulsante Salva e aggiorna stile, accanto all'anteprima live che mostra il pulsante blu Testo pulsante. Qui il lettore allinea i colori e la tipografia del modulo al proprio brand." width="1920" height="874" data-path="images/Guida-irelia-form/162.png" />
    </Frame>

    <Tip>
      **Allineati al tuo brand.** Usa i colori del tuo brand per lo sfondo e il pulsante, e scegli un font coerente con il tuo sito web. Se stai facendo inserzioni che portano a questo modulo, la coerenza visiva costruisce fiducia e migliora i tassi di conversione.
    </Tip>
  </Step>

  <Step title="Salva e pubblica il tuo modulo" id="step-3-save-publish">
    <Badge color="blue" size="md" shape="pill" icon="clock">\~1 minuto</Badge>
    Quando sei soddisfatto del tuo modulo:

    1. Nella scheda **"Content"**, clicca il pulsante **"Save and update content"** in fondo alla barra laterale
    2. Se hai fatto modifiche nella scheda **"Style"**, passa a quella scheda e clicca il pulsante **"Save and update style"**

    <Check>
      Il tuo modulo è ora online! L'URL nella barra degli indirizzi del tuo browser è l'URL pubblico del modulo — puoi già iniziare a indirizzare le persone lì.
    </Check>

    <Warning>
      Assicurati di salvare su **entrambe** le schede se hai modificato le impostazioni di entrambe. Contenuto e stile vengono salvati separatamente.
    </Warning>
  </Step>

  <Step title="Condividi il modulo o incorporalo sul tuo sito web" id="step-4-share-embed">
    <Badge color="blue" size="md" shape="pill" icon="clock">\~2 minuti</Badge>
    Hai due modi per mettere il tuo modulo davanti ai prospect. Scegli quello più adatto alla tua situazione — o usali entrambi.

    #### Opzione A: Usa l'URL del modulo Irelia ospitato (il più veloce)

    Il tuo modulo è già attivo e ospitato su irelia.ai. Per ottenere l'URL:

    * **Dalla scheda dell'editor:** Copia l'URL direttamente dalla barra degli indirizzi del tuo browser — quello è l'URL pubblico del modulo.
    * **Dal popup del template:** Torna alla scheda da cui hai iniziato e clicca il pulsante **"Copy Irelia Form URL"**.

    <Frame caption="Popup del template con i pulsanti Modify form, Copy URL e Copy embed code">
      <img src="https://mintcdn.com/irelia/ZUe_TIj6C2C75Jx6/images/Guida-irelia-form/163.png?fit=max&auto=format&n=ZUe_TIj6C2C75Jx6&q=85&s=b9809bbbae271cdb4607032c621ca1ac" alt="Guida Irelia.ai alla configurazione di Irelia Forms, Passaggio 4 — Condividi il modulo o incorporalo sul tuo sito web. Lo screenshot mostra la schermata Configure the landing page con tre pulsanti sulla destra sotto il logo Irelia Forms: il pulsante blu Modify form, Copy Irelia Form URL e Copy the code to insert on your website, accanto al pulsante I completed the configuration sulla sinistra. Qui il lettore recupera l'URL ospitato o il codice di incorporamento per iniziare a indirizzare traffico al modulo." width="1920" height="874" data-path="images/Guida-irelia-form/163.png" />
    </Frame>

    Condividi questo URL ovunque vuoi: campagne email, landing page di Google Ads, post sui social media, codici QR agli eventi, link in bio — qualsiasi canale web che genera traffico.
    Una volta terminato, clicca **"I completed the configuration"** in basso a sinistra nel popup del template per finalizzare.

    <Tip>
      **Questo è il modo più veloce per testare i messaggi in uscita.** Condividi il link, ricevi invii e il tuo AI agent avvia le conversazioni automaticamente. Nessun sito web necessario, nessuna configurazione tecnica.
    </Tip>

    #### Opzione B: Incorpora il modulo sul tuo sito web

    Se preferisci che il modulo appaia sul tuo dominio — per coerenza con il brand o per catturare i visitatori esistenti del tuo sito — puoi incorporarlo usando un frammento di codice.

    1. Torna alla scheda del popup del template
    2. Clicca il pulsante **"Copy the code to insert on your website"**
    3. Incolla questo codice in una pagina dedicata sul tuo sito web (istruzioni specifiche per piattaforma qui sotto)
    4. Una volta completata la configurazione, clicca **"I completed the configuration"** in basso a sinistra

    ##### Come funziona il codice di incorporamento

    Il codice di incorporamento è uno snippet `<script>` che crea un frame a schermo intero (iframe) che carica il tuo Irelia Form. Quando un visitatore apre la pagina, il modulo copre l'intero viewport — diventa l'unica cosa che vedono. Ecco una vista semplificata di come appare il codice:

    ```html theme={null}
    <script>
    window.onload = function() {
    var iframe = document.createElement('iframe');
    iframe.src = 'https://irelia.ai/form/YOUR-UNIQUE-FORM-ID';
    iframe.style.position = 'fixed';
    iframe.style.width = '100vw';
    iframe.style.height = '100vh';
    // ... additional styling to fill the page
    document.body.appendChild(iframe);
    }
    </script>
    ```

    Poiché il modulo occupa l'intera pagina, **dovresti posizionare questo codice in una pagina dedicata** — una creata appositamente per il modulo. Qualsiasi contenuto esistente su quella pagina sarà nascosto dietro il modulo una volta caricato.

    ##### Per qualsiasi sito web (accesso diretto all'HTML)

    Se tu o il tuo sviluppatore avete accesso diretto ai file HTML del vostro sito:

    1. Crea una nuova pagina HTML dedicata per il modulo (es. `get-started.html`)
    2. Incolla il codice di incorporamento dell'Irelia Form **appena prima** del tag di chiusura `</body>`
    3. Salva il file e caricalo sul tuo server
    4. Visita la pagina — dovresti vedere il tuo Irelia Form che riempie lo schermo

    <Tip>
      **Chiedi al tuo sviluppatore se non sei sicuro.** Condividi il codice di incorporamento con lui e digli: *"Mi serve questo su una pagina dedicata a /get-started (o simile)."* Lo configurerà in pochi minuti.
    </Tip>

    ##### Per WordPress (usando WPCode — consigliato)

    Poiché il codice di incorporamento è uno `<script>`, il modo più affidabile per aggiungerlo in WordPress è tramite il plugin gratuito **WPCode** — gestisce l'inserimento di script in modo pulito senza che vengano rimossi dai filtri di contenuto di WordPress.

    1. Nella tua dashboard WordPress, vai su **"Plugins"** → **"Add New"**
    2. Cerca `WPCode` e installa **"WPCode — Insert Headers and Footers + Custom Code Snippets"**
    3. Clicca **"Activate"**
    4. Nella barra laterale sinistra, vai su **"Code Snippets"** → **"+ Add Snippet"**
    5. Passa il mouse su **"Add Your Custom Code (New Snippet)"** e clicca il pulsante **"Use Snippet"**
    6. Dai allo snippet un nome descrittivo (es. `Irelia Form - Promo Estiva`)
    7. Nel menu a tendina **"Code Type"**, seleziona **"HTML Snippet"**
    8. Incolla il codice di incorporamento completo dell'Irelia Form (l'intero blocco `<script>...</script>`) nell'area dell'editor di codice
    9. Scorri verso il basso fino alla sezione **"Insertion"** e configuralo per caricarsi **solo sulla pagina specifica** dove vuoi il modulo — usa le regole di targeting delle pagine di WPCode per selezionare la tua pagina dedicata al modulo
    10. Attiva lo snippet su **"Active"** e clicca il pulsante **"Save Snippet"**

    <Warning>
      Seleziona **"HTML Snippet"** come tipo di codice — non "JavaScript Snippet." L'opzione HTML Snippet gestisce correttamente il tag `<script>` completo così com'è. L'opzione "JavaScript Snippet" avvolgerebbe il tuo codice in modo diverso e lo romperebbe.
    </Warning>

    <Tip>
      **Crea prima una pagina dedicata.** Prima di configurare lo snippet, crea una nuova pagina WordPress (es. "Inizia ora" o "Prenota una consulenza") — puoi lasciare il suo contenuto vuoto o minimale. Poi in WPCode, imposta lo snippet per caricarsi solo su quella pagina. Poiché il modulo copre l'intero viewport, considera di usare un template di pagina "Blank" o "Canvas" se il tuo tema ne offre uno — questo evita un breve flash dell'header del tuo sito prima che il modulo appaia.
    </Tip>

    ##### Per Wix

    1. Crea una nuova pagina nel tuo sito Wix per il modulo (es. "Inizia ora")
    2. Vai sulla tua **Wix Dashboard** → **"Settings"** → scorri fino ad **"Advanced"** → **"Custom Code"**
    3. Clicca il pulsante **"+ Add Custom Code"**
    4. Incolla il codice di incorporamento completo dell'Irelia Form nel campo del codice
    5. Dagli un nome (es. `Irelia Lead Form`)
    6. Sotto **"Add Code to Pages"**, seleziona **"Choose specific pages"** e scegli solo la tua pagina dedicata al modulo
    7. Sotto **"Place Code in"**, seleziona **"Body - end"**
    8. Clicca **"Apply"**

    <Note>
      Se non vedi l'opzione **"Custom Code"** nelle impostazioni di Wix, potresti aver bisogno di un piano Wix Premium. I piani gratuiti Wix hanno accesso limitato all'iniezione di codice personalizzato.
    </Note>

    ##### Per altre piattaforme (Squarespace, Shopify, Webflow, ecc.)

    Ogni piattaforma moderna ha un modo per aggiungere codice personalizzato a pagine specifiche. Il principio è lo stesso ovunque: **crea una pagina dedicata, poi inserisci lo script di incorporamento solo su quella pagina.**

    * **Squarespace:** Crea una nuova pagina → clicca l'**icona dell'ingranaggio** (Impostazioni pagina) → **"Advanced"** → incolla il codice nel campo **"Page Header Code Injection"**
    * **Shopify:** Vai su **"Online Store"** → **"Pages"** → crea una nuova pagina → usa una sezione **Custom Liquid** nel template della pagina, oppure vai su **"Themes"** → **"Edit Code"** e crea un template dedicato che includa lo script di incorporamento
    * **Webflow:** Crea una nuova pagina → **"Page Settings"** → **"Custom Code"** → incolla nel campo **"Before `</body>` tag"**

    <Tip>
      **Regola generale per qualsiasi piattaforma:** Cerca impostazioni chiamate "Custom Code," "Code Injection," o "Custom Scripts" a **livello di pagina**. Incolla l'intero codice di incorporamento `<script>...</script>` lì. Assicurati che il codice sia aggiunto a una pagina dedicata al modulo — non a livello dell'intero sito. Se non sei sicuro, cerca nella documentazione della tua piattaforma "add custom JavaScript to a page."
    </Tip>
  </Step>
</Steps>

***

### 🎉 Complimenti! Il tuo Irelia Form è online!

Ecco cosa hai appena configurato:
✅ Una landing page con il tuo brand che raccoglie nomi e numeri di telefono dei prospect<br />
✅ Un messaggio WhatsApp in uscita automatico che parte nell'istante in cui qualcuno invia il modulo<br />
✅ Il tuo AI agent pronto a gestire ogni conversazione — zero lavoro manuale richiesto<br />
✅ Un URL condivisibile (e opzionalmente, una versione incorporata sul tuo sito web)
**Ecco cosa succede adesso:**
Il prospect clicca il tuo link → atterra sul tuo modulo → inserisce nome e numero di telefono → clicca invia → Irelia invia istantaneamente il tuo template WhatsApp (il primo messaggio in uscita) → il tuo AI agent gestisce l'intera conversazione → ottieni lead qualificati in automatico.

### Prossimi passi

Ora che il tuo primo Irelia Form è online, ecco alcuni passi naturali da fare:

1. 📢 **Porta traffico al tuo modulo** — Condividi l'URL nelle tue campagne email, Google Ads, bio dei social media, codici QR agli eventi, CTA sul sito web, o ovunque il tuo pubblico sia già presente
2. 🎨 **Crea più moduli per campagne diverse** — Ogni template WhatsApp può avere il proprio Irelia Form con messaggi e stili diversi. Gestisci più campagne contemporaneamente
3. 🔗 **Aggiungi più metodi di invio per lo stesso template** — Irelia Forms gestisce il traffico web alla grande, ma puoi aggiungere metodi aggiuntivi per altri canali:

* **Fai inserzioni su Meta?** Configura l'integrazione nativa di Irelia con i [Meta Instant Forms](/it/Connect-Meta-Instant-Forms) per acquisire lead direttamente dalle inserzioni Facebook e Instagram — senza bisogno di landing page
* **Ti servono messaggi attivati dal CRM?** Collega Irelia a [Zapier](/it/How-to-Connect-Irelia.ai-to-Zapier), [Make.com](/it/How-to-Connect-Irelia.ai-to-Make.com-Using-Webhooks) o il tuo strumento di automazione preferito tramite l'[API/webhook di Irelia](/it/How-to-Start-Conversations-with-Irelia)
* Tutti i metodi funzionano in parallelo per lo stesso template — ognuno acquisisce lead da un canale diverso

4. 📊 **Monitora i tuoi risultati** — Tieni d'occhio la tua dashboard Irelia per monitorare le conversazioni in arrivo attivate dagli invii del modulo

## ✅ Checklist rapida

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

<AccordionGroup>
  <Accordion title="Template e configurazione del modulo" icon="list-check" defaultOpen={true}>
    * Template WhatsApp creato e approvato
    * Crediti Irelia sufficienti disponibili per inviare messaggi in uscita
    * **"Irelia Forms"** selezionato come metodo di invio nel popup del template
    * Irelia Form creato tramite il pulsante **"Create your Irelia form"**
    * Contenuto personalizzato — titolo, sottotitolo, testo del pulsante, footer, testo della pagina di ringraziamento
    * Stile personalizzato — colori, dimensioni dei font, famiglia di font in linea con il tuo brand
    * Contenuto salvato tramite **"Save and update content"**
    * Stile salvato tramite **"Save and update style"** (se lo stile è stato modificato)
  </Accordion>

  <Accordion title="Distribuzione" icon="paper-plane">
    * URL del modulo copiato e pronto per essere condiviso — OPPURE — codice di incorporamento incollato in una pagina dedicata sul tuo sito web
    * **"I completed the configuration"** cliccato nel popup del template
  </Accordion>

  <Accordion title="Verifica" icon="circle-check">
    * Testato il modulo inviandolo con il tuo numero di telefono
    * Ricevuto il messaggio del template WhatsApp sul tuo telefono
    * L'AI agent ha avviato correttamente la conversazione dopo la consegna del template
  </Accordion>
</AccordionGroup>

✅ **Tutto spuntato? Sei pronto per iniziare ad acquisire lead!**

## 🛠️ Risoluzione dei problemi e FAQ

<AccordionGroup>
  <Accordion title={`❌ Problema 1: "Ho inviato il modulo ma non ho ricevuto un messaggio WhatsApp"`} description="Qualcosa impedisce la consegna del template dopo l'invio del modulo">
    **Come risolvere:**
    **Passaggio 1: Controlla lo stato del tuo template**

    * Torna al tuo template in Irelia e verifica che mostri **"Approved"** (Approvato) — se il template è stato rifiutato o è ancora in attesa, nessun messaggio verrà inviato
      **Passaggio 2: Controlla i tuoi crediti Irelia**
    * Ogni invio del modulo che attiva un messaggio WhatsApp consuma un credito. Se i tuoi crediti sono esauriti, il modulo accetterà gli invii ma il messaggio non partirà. Controlla il saldo dei crediti nella tua dashboard Irelia e ricarica se necessario
      **Passaggio 3: Verifica il numero di telefono**
    * Assicurati che il numero di telefono sia stato inserito con il prefisso internazionale corretto (il modulo include un selettore del prefisso — verifica che sia stato impostato correttamente)
    * Conferma che il numero di telefono abbia un account WhatsApp attivo — i messaggi template possono essere consegnati solo a utenti WhatsApp
      **Passaggio 4: Aspetta un momento e riprova**
    * La consegna può occasionalmente richiedere qualche secondo. Aspetta 30 secondi e controlla di nuovo WhatsApp
    * Se ancora nulla, prova a inviare il modulo con un numero di telefono diverso per isolare il problema
  </Accordion>

  <Accordion title={`❌ Problema 2: "Il modulo incorporato non appare sulla mia pagina web"`} description={`Lo script di incorporamento non si carica o non si esegue sulla tua pagina`}>
    **Come risolvere:**
    **Passaggio 1: Verifica che il codice sia stato incollato correttamente**

    * Assicurati di aver incollato il blocco `<script>...</script>` **completo** — inclusi sia il tag di apertura `<script>` che quello di chiusura `</script>`
      **Passaggio 2: Controlla l'impostazione del tipo di codice**
    * Se usi WPCode su WordPress, verifica che il tipo di codice sia impostato su **"HTML Snippet"** — non "JavaScript Snippet" o "PHP Snippet"
    * Se usi un'altra piattaforma, assicurati che il campo di iniezione del codice supporti i tag script
      **Passaggio 3: Controlla eventuali conflitti**
    * Alcuni plugin di sicurezza o policy di sicurezza del contenuto possono bloccare gli script inline. Prova a disabilitare temporaneamente i plugin di sicurezza per testare
    * Apri la console sviluppatore del tuo browser (tasto destro → **"Inspect"** → scheda **"Console"**) e cerca messaggi di errore
  </Accordion>

  <Accordion title="Posso avere più Irelia Forms per lo stesso template WhatsApp?">
    No — ogni template WhatsApp è collegato a esattamente un Irelia Form (una relazione uno a uno). Se hai bisogno di moduli diversi con titoli, immagini o stili diversi per campagne diverse, crea template WhatsApp separati e costruisci un Irelia Form dedicato per ciascuno.
  </Accordion>

  <Accordion title="Posso usare Irelia Forms E altri metodi di invio per lo stesso template?">
    Sì! I metodi di invio sono indipendenti e funzionano in parallelo. Puoi avere un Irelia Form che acquisisce lead dal tuo sito web mentre i Meta Instant Forms acquisiscono lead dalle tue inserzioni Facebook e Zapier attiva messaggi dal tuo CRM — tutto per lo stesso template, tutto contemporaneamente.
  </Accordion>

  <Accordion title="Vedo la barra laterale di modifica quando visito l'URL del mio modulo — la vedranno anche i miei prospect?">
    No. La barra laterale di modifica appare solo quando sei loggato nell'account Irelia che possiede il modulo. Per vedere esattamente quello che vedranno i tuoi prospect, apri l'URL del modulo in una finestra del browser in incognito o privata — vedrai solo la landing page pulita con il modulo.
  </Accordion>

  <Accordion title="Posso modificare il mio modulo dopo averlo pubblicato?">
    Sì — in qualsiasi momento. Torna al popup **"Set up the sending of the WhatsApp template"** del tuo template, vai alla sezione Irelia Forms e clicca il pulsante **"Modify form"**. L'editor si aprirà in una nuova scheda. Fai le tue modifiche, clicca salva e gli aggiornamenti vanno online immediatamente. Non serve ricopiare l'URL o aggiornare il codice di incorporamento.
  </Accordion>

  <Accordion title={`Qual è la differenza tra usare l'URL ospitato e il codice di incorporamento?`}>
    | Opzione                                                                                                                                              | Ideale per                                                                        | Come funziona                                                                     |
    | :--------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------- |
    | **URL ospitato**                                                                                                                                     | Lancio rapido, campagne pubblicitarie, link email, condivisione social, codici QR | I prospect visitano una pagina ospitata su irelia.ai — nessun sito web necessario |
    | **Codice di incorporamento**                                                                                                                         | Coerenza del brand, traffico sul sito esistente, dominio personalizzato           | Il modulo si carica in un frame a pagina intera sul tuo dominio                   |
    | Entrambe le opzioni attivano lo stesso identico template WhatsApp. Scegli in base alle tue esigenze — puoi anche usarle entrambe contemporaneamente. |                                                                                   |                                                                                   |
  </Accordion>

  <Accordion title="Dovrei usare Irelia Forms o l'integrazione Meta Instant Forms?">
    Dipende da dove proviene il tuo traffico:

    | Fonte del traffico                                                                                                                                                                                                                                                                                     | Metodo migliore                                                         |
    | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------- |
    | Landing page, email, Google Ads, codici QR, CTA sul sito                                                                                                                                                                                                                                               | ✅ **Irelia Forms**                                                      |
    | Campagne pubblicitarie Facebook o Instagram                                                                                                                                                                                                                                                            | ✅ **[Integrazione Meta Instant Forms](/it/Connect-Meta-Instant-Forms)** |
    | Sia traffico web che inserzioni Meta                                                                                                                                                                                                                                                                   | ✅ Usa **entrambi** — funzionano in parallelo                            |
    | Irelia Forms acquisisce lead da qualsiasi fonte di traffico web. I [Meta Instant Forms](/it/Connect-Meta-Instant-Forms) acquisiscono lead direttamente dentro Facebook e Instagram senza che il prospect esca mai dall'app Meta. Se gestisci entrambi i tipi di campagne, configura entrambi i metodi. |                                                                         |
  </Accordion>

  <Accordion title="Perché dovrei usare Irelia Forms invece dell'API?">
    Irelia Forms è progettato per velocità e semplicità. È la scelta migliore quando vuoi:

    * Testare velocemente i messaggi WhatsApp in uscita senza alcuna configurazione tecnica
    * Lanciare una campagna in minuti anziché in ore
    * Evitare completamente di occuparti di API, webhook o piattaforme di automazione esterne
      Se in futuro hai bisogno di workflow più complessi — come attivare messaggi dal tuo CRM basati su logiche personalizzate — l'API e le [integrazioni di automazione](/it/How-to-Start-Conversations-with-Irelia) sono lì per te. Ma per portare prospect reali in conversazioni reali *velocemente*, Irelia Forms è la strada giusta.
  </Accordion>

  <Accordion title="Posso aggiungere più campi al modulo (come email o nome dell'azienda)?">
    Attualmente, Irelia Forms raccoglie due campi: **nome** e **numero di telefono**. Sono le informazioni essenziali necessarie per avviare una conversazione WhatsApp. Se hai bisogno di raccogliere informazioni aggiuntive, il tuo AI agent può ottenerle durante la conversazione WhatsApp stessa — è uno dei suoi punti di forza principali.
  </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 assistenza prioritaria o invia un'email a [info@irelia.ai](mailto:info@irelia.ai)
  * Includi: uno screenshot della configurazione del tuo modulo, il nome del template, il tuo saldo crediti attuale e una descrizione di cosa ti aspettavi rispetto a cosa è successo
</Card>