> ## 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](/Guide-ita/Collega-i-Meta-Instant-Forms-ai-template-WhatsApp).
</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](/Guide-ita/Come-avviare-conversazioni-con-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](/Guide-ita/Come-creare-un-Template-WhatsApp-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">Facoltativo</Badge>
* Accesso al codice del tuo sito web (solo se vuoi incorporare il modulo sul tuo sito) <Badge color="gray" size="md" shape="pill">Facoltativo</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](/Guide-ita/Come-creare-un-Template-WhatsApp-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" 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" 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" 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" 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" 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](/Guide-ita/Collega-i-Meta-Instant-Forms-ai-template-WhatsApp) per acquisire lead direttamente dalle inserzioni Facebook e Instagram — senza bisogno di landing page
* **Ti servono messaggi attivati dal CRM?** Collega Irelia a [Zapier](/Guide-ita/Come-collegare-Irelia.ai-a-Zapier), [Make.com](/Guide-ita/Come-collegare-Irelia.ai-a-Make.com-usando-i-Webhook) o il tuo strumento di automazione preferito tramite l'[API/webhook di Irelia](/Guide-ita/Come-avviare-conversazioni-con-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?`}>
    **Risposta:**

    | 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?">
    **Risposta:** 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](/Guide-ita/Collega-i-Meta-Instant-Forms-ai-template-WhatsApp)** |
    | 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](/Guide-ita/Collega-i-Meta-Instant-Forms-ai-template-WhatsApp) 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](/Guide-ita/Come-avviare-conversazioni-con-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>