# Progettare una sequenza di chiamata

Definisci i prompt, le scelte da tastiera, la registrazione e la conclusione di una chiamata prima di configurare l'applicazione che la gestisce. Segui la [guida ai trunk SIP](/docs/guides/voice/sip-trunks) per collegare l'applicazione a Bird.

## Definire il risultato per il chiamante

Scegli un risultato piccolo e osservabile. Un menu informativo può offrire gli orari di apertura su un tasto e le indicazioni stradali su un altro. Scrivi anche la risposta per il silenzio e per un tasto non riconosciuto, oltre alle scelte principali.

Mantieni le azioni di business esterne nell'applicazione o nel runtime conversazionale che le gestisce. Una conferma vocale non garantisce che un altro sistema abbia prenotato un appuntamento o modificato un ordine. Usa la [guida all'integrazione vocale AI](/docs/ai/voice-conversations) quando la conversazione dipende da strumenti e dialogo in tempo reale.

## Mappare i passaggi e le dipendenze

1. Assegna un nome al punto di ingresso e a ogni destinazione. Elenca i numeri di telefono e le applicazioni esterne che dipendono da essi.
2. Scrivi i prompt e prepara l'audio. Specifica se la pressione di un tasto deve interrompere il prompt o attendere che finisca.
3. Definisci i rami per le scelte da tastiera completate, il silenzio e l'input non riconosciuto. Assegna a ogni ramo una destinazione o una conclusione esplicita della chiamata.
4. Se l'applicazione registra una risposta, specifica quando la cattura inizia e termina, quale audio viene catturato e se è necessaria la trascrizione. Mantieni l'input sensibile fuori dalla finestra di cattura.
5. Verifica che l'applicazione collegata supporti il comportamento richiesto. Controlla la gestione dell'input, la registrazione e le operazioni di trasferimento prima di configurare il flusso.

Mantieni separati registrazione, elaborazione della trascrizione e risultato telefonico. La [guida alle registrazioni](/docs/guides/voice/recordings) copre consenso, accesso e revisione degli artefatti risultanti.

## Collegare l'applicazione

Crea un trunk e abilita la direzione di chiamata richiesta. Per le chiamate in ingresso, abilita le chiamate inbound, configura un gateway di consegna e associa un numero idoneo al trunk. La [guida alla ricezione delle chiamate](/docs/guides/voice/receiving-calls) copre l'instradamento dei numeri.

Per le chiamate in uscita, abilita le chiamate outbound e configura autenticazione, identità del chiamante e accesso alla destinazione. Usa la [guida alle chiamate SIP](/docs/guides/voice/placing-calls) per preparare la connessione.

Configura i prompt e il comportamento del menu nell'applicazione collegata. Individua le operazioni esposte dalla sua API, CLI o interfaccia di gestione e leggi gli schemi o la guida correnti prima di apportare modifiche. L’API di consultazione dei record delle chiamate di Bird documenta le operazioni di lettura; un esempio di lettura non è una richiesta di creazione chiamata.

## Testare prima di modificare la rotta di produzione

Usa un numero che controlli e una configurazione applicativa isolata. La [guida alla prima chiamata](/docs/guides/voice/first-call) copre la preparazione della connessione.

Testa input riconosciuto, silenzio, un tasto non corrispondente, prompt interrotti e riaggancio pulito. Verifica che ogni ramo raggiunga la risposta prevista. Controlla separatamente lo stato di registrazione e trascrizione quando il flusso li utilizza.

Coordina le modifiche durante il test e registra la configurazione testata. Mantieni disponibili la configurazione applicativa precedente e la rotta del numero per poterle ripristinare se il nuovo flusso fallisce. Il ripristino dell'instradamento non annulla un'azione di business già eseguita.

## Verificare il risultato della chiamata

Usa il [registro chiamate](/docs/guides/voice/call-log) per esaminare il risultato telefonico. Una chiamata con risposta, un menu completato e un'attività di business completata sono risultati separati. Riconcilia gli [eventi Voice](/docs/guides/voice/events) con il registro della chiamata quando gli aggiornamenti mancano o arrivano fuori ordine.

## Passaggi successivi

- [Instradare le chiamate in ingresso](/docs/guides/voice/receiving-calls)
- [Registrazioni e trascrizioni](/docs/guides/voice/recordings)
- [Conversazioni vocali AI](/docs/ai/voice-conversations)

## Related resources

- [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer)
- [Voice](/products/voice) (product)
- [Voice overview](/docs/guides/voice/overview) (docs)

[Get an implementation brief](/learn/workspace?topic=voice)