Skip to main content
Le chiamate in uscita ti consentono di fornire a ThunderPhone un numero di destinazione e una configurazione dell’agente, lasciando che l’IA effettui la chiamata per tuo conto. Casi d’uso tipici:
  • Conferme di appuntamenti
  • Richiamate per sondaggi
  • Follow-up al “secondo tentativo” dopo una chiamata persa
  • Notifiche in stile dispatch
Devi chiamare un intero elenco? La funzionalità Campagne della dashboard (/dashboard/campaigns) accetta un CSV di contatti e gestisce per te finestre di chiamata basate sul fuso orario, concorrenza e policy di tentativi. Questa guida tratta le singole chiamate programmatiche.

​
Prerequisiti

1

Porta un numero VoIP

Le chiamate in uscita richiedono che tu possieda il from_number tramite una connessione VoIP. I numeri demo sono solo per le chiamate in entrata. Consulta Porta i tuoi numeri.
2

Crea un agente

Un prompt orientato alle chiamate in uscita tende a iniziare con l’agente che si identifica e ne spiega lo scopo — “Salve, Acme chiama per confermare il suo appuntamento di domani alle 15…” Imposta outbound_speak_order su agent_first (l’impostazione predefinita).
3

Mantieni un saldo positivo

Le chiamate in uscita restituiscono 402 Payment Required se il saldo è ≤ $0.00. Ricarica tramite POST /v1/billing/top-up oppure abilita la ricarica automatica.

​
Effettua una chiamata con un agente salvato

Il percorso più semplice — fai riferimento a un agente tramite id:
Risposta:
status: "initiated" indica solo che la richiesta è stata accettata — la chiamata non è ancora connessa. Interroga GET /v1/calls/{call_id} per lo stato in tempo reale (in_progress → completed / failed).

​
Effettua una chiamata con configurazione inline

Se vuoi un prompt una tantum che non vale la pena salvare come agente, passa invece config. La struttura corrisponde allo schema di risposta del webhook call.incoming:

​
Monitora la chiamata

In parallelo, iscriviti al webhook telephony.complete — il modo più rapido per sapere che una chiamata è terminata. Se non puoi accettare webhook in entrata, interroga GET /v1/calls/{call_id} ogni paio di secondi; il record include end_reason, duration_seconds e l’URL della registrazione una volta terminata la chiamata.

​
Modalità di errore da gestire

​
Controllare il tempo di attesa

Le chiamate in uscita che durano a lungo perché il destinatario risponde lentamente (alberi IVR, code) possono essere limitate con max_hold_seconds:
L’agente riaggancia se non riceve audio umano negli ultimi N secondi. Il valore predefinito è 900 (15 minuti).

​
Passaggi successivi

Riferimento delle chiamate in uscita

Tutti i campi della richiesta e i codici di errore.

Ricevere call.complete

Invia le chiamate in uscita completate al tuo sistema in streaming.

Fatturazione

Ricarica automatica affinché le chiamate in uscita non falliscano mai per saldo insufficiente.

Testare gli agenti in uscita

Esegui un test a secco del tuo agente in uscita prima della produzione.