Skip to main content
Stai creando il tuo primo agente a mano? La dashboard ti guida in questo esatto flusso — crea l’agente, aggiungi un numero, simula, rivedi — con una procedura guidata. Inizia dal quickstart della dashboard.
Il flusso canonico per “rispondere al telefono con un’IA”, dal tuo terminale. Dovrai:
  1. Creare un agente con un prompt e una voce.
  2. Provisionare (o portare) un numero di telefono e assegnare l’agente come gestore delle chiamate in entrata.
  3. Chiamare il numero. Osservare il registro chiamate, la trascrizione e la registrazione.
Chiamate API totali: quattro. Tempo totale: meno di cinque minuti.

​
1. Crea un agente

Un agente riunisce il prompt, la voce e il livello di prodotto che gestiranno la chiamata. Consulta Agenti per ogni campo di configurazione; il minimo è:
Salva l’id restituito — ti servirà nel passaggio 2.
Scegli spark per domande e risposte semplici al costo più basso, bolt quando la velocità conta più di tutto. Passa a storm-base-with-ack quando il tuo prompt richiede un ragionamento più approfondito e può tollerare mezzo secondo di riempitivo mentre il modello pensa. Consulta i livelli di prodotto.

​
2. Ottieni un numero di telefono

Se ti serve solo un numero da chiamare, provisiona un numero demo dal pool di ThunderPhone:
La risposta include un id e un number in formato E.164. I numeri demo iniziano con status="provisioning" e diventano active entro pochi secondi — esegui il polling di GET /v1/phone-numbers/{id} per monitorare la transizione, se ti interessa.
Per la produzione, evita i numeri demo e porta i tuoi numeri tramite VoIP. I numeri demo sono solo per le chiamate in entrata e hanno un volume limitato.

​
3. Assegna l’agente

Associa l’agente del passaggio 1 alla direzione in entrata del numero:
Tutto qui — il numero è attivo. Puoi anche impostare outbound_agent_id nello stesso PATCH, così il numero sarà pronto anche per effettuare chiamate in uscita.

​
4. Ricevi una chiamata

Chiama il numero dal tuo telefono. L’agente risponde, si presenta secondo il tuo prompt e la conversazione inizia. Mentre la chiamata è in corso, appare in GET /v1/calls con status="in_progress". Al termine, il record viene aggiornato con end_reason, duration_seconds, billable_minutes e, infine, un URL della registrazione e una valutazione IA.

​
5. Esamina i risultati

Recupera l’elenco delle chiamate recenti:
Recupera la trascrizione:
E l’URL della registrazione (firmato e di breve durata):
Se ti sei iscritto al webhook telephony.complete riceverai gli stessi dati come POST al tuo server — consulta call.complete.

​
Passaggi successivi

Configurazione dinamica per chiamata

Scegli un agente diverso per ogni chiamante in base al numero di telefono o a una logica personalizzata in un webhook.

Aggiungi integrazioni di strumenti

Consenti all’agente di chiamare le tue API durante la conversazione.

Ricevi webhook call.complete

Invia ogni chiamata completata al tuo CRM / flusso di analisi.

Valutazione AI e report sui problemi

Valuta automaticamente ogni chiamata e inoltra quelle segnalate per la revisione.