# Moduli per lead

Un modulo per lead raccoglie le richieste e decide cosa succede a ciascuna. Crei le domande una volta, scegli se un agent chiama i nuovi lead e quale, poi pubblichi lo stesso modulo su più canali: un link o un modulo incorporato nel tuo sito, il modulo che il tuo sito ha già, e i moduli per lead di Facebook / Instagram, Google Ads, LinkedIn e TikTok. Ogni lead viene salvato come contatto e, con la chiamata attiva, l'agent lo richiama in pochi secondi.

La pagina è **Lead forms** nella barra laterale dell'app, subito sotto **Integrations**. Ogni modulo ha la sua richiamata (attiva o no, l'agent, le istruzioni per quella chiamata) e i suoi canali: due moduli possono quindi essere richiamati da due agent diversi con istruzioni diverse.

  <ShotPlaceholder
    src="/assets/integrations/lead-forms.png"
    name="lead-forms-list"
    alt="Elenco dei moduli per lead con il modulo Default"
    capture="Sidebar Lead forms, list with at least two forms, one marked Default."
  />
  <ShotPlaceholder
    src="/assets/integrations/lead-forms-channels.png"
    name="lead-forms-channels"
    alt="Editor del modulo nella scheda Channels"
    capture="Lead form editor, Channels tab with Your website and the Facebook and Google Ads cards."
  />

## Cosa ti serve prima di iniziare

