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

# Zapier

> Automatizza la tua app Base44 collegandola a Zapier, così le azioni nella tua app possono attivare attività in migliaia di altre app come inviare inviti calendario, aggiornare fogli di calcolo o pubblicare messaggi.

<Info>
  **Nota:** Le integrazioni Zapier richiedono il piano **Builder** o superiore. Se sei sul piano Free, devi aggiornare prima di procedere. Ti serve anche un account Zapier premium per usare i webhook.
</Info>

# **Configurazione passo passo**

Questa integrazione può essere aggiunta in due modi:

<CardGroup cols={2}>
  <Card icon="sparkle" href="https://docs.base44.com/Integrations/Zapier-integration#part-1%3A-ready-made-integration-for-new-apps" title="Opzione A: Integrazione pronta (preferita)">
    * Scegli questo percorso se stai iniziando una nuova app da zero.
  </Card>

  <Card icon="bolt" href="https://docs.base44.com/Integrations/Zapier-integration#part-2%3A-instant-integration-add-zapier-to-an-existing-app" title="Opzione B: Integrazione istantanea">
    * Scegli questo percorso se stai già costruendo e vuoi integrare Zapier in un'app esistente.
  </Card>
</CardGroup>

## Parte 1: Integrazione pronta (per nuove app)

<Steps>
  <Step title="Crea uno Zap e un catch hook">
    * Accedi a Zapier e clicca su **Create Zap**.

          <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/CreateZap.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=0927353caa6b30a75f6262160f061c51" alt="Create Zap Pn" width="1881" height="785" data-path="images/CreateZap.png" />
    * Scegli **Webhooks by Zapier → Catch Hook** come trigger.

          <img src="https://mintcdn.com/base44/x7uieDiv9xNLARBF/images/Webhooks.png?fit=max&auto=format&n=x7uieDiv9xNLARBF&q=85&s=0542c15e6407e32dbf8a3bd38bfd8b76" alt="Webhooks Pn" width="1858" height="994" data-path="images/Webhooks.png" />
    * Lascia vuoto il campo **Pick off a Child Key** per catturare il payload completo.

          <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/CatchHook.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=5f0c377dfdccda8942bbaeb18b3d50a7" alt="Catch Hook Pn" width="1903" height="989" data-path="images/CatchHook.png" />
    * Continua e copia l'URL del webhook.
  </Step>

  <Step title="Inizia una nuova app Base44 e aggiungi Zapier dal catalogo">
    * In una nuova scheda del browser, vai su Base44 e clicca su **Integrations**.

          <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/Integrations.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=16ac71b185167177ef260be7c92b0339" alt="Integrations Pn" width="1570" height="652" data-path="images/Integrations.png" />
    * Trova **Zapier** e clicca su **Use this integration**.

          <img src="https://mintcdn.com/base44/x7uieDiv9xNLARBF/images/ZapierCatalog.png?fit=max&auto=format&n=x7uieDiv9xNLARBF&q=85&s=ba5d4610c0e1999c04cc6b636d88e588" alt="Zapier Catalog Pn" width="1879" height="977" data-path="images/ZapierCatalog.png" />

          <img src="https://mintcdn.com/base44/x7uieDiv9xNLARBF/images/UseZapier.png?fit=max&auto=format&n=x7uieDiv9xNLARBF&q=85&s=93708cd4b0175911daa0375417676312" alt="Use Zapier Pn" width="1894" height="987" data-path="images/UseZapier.png" />
    * Quando richiesto, incolla l'URL del webhook nel campo **ZAPIER\_WEBHOOK\_URL**.

          <img src="https://mintcdn.com/base44/x7uieDiv9xNLARBF/images/WebhookURL.png?fit=max&auto=format&n=x7uieDiv9xNLARBF&q=85&s=c05fe3d323b4fa4bd611e125847408db" alt="Webhook URL Pn" width="1876" height="914" data-path="images/WebhookURL.png" />
    * Descrivi la tua app in linguaggio naturale. Ad esempio:\
      `I am a therapist. Build an app to manage my schedule and let my clients book meeting.`
  </Step>

  <Step title="Prenota un meeting di test">
    * Dopo che l'app è creata, apri l'anteprima dell'app e prenota un meeting di test:
      * Scegli una data e un'ora tra qualche minuto nel futuro.
      * Usa la tua email reale.
      * Invia una volta e aspetta 2-5 secondi.

    Questo invia un payload di esempio al tuo Zap così Zapier può caricare campi reali durante la configurazione.

    #### **Dati da inviare da Base44 a Zapier**

    Assicurati che il payload sia dettagliato così Zap può creare l'evento calendario giusto. Includi e salva questi nella tua collection Meetings:

    * **start\_iso**: un datetime ISO 8601 che combina la data e l'ora scelte.

          <Tip>
            Esempio: new Date(\$dateT\$time:00).toISOString()
          </Tip>
    * **end\_iso** o **duration\_minutes**: invia un end time esplicito come ISO, oppure invia duration\_minutes così Zapier può calcolare +30m nell'azione
    * **time\_zone**: il fuso orario della tua app o utente, preferibilmente un nome IANA come Asia/Jerusalem; se non puoi fornire un nome, includi l'offset numerico
    * **meeting\_id**: un id stabile per evitare duplicati, ad esempio \$client\_email|\$start\_iso
    * **client\_name**, **client\_email,** **notes**

    Salvare questi campi assicura che tu possa fare l'audit delle prenotazioni e Zapier mappa l'evento correttamente ogni volta.
  </Step>

  <Step title="Dì a Zapier di recuperare il sample">
    * Torna a Zapier, vai alla scheda Test del tuo trigger.
    * Clicca su **Find new records**, seleziona la richiesta di esempio che la tua app ha inviato e continua.
    * Se non appare nulla, invia un altro meeting di test e clicca di nuovo su **Find new records**.
  </Step>

  <Step title="Crea l'evento Google Calendar">
    * Aggiungi un'azione: **Google Calendar → Create Detailed Event**.
    * Mappa i campi dal tuo sample ai campi dell'evento:
      * **Summary:** `Meeting with client_name`
      * **Description:** `notes`
      * **Start Date & Time:** `start_iso`
      * **End Date & Time:** `start_iso + 30m` (o calcola usando duration\_minutes)
      * **Guests:** `client_email`
      * **Time Zone:** scegli la zona del tuo calendario
    * Clicca su **Test** per assicurarti che l'evento appaia e che venga inviato un invito.
  </Step>

  <Step title="Pubblica il tuo Zap">
    Clicca su **Publish** per attivare lo Zap. Da ora, ogni nuovo meeting nella tua app creerà automaticamente un evento calendario.
  </Step>
