> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whappy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

> Collega Whappy a oltre 6.000 app per automatizzare il flusso dei lead. Invia i lead qualificati al tuo CRM o ricevi nuovi lead da moduli e inserzioni.

Collega Whappy a più di 6.000 app tramite Zapier per automatizzare il flusso dei lead. Invia automaticamente i lead qualificati al tuo CRM, oppure ricevi nuovi lead da moduli e inserzioni per avviare conversazioni WhatsApp.

## Come funziona

<CardGroup cols={2}>
  <Card title="Trigger (invio dei lead in uscita)" icon="arrow-right" color="#green">
    **Whappy → altre app**: quando un lead completa la conversazione o fissa un appuntamento, i suoi dati vengono inviati automaticamente a CRM, strumenti email, calendari…
  </Card>

  <Card title="Azioni (ricezione dei lead in entrata)" icon="arrow-left" color="#blue">
    **Altre app → Whappy**: quando ricevi nuovi lead da moduli, inserzioni o altre fonti, vengono aggiunti automaticamente a Whappy per avviare conversazioni WhatsApp.
  </Card>
</CardGroup>

***

## Configurare le azioni (lead in entrata)

Usa le azioni per aggiungere automaticamente nuovi lead a Whappy dagli altri tuoi strumenti e avviare le conversazioni WhatsApp.

### Configurazione passo per passo