- Un agent che faccia le richiamate. Vedi [Il tuo primo agent](https://docs.voicelogica.ai/it/getting-started/your-first-agent/).
- Una linea che effettui chiamate in uscita. Le richiamate ai lead sono chiamate in uscita e usano i tuoi minuti.
- Per le piattaforme pubblicitarie: la pagina Facebook o l'account Google Ads, LinkedIn o TikTok delle tue inserzioni per lead, collegato in **Integrations**. Una scheda di canale non ancora collegata mostra **Connect**, che ti porta lì.

## Le schede dell'editor

- **Fields** — Le domande in ordine, con anteprima dal vivo. Il modulo deve avere una domanda telefono o email; aggiungi il telefono se un agent deve chiamare. Tienilo breve: ogni domanda in più fa perdere invii.
- **Call** — **Call new leads automatically**, l'**Agent** che chiama e **What the agent should say** in quella chiamata. L'agent sa già cosa ha compilato la persona e da quale canale e campagna è arrivata: scrivi come comportarsi, non i dati.
- **Channels** — Dove il modulo raccoglie lead: **Your website** (link, codice da incorporare o il tuo modulo) e una scheda per piattaforma con **Create on Facebook**, **Create on Google Ads** o **Link existing form**.
- **After submit** — Il messaggio di ringraziamento, o una pagina a cui mandare il visitatore.
- **Workflow** — Il workflow **New lead** del modulo: un'email o un SMS al tuo team, un aggiornamento del CRM, un follow-up.
- **Leads** — Ogni lead ricevuto dal modulo su qualsiasi canale, le sue risposte e se l'agent ha chiamato: **Received**, **Called** o **Failed** con il motivo.

## Prima configurazione

1. **Lead forms - New form - Fields**

   Dai un nome al modulo, aggiungi le domande e includine una per il telefono. Controlla l'anteprima e salva.

2. **Scheda Call**

   Attiva **Call new leads automatically**, scegli l'**Agent** e scrivi **What the agent should say**: cosa chiedere, cosa proporre, come chiudere. Se lo lasci vuoto vale il prompt dell'agent stesso. Le chiamate partono pochi secondi dopo l'invio, anche nel fine settimana, tra le 09:00 e le 21:00; un lead arrivato di notte viene chiamato appena si apre questa fascia.

3. **Scheda Channels - Your website**

   Copia **Link to share** per un pulsante o un messaggio, oppure **Snippet for your website** e incollalo dove deve comparire il modulo.

   Hai già un modulo di contatto (Elementor, WPForms, Typeform, Zapier)? Scegli **My own form** e imposta il tuo modulo perché invii ogni compilazione a **URL for your form**. Attiva **Test mode** e invia il tuo modulo una volta: per 15 minuti nessuno viene chiamato e **Fields we receive** mostra quale campo è il telefono, il nome e l'email. Correggi quelli finiti nel posto sbagliato e salva.

4. **Scheda Channels - piattaforme pubblicitarie**

   Scegli una strada per piattaforma:

   - **Create on Facebook** crea l'Instant Form di Facebook e Instagram da questo modulo, sulla **Facebook Page** e nella **Form language** che scegli. Nome, telefono ed email sono precompilati dal profilo della persona, ogni altra domanda diventa personalizzata. Puoi modificare **Headline** e **Description** dell'introduzione, e Facebook chiede una volta **Your privacy policy URL**.
   - **Create on Google Ads**: prima **Sign in with Google** con l'account che gestisce le tue inserzioni e scegli l'account pubblicitario. Il pannello mostra i testi, quali domande Google non può porre, e ti permette di collegare il modulo a una campagna. Il nuovo modulo invia già i suoi lead a Voice Logica.
   - **Create on TikTok** apre l'editor di Instant Form di TikTok stesso in una finestra qui, per l'account pubblicitario che scegli. Crea e pubblica lì il modulo; quando chiudi l'editor, il nuovo modulo viene collegato a questo modulo.
   - **Link existing form** per un modulo che hai già creato sulla piattaforma. Facebook, TikTok e Google Ads (dopo l'accesso) elencano i loro moduli tra cui scegliere. Per LinkedIn usa **Enter ID manually** e incolla l'ID del modulo dalla piattaforma. **Every form not linked to another form** prende tutti i moduli della piattaforma che nessun altro modulo per lead rivendica.

5. **Scheda Workflow** (facoltativo)

   **Create workflow** crea il workflow **New lead** di questo modulo. Aggiungi un passaggio email o SMS perché qualcuno venga avvisato di ogni lead, poi salva. Vedi [Workflows](https://docs.voicelogica.ai/it/workflows/).

6. **Verifica**

   Invia tu stesso il modulo con il tuo cellulare. Il lead compare nella scheda **Leads** come **Received**, l'agent ti chiama in pochi secondi e il lead passa a **Called**. Apri la chiamata dal lead per ascoltarla.

## Il modulo Default

Il modulo segnato **Default** gestisce ogni lead che nessun altro modulo rivendica, per esempio un nuovo modulo Facebook non ancora collegato. Imposta anche la sua scheda **Call**, così quei lead non restano senza richiamata. Non si può eliminare.

Un modulo di piattaforma appartiene a un solo modulo per lead alla volta: collegarlo a un altro lo sposta, e **Unlink** rimanda i suoi lead al modulo Default.

## Da Claude o ChatGPT

Con [Claude o ChatGPT collegato](https://docs.voicelogica.ai/it/integrations/claude-chatgpt/) basta chiederlo, per esempio: «Crea un modulo per lead con nome, telefono e quale servizio vogliono, fai chiamare ogni lead da Maria e pubblicalo sulla nostra pagina Facebook». L'assistente usa questi strumenti:

- `lead_forms_create_form`, `lead_forms_update_form` (`call`, `agentId`, `prompt`, `sourceType`, `testMode`), `lead_forms_list_forms`, `lead_forms_get_form`.
- `meta_leads_publish_form` per il modulo Facebook / Instagram.
- `google_ads_leads_preview_form`, poi `google_ads_leads_list_campaigns`, poi `google_ads_leads_create_form` per Google Ads.
- `lead_forms_list_platform_forms` e `lead_forms_link_channel` per collegare un modulo che esiste già su una piattaforma.
- `lead_forms_create_workflow` per il workflow New lead, e `lead_forms_list_leads` per vedere chi l'ha compilato e se è stato chiamato.

## Risoluzione dei problemi

**Perché è arrivato un lead ma l'agent non ha chiamato?**

Apri il lead nella scheda **Leads**. **Failed** mostra il motivo. Cause comuni: **Call new leads automatically** è disattivato sul modulo che ha gestito il lead (controlla quale: un modulo di piattaforma non collegato va al modulo **Default**), il lead non ha un telefono, era un invio di prova, oppure è arrivato fuori dalle 09:00-21:00 ed è stato riprogrammato in quella fascia.

**Perché i lead dal mio modulo sul sito arrivano senza telefono?**

Il tuo modulo invia il telefono con un nome di campo che non abbiamo riconosciuto. Nella scheda **Channels** apri **Fields we receive**, segna il campo giusto come **Phone** e salva. Con **Test mode** invii una prova senza chiamare nessuno.

**Ho cambiato il modulo. Perché la mia inserzione Facebook mostra ancora quello vecchio?**

I moduli di Facebook non si possono modificare. **Update on Facebook** crea una nuova versione e archivia quella attuale; le inserzioni mostrano il modulo vecchio finché non le passi al nuovo in Ads Manager.

**Perché non posso scegliere il mio modulo LinkedIn da un elenco?**

LinkedIn non ci permette di elencare i tuoi moduli. Copia l'ID del modulo dalla piattaforma e incollalo con **Enter ID manually**. Facebook e TikTok elencano i loro moduli appena collegati; i moduli di Google Ads compaiono nell'elenco solo dopo **Sign in with Google** e la scelta dell'account pubblicitario.

## Prossimi passi

[Get an integration working](https://docs.voicelogica.ai/it/integrations/) - collegare le piattaforme pubblicitarie.  
[Workflows](https://docs.voicelogica.ai/it/workflows/) - cos'altro succede quando arriva un lead.  
[Claude e ChatGPT](https://docs.voicelogica.ai/it/integrations/claude-chatgpt/) - crea e pubblica moduli dal tuo assistente IA.