</Steps>

***

## Parte 2: Integrazione istantanea (aggiungi Zapier a un'app esistente)

Usa questo metodo se la tua app esiste già e vuoi collegare Zapier durante la costruzione.

<Steps>
  <Step stepNumber={1} title="Seleziona la tua app esistente">
    * Ecco il prompt che abbiamo digitato nella chat IA per costruire la nostra app di esempio:

      `I am a therapist. Build an app to manage my schedule and let my clients book meeting.`
  </Step>

  <Step stepNumber={2} title="Chiedi a Base44 di aggiungere Zapier">
    * Nella finestra chat della tua app, dì qualcosa come:

      `I want to connect my app to Zapier. Please make an integration that sends booking data to Zapier from the backend only. Never call Zapier from the browser.`
    * Tieni aperta la chat mentre completi il passaggio successivo.
  </Step>

  <Step stepNumber={3} title="Crea l'URL webhook in Zapier">
    * In Zapier, **crea un nuovo Zap** con **Webhooks by Zapier → Catch Hook** e copia l'URL del webhook (proprio come nella Parte 1).

          <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/CreateZap.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=0927353caa6b30a75f6262160f061c51" alt="Create Zap Pn" width="1881" height="785" data-path="images/CreateZap.png" />

          <img src="https://mintcdn.com/base44/x7uieDiv9xNLARBF/images/Webhooks.png?fit=max&auto=format&n=x7uieDiv9xNLARBF&q=85&s=0542c15e6407e32dbf8a3bd38bfd8b76" alt="Webhooks Pn" width="1858" height="994" data-path="images/Webhooks.png" />

          <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/CatchHook.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=5f0c377dfdccda8942bbaeb18b3d50a7" alt="Catch Hook Pn" width="1903" height="989" data-path="images/CatchHook.png" />
    * Incolla questo URL nella chat Base44 quando richiesto. L'integrazione lo salverà in modo sicuro e collegherà una rotta backend per pubblicare i dati di prenotazione su Zapier.
  </Step>

  <Step stepNumber={4} title="Crea un meeting di esempio">
    * Dopo che l'app è creata, apri l'anteprima dell'app e prenota un meeting di test:
      * Scegli una data e un'ora tra qualche minuto nel futuro.
      * Usa la tua email reale.
      * Invia una volta e aspetta 2-5 secondi.

    Questo invia un payload di esempio al tuo Zap così Zapier può caricare campi reali durante la configurazione.

    #### **Dati da inviare da Base44 a Zapier**

    Assicurati che il payload sia dettagliato così Zap può creare l'evento calendario giusto. Includi e salva questi nella tua collection Meetings:

    * **start\_iso**: un datetime ISO 8601 che combina la data e l'ora scelte.

          <Tip>
            Esempio: new Date(\$dateT\$time:00).toISOString()
          </Tip>
    * **end\_iso** o **duration\_minutes**: invia un end time esplicito come ISO, oppure invia duration\_minutes così Zapier può calcolare +30m nell'azione
    * **time\_zone**: il fuso orario della tua app o utente, preferibilmente un nome IANA come Asia/Jerusalem; se non puoi fornire un nome, includi l'offset numerico
    * **meeting\_id**: un id stabile per evitare duplicati, ad esempio \$client\_email|\$start\_iso
    * **client\_name**, **client\_email,** **notes**

    Salvare questi campi assicura che tu possa fare l'audit delle prenotazioni e Zapier mappa l'evento correttamente ogni volta.
  </Step>

  <Step stepNumber={5} title="Dì a Zapier di recuperare il sample">
    * Nel trigger del tuo Zap, vai alla scheda **Test** e clicca su **Find new records**.
    * Seleziona l'ultima richiesta e continua. Se non appare nulla, invia un altro test, poi clicca di nuovo su **Find new records**.
  </Step>

  <Step stepNumber={6} title="Crea l'evento Google Calendar">
    * Aggiungi un'azione: **Google Calendar → Create Detailed Event**.
    * Mappa i campi dal tuo sample ai campi dell'evento:
      * **Summary:** `Meeting with client_name`
      * **Description:** `notes`
      * **Start Date & Time:** `start_iso`
      * **End Date & Time:** `start_iso + 30m` (o calcola usando duration\_minutes)
      * **Guests:** `client_email`
      * **Time Zone:** scegli la zona del tuo calendario
    * Clicca su **Test** per assicurarti che l'evento appaia e che venga inviato un invito.
  </Step>

  <Step stepNumber={7} title="Pubblica il tuo Zap">
    * Attiva lo Zap. Le nuove prenotazioni ora attiveranno automaticamente eventi calendario.
  </Step>
</Steps>

***

# **Risoluzione dei problemi**

* **Nessun sample in Zapier:** Assicurati di aver prenotato un meeting di test prima di testare.
* **Errori 401 o CORS:** Pubblica su Zapier solo dal backend; non chiamare mai Zapier dal browser.
* **Orari sbagliati:** Assicurati di combinare data e ora in un datetime ISO corretto (start\_iso) e imposta il fuso orario corretto quando crei l'evento calendario.
* **Lo Zap non gira:** Conferma di aver cliccato su **Publish** per attivare lo Zap.

***

## **Checklist rapida**

Usa questo elenco per assicurarti di non aver dimenticato nulla:

* Catch Hook creato con **Pick off a Child Key** lasciato vuoto
* URL webhook salvato come **ZAPIER\_WEBHOOK\_URL** in Base44
* Piano Builder o superiore
* Un meeting di esempio prenotato prima di testare
* Azione Google Calendar mappata e testata
* Zap pubblicato e attivato

***

<Note>Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](/). </Note>