<Steps>
  <Step title="Imposta l'app che fa da trigger">
    1. Crea un nuovo Zap in Zapier
    2. Scegli come trigger la tua fonte di lead (Typeform, Facebook Lead Ads, Google Sheets…)
    3. Collega l'account e configura il trigger
    4. Prova il trigger per assicurarti che funzioni
  </Step>

  <Step title="Aggiungi Whappy come azione">
    1. Nella sezione azione, cerca **"Whappy"**
    2. Seleziona **Whappy** fra i risultati
    3. Scegli **Create Lead** come evento
    4. Premi **Continue**

    <div style={{ textAlign: 'center' }}>
      <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/setup-action.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=131fc37d16599a22c44d85762de7078c" alt="Configurazione dell'azione" style={{ maxWidth: '350px', width: '100%', height: 'auto' }} width="978" height="1288" data-path="images/zapier/setup-action.png" />
    </div>
  </Step>

  <Step title="Collega il tuo account Whappy">
    1. Premi **Sign in to Whappy**
    2. Copia la tua API key da **Integrazioni → Zapier** nella dashboard di Whappy
    3. Incolla la chiave in Zapier
    4. Aggiungi un'etichetta per l'account (utile per riconoscerlo se ne hai collegati più di uno)
    5. Premi **Yes, Continue to Whappy**

    <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/copy-api-key.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=bef9d6330e76cd501e2d4e41dc97d241" alt="Collegamento dell'account Whappy per le azioni" width="3024" height="1604" data-path="images/zapier/copy-api-key.png" />

    <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/paste-api-key.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=678a152070f74aecad7f0fdddd8e74f2" alt="Incolla la API key in Zapier" width="1962" height="1528" data-path="images/zapier/paste-api-key.png" />

    <Note>
      Usa la stessa API key che usi per i trigger. L'account va collegato una sola volta.
    </Note>
  </Step>

  <Step title="Configura i dati del lead">
    Mappa i campi dell'app di origine su Whappy. Questi sono i campi disponibili:

    **Campi obbligatori:**

    * **Phone** *(deve includere il prefisso internazionale, es. +393441234567)*
    * **First Name**

    **Campi facoltativi:**

    * **Email**
    * **Lead Data** *(formato JSON per le informazioni personalizzate)*
    * **Is Test Lead** *(scegli "No" per i lead reali, "Yes" per i test)*

    <div style={{ textAlign: 'center' }}>
      <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/configure-action.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=a402e34a3bad6cba0d979391ed23b893" alt="Configurazione dei campi del lead nell'azione Zapier" style={{ maxWidth: '350px', width: '100%', height: 'auto' }} width="972" height="1284" data-path="images/zapier/configure-action.png" />
    </div>

    <Warning>
      I numeri di telefono devono includere il prefisso internazionale (es. +39 per l'Italia) per funzionare con WhatsApp.
    </Warning>
  </Step>

  <Step title="Prova e attiva">
    1. Premi **Test action** per inviare un lead di esempio a Whappy
    2. Controlla nella dashboard di Whappy, sezione **Lead**, che il lead sia stato creato
    3. Se la prova riesce, attiva lo Zap per iniziare a ricevere lead automaticamente

    <div style={{ textAlign: 'center' }}>
      <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/test-action.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=939cd5a1d03aa51c704eb64d9b39805c" alt="Prova dell'azione e verifica della creazione del lead" style={{ maxWidth: '350px', width: '100%', height: 'auto' }} width="970" height="1286" data-path="images/zapier/test-action.png" />
    </div>
  </Step>
</Steps>

### Casi d'uso frequenti (azioni)

<Accordion title="Moduli del sito → follow-up su WhatsApp">
  **Configurazione**:

  * **Trigger**: nuovo invio da Typeform/Gravity Forms
  * **Azione**: Create Lead in Whappy

  **Vantaggi**:

  * Follow-up immediato su WhatsApp per chi compila un modulo
  * Tassi di risposta più alti rispetto all'email
  * La qualificazione automatica parte subito
</Accordion>

<Accordion title="Facebook Lead Ads → qualificazione su WhatsApp">
  **Configurazione**:

  * **Trigger**: nuovo invio da Facebook Lead Ads
  * **Azione**: Create Lead in Whappy

  **Vantaggi**:

  * Qualifichi subito i lead delle inserzioni via WhatsApp
  * Riduci il costo per lead qualificato
  * Filtri presto i contatti non in target
</Accordion>

<Accordion title="Contatti CRM → campagne di riattivazione">
  **Configurazione**:

  * **Trigger**: contatto nuovo o aggiornato nel CRM
  * **Azione**: Create Lead in Whappy

  **Vantaggi**:

  * Riattivi i lead freddi su WhatsApp
  * Dai seguito alle opportunità commerciali
  * Coltivi i contatti con l'AI conversazionale
</Accordion>

***

## Configurare i trigger (lead in uscita)

Usa i trigger per inviare automaticamente i dati dei lead qualificati da Whappy agli altri tuoi strumenti, quando una conversazione si conclude o viene fissato un appuntamento.

### Trigger disponibili

* **Lead Closed**: scatta quando un lead completa il funnel di conversazione
* **Appointment Scheduled**: scatta quando un lead fissa un appuntamento nella conversazione

### Configurazione passo per passo

<Steps>
  <Step title="Crea un nuovo Zap e trova Whappy">
    1. Vai su [zapier.com](https://zapier.com) e premi **Create Zap**
    2. Nella sezione trigger, cerca **"Whappy"**
    3. Seleziona **Whappy** fra i risultati

    <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/search-whappy.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=a3f8b239fc9c78d5a461842ec64f7c70" alt="Ricerca di Whappy fra i trigger di Zapier" width="3024" height="1594" data-path="images/zapier/search-whappy.png" />
  </Step>

  <Step title="Scegli l'evento del trigger">
    Scegli il trigger adatto al tuo flusso:

    * **Lead Closed**: per inviare i lead completati/qualificati al CRM o agli strumenti di email marketing
    * **Appointment Scheduled**: per creare eventi in calendario o inviare email di conferma

    <div style={{ textAlign: 'center' }}>
      <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/setup-lead-closed.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=edf3fee619dcbce3a1797b85623a8906" alt="Selezione dell'evento trigger in Zapier" style={{ maxWidth: '350px', width: '100%', height: 'auto' }} width="968" height="1282" data-path="images/zapier/setup-lead-closed.png" />
    </div>
  </Step>

  <Step title="Collega il tuo account Whappy">
    1. Premi **Sign in to Whappy**
    2. Nella dashboard di Whappy vai su **Integrazioni → Zapier**
    3. Copia la tua API key dalla scheda dell'integrazione Zapier
    4. Torna su Zapier e incollala nel modulo di connessione
    5. Premi **Yes, Continue to Whappy**

    <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/copy-api-key.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=bef9d6330e76cd501e2d4e41dc97d241" alt="Collegamento dell'account Whappy in Zapier" width="3024" height="1604" data-path="images/zapier/copy-api-key.png" />

    <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/paste-api-key.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=678a152070f74aecad7f0fdddd8e74f2" alt="Incolla la API key in Zapier" width="1962" height="1528" data-path="images/zapier/paste-api-key.png" />

    Premi **Continue**.

    <Note>
      La tua API key è unica per il tuo account. Custodiscila e non condividerla pubblicamente.
    </Note>
  </Step>

  <Step title="Prova il trigger">
    1. Premi **Test trigger** per recuperare dati di esempio da Whappy
    2. Vedrai la struttura dei dati che verrà inviata all'app successiva
    3. Controlla i dati di esempio e premi **Continue**

    <div style={{ textAlign: 'center' }}>
      <img src="https://mintcdn.com/whappy/kglCbESBYdWSPkHx/images/zapier/test-trigger.png?fit=max&auto=format&n=kglCbESBYdWSPkHx&q=85&s=b1040f4afaf57b0e5a71790e6d001a02" alt="Prova del trigger e dati di esempio" style={{ maxWidth: '350px', width: '100%', height: 'auto' }} width="990" height="1290" data-path="images/zapier/test-trigger.png" />
    </div>

    <Tip>
      Se non compaiono dati di esempio, assicurati di avere almeno una conversazione conclusa o un appuntamento in Whappy.
    </Tip>
  </Step>

  <Step title="Configura l'app di destinazione">
    1. Scegli l'app a cui inviare i dati (HubSpot, Google Calendar, Mailchimp…)
    2. Collega il tuo account per quell'app
    3. Mappa i campi di Whappy sui campi dell'app di destinazione
    4. Prova lo Zap completo
    5. Attivalo per far partire l'automazione
  </Step>
</Steps>

### Casi d'uso frequenti (trigger)

<Accordion title="Invia i lead qualificati al CRM (HubSpot, Salesforce)">
  **Configurazione**:

  * **Trigger**: Lead Closed
  * **Azione**: crea un contatto nel CRM

  **Esempio di mappatura**:

  * "Name" di Whappy → "Nome" / "Cognome" del CRM
  * "Phone" di Whappy → "Telefono" del CRM
  * "Email" di Whappy → "Email" del CRM
  * "Collected Info" di Whappy → proprietà personalizzate del CRM

  **Vantaggi**: popoli automaticamente il CRM con i lead qualificati e i dati della loro conversazione.
</Accordion>

<Accordion title="Crea eventi in calendario per gli appuntamenti">
  **Configurazione**:

  * **Trigger**: Appointment Scheduled
  * **Azione**: crea un evento su Google Calendar

  **Esempio di mappatura**:

  * "Appointment Date" di Whappy → orario di inizio dell'evento
  * "Lead Name" di Whappy → titolo dell'evento
  * "Phone" di Whappy → descrizione dell'evento

  **Vantaggi**: blocchi automaticamente il tempo in agenda quando un lead prenota da WhatsApp.
</Accordion>

<Accordion title="Aggiungi alle liste di email marketing">
  **Configurazione**:

  * **Trigger**: Lead Closed
  * **Azione**: aggiungi iscritto a Mailchimp/ConvertKit

  **Esempio di mappatura**:

  * "Email" di Whappy → email dell'iscritto
  * "Name" di Whappy → nome dell'iscritto
  * "Collected Info" di Whappy → tag o campi personalizzati

  **Vantaggi**: coltivi automaticamente i lead qualificati con sequenze email mirate.
</Accordion>

***

## Gestire la tua API key

La API key per Zapier si trova in **Integrazioni → Zapier** nella dashboard di Whappy. La stessa chiave vale sia per i trigger sia per le azioni.

### Sicurezza della API key

<CardGroup cols={2}>
  <Card title="Custodiscila" icon="shield-check" color="#green">
    * Non condividere la chiave pubblicamente
    * Usala solo in automazioni Zapier affidabili
    * Contatta l'assistenza se sospetti che sia compromessa
  </Card>

  <Card title="Monitora l'uso" icon="chart-line" color="#blue">
    * Controlla regolarmente lo storico dei task su Zapier
    * Rivedi i nuovi lead nella dashboard di Whappy
    * Tieni d'occhio attività inattese
  </Card>
</CardGroup>

***

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Problemi di connessione con l'API key">
    **Problema**: errore "Failed to connect to Whappy"

    **Soluzioni**:

    * Verifica di aver copiato la chiave per intero
    * Assicurati che non ci siano spazi prima o dopo
    * Prova a scollegare e ricollegare l'account in Zapier
    * Verifica di usare la chiave giusta, quella della scheda Zapier
  </Accordion>

  <Accordion title="I trigger non scattano">
    **Problema**: nessun dato inviato quando i lead concludono le conversazioni

    **Soluzioni**:

    * Verifica che lo Zap sia **attivo** in Zapier
    * Controlla che i lead arrivino davvero al passaggio di chiusura o appuntamento
    * Prova con conversazioni reali, non con dati in modalità test
    * Consulta lo storico dei task di Zapier per eventuali errori
    * Assicurati che la campagna sia in esecuzione
  </Accordion>

  <Accordion title="L'azione di creazione lead fallisce">
    **Problema**: errore "Failed to create lead"

    **Soluzioni**:

    * Assicurati che il numero includa il prefisso internazionale (+393441234567)
    * Verifica che i campi Phone e First Name siano mappati correttamente
    * Controlla che il formato del numero sia valido per WhatsApp
    * Prova prima con i soli campi obbligatori
    * Verifica che i dati del lead siano in formato JSON corretto se usi campi personalizzati
  </Accordion>

  <Accordion title="Dati del lead mancanti o errati">
    **Problema**: i lead vengono creati ma senza alcune informazioni

    **Soluzioni**:

    * Controlla la mappatura dei campi nell'azione Zapier
    * Verifica che l'app di origine fornisca davvero quei dati
    * Prova prima con valori fissi, poi con i dati dinamici del trigger
    * Verifica il formato JSON del campo Lead Data
    * Controlla se i campi facoltativi vengono effettivamente forniti dal trigger
  </Accordion>
</AccordionGroup>

***

## Buone pratiche

### Per cominciare

* **Parti semplice**: comincia con automazioni di base prima di aggiungere complessità
* **Prova a fondo**: verifica sempre con dati di esempio prima di andare in produzione
* **Usa lead di prova**: contrassegnali come "test" durante la configurazione per non toccare i dati reali
* **Monitora all'inizio**: controlla spesso le automazioni nei primi giorni

### Ottimizzazione del flusso

* **Usa i filtri**: aggiungi filtri Zapier per elaborare solo i lead rilevanti (budget, fonte…)
* **Zap separati**: crea Zap diversi per fonti diverse, invece di un unico flusso complesso
* **Gestione degli errori**: imposta notifiche email per i task Zapier falliti
* **Manutenzione periodica**: rivedi e aggiorna gli Zap ogni mese

### Qualità dei dati

* **Valida i numeri**: assicurati che includano il prefisso e siano formattati correttamente
* **Mantieni i dati coerenti**: usa formati standard per i campi personalizzati in tutte le fonti
* **Controlla la qualità dei lead**: confronta regolarmente i lead automatici con quelli inseriti a mano

<Tip>
  Comincia con una sola automazione semplice (per esempio inviare i lead conclusi al CRM) prima di costruire flussi complessi a più passaggi. Ti aiuta a capire il flusso dei dati e a individuare presto i problemi.
</Tip>

***

## Passi successivi

Pronto ad automatizzare il flusso dei lead?

1. **Prendi la tua API key**: vai su **Integrazioni → Zapier** nella dashboard
2. **Scegli la prima automazione**: comincia inviando i lead qualificati al CRM, oppure ricevendo lead dalla tua fonte più attiva
3. **Segui le guide**: usa le istruzioni passo per passo qui sopra
4. **Prova e monitora**: verifica sempre a fondo prima di andare in produzione

<CardGroup cols={2}>
  <Card title="Configurazione trigger" icon="arrow-right" href="#configurare-i-trigger-lead-in-uscita">
    Invia automaticamente i lead qualificati al tuo CRM
  </Card>

  <Card title="Configurazione azioni" icon="arrow-left" href="#configurare-le-azioni-lead-in-entrata">
    Aggiungi a Whappy chi compila i moduli, per il follow-up su WhatsApp
  </Card>
</CardGroup>