---
title: "Usa ThunderPhone con Zapier"
description: "Collega l'app ThunderPhone su Zapier alla tua organizzazione e crea uno Zap che viene eseguito ogni volta che una chiamata termina."
---

[Zapier](https://zapier.com) collega le app tramite flussi di lavoro automatizzati chiamati
Zap. L'app ThunderPhone su Zapier aggiunge:

- **Trigger:** **Chiamata completata** si attiva al termine di una chiamata
  telefonica, web o di test. **Chiamata valutata** si attiva quando è disponibile
  la valutazione di una chiamata completata.
- **Azioni:** **Effettua chiamata in uscita**, **Aggiungi contatti alla campagna** e
  **Avvia campagna**.
- **Ricerca:** **Trova chiamata** cerca una chiamata per ID e la restituisce con
  la trascrizione e un URL firmato della registrazione, quando disponibile.

Trovala su [ThunderPhone su Zapier](https://zapier.com/apps/thunderphone/integrations).
Per una panoramica dei due modi per usare Zapier con ThunderPhone, consulta la
[pagina dell'integrazione Zapier](https://thunderphone.com/integrations/zapier).

## Collega la tua organizzazione

L'app si collega tramite OAuth. Accedi a ThunderPhone e approvi
l'accesso per un'organizzazione, senza copiare alcuna chiave API in Zapier.

<Steps>
  <Step title="Aggiungi un passaggio ThunderPhone">
    Nell'editor di Zap, cerca **ThunderPhone** (mostrato con un'etichetta Beta)
    e seleziona un trigger o un'azione. Quando Zapier richiede un account, collegane uno nuovo. Zapier apre
    una finestra di accesso a ThunderPhone.
  </Step>
  <Step title="Accedi e scegli l'organizzazione">
    Accedi, verifica le autorizzazioni richieste, scegli l'organizzazione e
    seleziona **Approva**. L'app richiede di leggere i tuoi agenti e numeri di telefono,
    leggere e scrivere chiamate e campagne, gestire integrazioni come endpoint
    webhook e visualizzare l'email del tuo account.
  </Step>
  <Step title="Verifica il nome della connessione">
    Zapier assegna alla connessione il nome dell'organizzazione approvata, così
    puoi distinguere le connessioni quando appartieni a più di una organizzazione.
  </Step>
</Steps>

Collega un account con il ruolo di amministratore o proprietario in tale
organizzazione. L'attivazione o la disattivazione di uno Zap trigger, così come ogni azione, richiede quel
ruolo. Uno Zap trigger già attivo continua a ricevere eventi di chiamata dopo la
modifica del ruolo o la revoca della connessione. Disattivalo per interromperli. Trova
chiamata funziona per qualsiasi membro.

L'app non prevede alcun costo ThunderPhone aggiuntivo. Le chiamate che effettua o avvia
vengono fatturate alle normali tariffe ThunderPhone, mentre Zapier conta le attività nel tuo
piano Zapier.

## Crea il tuo primo Zap

Questo Zap aggiunge una riga a un foglio Google ogni volta che termina una chiamata.

<Steps>
  <Step title="Effettua una chiamata da usare come dati di esempio">
    Apri un agente nel builder, fai clic su **Parla** e termina la chiamata. Le
    chiamate di prova del builder attivano Call Completed, quindi il trigger
    riceve una chiamata recente da caricare.
  </Step>
  <Step title="Aggiungi il trigger">
    Scegli **ThunderPhone** come app trigger, imposta l'evento su **Call
    Completed** e seleziona la tua connessione ThunderPhone. Prova il trigger.
    Zapier carica come esempi le chiamate completate più recenti, nello stesso
    formato di un evento in tempo reale.
  </Step>
  <Step title="Aggiungi Google Sheets">
    Aggiungi un'azione Google Sheets che crea una riga del foglio di calcolo.
    Scegli un foglio con una riga di intestazione, quindi associa ogni colonna
    a un campo del trigger (consulta la tabella seguente).
  </Step>
  <Step title="Pubblica lo Zap">
    Pubblica e attiva lo Zap. L'attivazione crea nella tua organizzazione
    ThunderPhone un endpoint webhook denominato **Zapier: Call Completed**.
    La disattivazione dello Zap elimina quell'endpoint.
  </Step>
  <Step title="Provalo">
    Effettua un'altra chiamata di prova dal builder. Al termine, lo Zap viene
    eseguito e appare una riga.
  </Step>
</Steps>

Colonne utili:

| Colonna | Campo Call Completed |
|---|---|
| ID chiamata | ID chiamata |
| Agente | Nome agente |
| Direzione | Direzione |
| Da | Numero chiamante |
| A | Numero chiamato |
| Iniziata | Avviata il |
| Terminata | Terminata il |
| Durata (s) | Durata in secondi |
| Stato | Stato |
| Motivo della fine | Motivo della fine |
| Link alla chiamata | Digita `https://app.thunderphone.com/dashboard/call-history/`, quindi inserisci l'ID chiamata |

Il link alla chiamata apre la chiamata nella dashboard ThunderPhone per i
membri della tua organizzazione, con trascrizione e registrazione, quindi il
foglio non deve contenere nessuna delle due.

L'evento può anche includere la trascrizione, come elenco di turni, e un URL
della registrazione, un link firmato con scadenza. Aggiungili solo se il foglio
ne ha bisogno. Trascrizioni, riepiloghi e registrazioni delle chiamate possono
contenere informazioni personali o sanitarie. Inviali solo ad app che la tua
organizzazione è autorizzata a usare per tali dati, in base a un BAA quando
sono coinvolte informazioni sanitarie, e conserva solo i campi necessari.
Consulta [`telephony.complete` / `web.complete`](/it/webhooks/call-complete) per
tutti i campi.

<Note>
  Ogni consegna è firmata. L'app verifica l'HMAC
  `X-ThunderPhone-Signature` rispetto al segreto dell'endpoint prima
  dell'esecuzione dello Zap e blocca tutto ciò che non è firmato o non è
  valido. Se Zapier non accetta una consegna, ThunderPhone la ritenta per un
  massimo di 24 ore. Consulta la [panoramica dei webhook](/it/webhooks/overview).
</Note>

## Trigger, azioni e ricerca

**Chiamata valutata** fornisce l'ID chiamata, l'ID agente, il nome agente e la valutazione: ID valutazione, punteggio, esito chiamata, riepilogo, modello di valutazione e data di valutazione. L'attivazione di uno Zap crea un endpoint denominato **Zapier: Chiamata valutata**. Una chiamata può essere valutata più volte e ogni esecuzione di valutazione completata attiva il trigger. Consulta
[`call.graded`](/it/webhooks/events).

**Trova chiamata** accetta un ID chiamata, con un menu a discesa delle chiamate recenti. Restituisce l'agente della chiamata, la direzione, i numeri, gli orari di inizio e fine, lo stato, il motivo della fine, il punteggio della valutazione e l'esito della chiamata, la trascrizione e un URL di registrazione firmato quando disponibile. Un ID chiamata sconosciuto non restituisce alcun risultato invece di un errore.

**Effettua chiamata in uscita** accetta:

| Campo | Significato |
|---|---|
| Agente | Un agente salvato. Il menu a discesa elenca i tuoi agenti. |
| Numero destinatario | Destinazione nel formato E.164, ad esempio `+14155552671`. |
| Numero di origine | Il menu a discesa elenca solo i numeri abilitati per le chiamate in uscita. |
| Variabili | Oggetto JSON facoltativo di valori per i segnaposto nel prompt dell'agente. |
| Chiave di idempotenza | Un ID stabile dal trigger o dal record di origine. Obbligatorio. |

Restituisce l'ID chiamata, lo stato e la ripetizione idempotente.

**Aggiungi contatti alla campagna** aggiunge contatti a una campagna in bozza. Per un contatto, compila **Numero di telefono** nel formato E.164 e facoltativamente **Variabili contatto**, un oggetto JSON le cui proprietà diventano variabili della campagna. Per un batch, compila **JSON dei contatti** con un array di fino a 5.000 oggetti. Ciascuno richiede `phone_number` e le altre proprietà diventano variabili. Il passaggio non riesce quando tutti i contatti vengono rifiutati e imposta **Successo parziale** quando solo alcuni vengono accettati.

**Avvia campagna** avvia o riprende una campagna con almeno un contatto. Richiede **Consenso all'addebito**. Consulta
[Campagne in uscita](/it/guides/outbound-campaigns).

## Prima che uno Zap effettui chiamate

Effettua chiamata in uscita e Avvia campagna compongono numeri di telefono reali e avviano chiamate fatturabili.

- Se ThunderPhone chiede alla tua organizzazione di confermare che le chiamate in uscita rispettano il TCPA e le altre leggi sulle chiamate, un amministratore deve registrare tale conferma nella dashboard prima che uno Zap possa avviare chiamate.
- Il numero di origine deve essere abilitato per le chiamate in uscita. I numeri forniti dal tuo operatore diventano idonei una volta verificati. I numeri forniti da ThunderPhone sono inizialmente solo in entrata e puoi richiedere l'accesso alle chiamate in uscita per questi numeri nella dashboard. Consulta [Ottieni un numero di telefono](/it/guides/get-a-phone-number).
- Effettua chiamata in uscita richiede una **Chiave di idempotenza**. Mappa un ID stabile dal trigger o dal record di origine, ad esempio l'ID evento ThunderPhone o l'ID record CRM. Se Zapier riprova il passaggio, ThunderPhone riconosce la chiave e restituisce la chiamata originale invece di effettuarne una seconda. Evita timestamp, valori casuali o il solo ID Zap.
- Avvia campagna richiede **Consenso all'addebito**, che conferma che lo Zap può avviare chiamate in uscita fatturabili sul tuo account.
- La tua organizzazione è responsabile di disporre del consenso per chiamare ogni numero e di rispettare le leggi sulle chiamate applicabili. Consulta
  [leggi sulle chiamate in uscita](/it/guides/outbound-calling-laws).

Una chiave di idempotenza è univoca nella tua organizzazione e può contenere al massimo 128 caratteri. Riutilizzare una chiave con un agente, un numero o variabili diversi non riesce a causa di un conflitto, quindi se due Zap possono chiamare riguardo allo stesso record, assegna a ciascuno Zap il proprio prefisso fisso prima dell'ID record.
[Effettua chiamate in uscita](/it/guides/place-outbound-calls) descrive l'API alla base di questa azione.

## Esempi di Zap

- **Chiamata completata in un CRM.** Registra un'attività per ogni chiamata conclusa con il relativo stato, motivo di conclusione e trascrizione.
- **Chiamata valutata per il follow-up.** Filtra in base all'esito o al punteggio della chiamata e instradala nel flusso di lavoro di follow-up corretto.
- **Nuovo lead in una campagna.** Aggiungi il lead a una bozza di campagna con Aggiungi contatti alla campagna, quindi esegui Avvia campagna dopo che qualcuno ha approvato l'elenco.

Le trascrizioni, i riepiloghi e le registrazioni delle chiamate possono contenere informazioni personali o sanitarie. Inviali solo ad app che la tua organizzazione è autorizzata a usare per tali dati, in conformità a un BAA quando sono coinvolte informazioni sanitarie, e conserva solo i campi necessari.

## Risoluzione dei problemi

**Un passaggio non riesce e mostra un errore di autorizzazione.** Ricollega la connessione ThunderPhone in Zapier e approva nuovamente. Una connessione smette di funzionare quando la persona che l'ha collegata la revoca in ThunderPhone in **Organizzazione → Chiavi → App autorizzate**, quando tale persona lascia l'organizzazione o quando trascorrono 30 giorni senza un aggiornamento riuscito del token. Vedi [Connetti con OAuth](/it/guides/oauth).

**L'attivazione o la disattivazione di uno Zap non riesce oppure un'azione viene rifiutata.** La persona che ha effettuato la connessione deve avere il ruolo di amministratore o proprietario nell'organizzazione. Ricollega un account che dispone di tale ruolo. Uno Zap trigger già attivo continua a ricevere eventi di chiamata dopo la modifica del ruolo o la revoca della connessione. Disattivalo per interromperli.

**Vuoi disconnettere l'app.** Disattiva gli Zap ThunderPhone prima di revocare la connessione, poiché la disattivazione di uno Zap elimina il relativo endpoint e richiede una connessione funzionante. Se hai revocato prima la connessione, elimina l'endpoint residuo **Zapier: …** con `DELETE /v1/developer/webhook-endpoints/{id}` usando una chiave API di amministratore. Vedi [Endpoint webhook](/it/webhooks/endpoints).

**Lo Zap deve usare un'altra organizzazione.** Ogni connessione copre un'organizzazione. Disattiva prima lo Zap, in modo che il relativo endpoint webhook venga eliminato dall'organizzazione corrente. Quindi collega un nuovo account ThunderPhone in Zapier, scegli l'altra organizzazione durante l'approvazione e seleziona quella connessione in ogni passaggio ThunderPhone. Agenti, numeri e campagne differiscono tra le organizzazioni, quindi seleziona nuovamente **Agente**, **Numero chiamante** e **Campagna** in ogni passaggio che li include. Quindi riattiva lo Zap.

**Il trigger ha smesso di attivarsi.** Ogni Zap con un trigger ThunderPhone possiede un endpoint webhook nella tua organizzazione, denominato **Zapier: Chiamata completata** o **Zapier: Chiamata valutata**. Viene creato quando lo Zap viene attivato ed eliminato quando viene disattivato. Lascialo invariato. Se è stato modificato o eliminato in ThunderPhone, disattiva e riattiva lo Zap per crearne uno nuovo.
Con una chiave API di amministratore,
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
mostra i tentativi di consegna recenti.

<Note>
  Vuoi che l'agente vocale utilizzi azioni Zapier durante una chiamata anziché dopo?
  Collega un endpoint MCP di Zapier in **Connessioni → MCP**. Vedi
  [Server MCP](/it/guides/mcp-servers). Per inviare gli stessi eventi di chiamata al tuo
  server, vedi [Endpoint webhook](/it/webhooks/endpoints).
</Note>