# Migrare Voice da Vonage

Fai un inventario della generazione NCCO, dei webhook di risposta e di evento, delle operazioni di controllo chiamata REST, dell'instradamento dei numeri e delle integrazioni client. Registra dove la tua applicazione modifica una chiamata dopo che è iniziata.

## Mappa il comportamento delle chiamate

Traduci prompt, audio e decisioni da tastiera nel workflow di chiamata Bird scelto. Esamina separatamente la semantica di conversazione, connessione, registrazione e input. Mantieni il percorso originale finché il corrispondente percorso cliente non ha superato un test di chiamata controllata reale.

NCCO descrive il comportamento delle chiamate nel formato di Vonage. Traduci il risultato di ogni azione, poi verifica la gestione dell'input, i tempi dei webhook, la sorgente di registrazione e qualsiasi comportamento multi-party. Trovare una corrispondenza nel nome di un'azione non è sufficiente per stabilire un comportamento equivalente.

Usa la [guida alla progettazione della sequenza di chiamata](/docs/guides/voice/call-sequences) per pianificare i passi di chiamata definiti e la [guida all'integrazione vocale AI](/docs/ai/voice-conversations) per un runtime conversazionale.

## Prepara la connessione sostitutiva

Crea lo spazio di lavoro Bird, il trunk e l'identità di chiamata per un test controllato. Abilita la destinazione e configura autenticazione e impostazioni media nel client. Mantieni l'instradamento dei numeri esistente mentre valuti il nuovo percorso.

La portabilità di un numero telefonico non migra l'applicazione che ci sta dietro. Verifica la portabilità e la procedura di cutover prevista per ogni paese e tipo di numero. Prepara il nuovo instradamento in entrata prima di fare affidamento sullo spostamento del numero.

## Testa l'intero percorso cliente

Usa un numero che controlli e verifica questi risultati:

- Il client previsto si autentica e la destinazione di test squilla.
- L'audio funziona in entrambe le direzioni e la chiamata termina correttamente.
- Prompt e scelte da tastiera raggiungono il ramo previsto.
- Gli strumenti di business distinguono successo, fallimento e risultato incerto.
- Il record della chiamata e gli eventi si collegano al risultato nella tua applicazione.
- La registrazione o la trascrizione, quando richiesta, produce la prova prevista.

Testa anche una chiamata rifiutata e una dipendenza di business non disponibile, oltre al percorso di successo. Una richiesta accettata da sola non stabilisce una sostituzione funzionante.

## Sposta il traffico in modo deliberato

Conferma capacità, accesso e l'instradamento finale del numero. Mantieni un modo per ripristinare il percorso precedente mentre valuti il traffico iniziale. Conserva i record storici del provider e mantieni una mappatura verso l'identità cliente o attività della tua applicazione.

Riconcilia i costi tariffati al termine delle chiamate. Includi tutte le tratte pertinenti e qualsiasi servizio separato di elaborazione vocale, registrazione o modello quando confronti il nuovo workflow.

## Lavora con un coding agent

Incolla questo prompt nel tuo coding agent con l'integrazione che vuoi migrare. La procedura numerata inizia con un inventario e mantiene esplicite le modifiche in produzione.

```text
Help me evaluate a Voice migration from Vonage to Bird.
1. Read https://bird.com/docs/guides/voice/migrate/vonage.md. Use the .md alternatives of linked Bird guides for the steps below.
2. Check for a connected Bird MCP server or an installed, signed-in Bird CLI. Use whichever is available and discover its tools or command help. If neither is available, follow https://bird.com/docs/ai/set-up-your-agent.md. Do not invent operation names or install a second integration.
3. Perform a read-only inventory of my current call sites, numbers, SIP configuration, call-control instructions, event handlers, recordings, speech services and business tools. Identify secrets without printing them. Show the dependencies that stay with Vonage and the ones that need replacement.
4. Read https://bird.com/docs/guides/voice/sip-trunks.md, https://bird.com/docs/guides/voice/placing-calls.md and https://bird.com/docs/guides/voice/receiving-calls.md. Prepare the replacement connection and caller-identity requirements. Use https://bird.com/docs/guides/voice/call-sequences.md for defined menus and https://bird.com/docs/ai/voice-conversations.md for a conversational runtime. Verify each operation against the connected surface before proposing an executable step.
5. Prepare a test of one complete journey: setup, audio in both directions, keypad input, unanswered and failure paths, handoff where needed, and business-tool results. Show the exact target, configuration and expected cost before placing a call or recording audio; wait for my approval. Do not buy numbers, submit a port, change production routing or stop the existing provider without my explicit approval.
6. Use https://bird.com/docs/guides/voice/events.md and https://bird.com/docs/guides/voice/call-log.md to reconcile the outcome. Keep missing evidence and uncertain results visible. A spoken confirmation is not proof that a business action succeeded.
7. Return the integration differences, test evidence, unresolved requirements and rollback plan. Keep the current service running until I approve cutover. If a number port needs support, inspect the available support command or tool, prepare the exact request and ask for approval before submitting it. Return the ticket reference if authorized; a ticket does not schedule or complete a port.
```

## Riferimenti del fornitore

- [Documentazione chiamate Vonage](https://developer.vonage.com/en/voice/voice-api/technical-details)
- [Documentazione workflow Vonage](https://developer.vonage.com/en/voice/voice-api/ncco-reference)

## Prossimi passi

- [Trunk SIP](/docs/guides/voice/sip-trunks)
- [Eventi vocali](/docs/guides/voice/events)
- [Registro chiamate](/docs/guides/voice/call-log)

## 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)