# Migrare Voice da Vapi

Inventaria gli assistenti, le impostazioni di modello e voce, gli strumenti personalizzati, il comportamento delle chiamate trasferite e la connessione telefonica attuale. Decidi se il progetto modifica la connessione con l'operatore, il runtime dell'assistente o entrambi.

## Mappa il comportamento delle chiamate

Per una modifica solo telefonica, mantieni il comportamento conversazionale dell'assistente nel suo runtime e valida la nuova connessione SIP. Per una sostituzione del runtime, riproduci i permessi degli strumenti, il comportamento di interruzione e i risultati di business confermati come progetto separato.

Possono svolgere ruoli complementari quando i requisiti SIP e media dell'integrazione coincidono. Bird può fornire la connessione telefonica mentre un runtime dell'assistente gestisce la conversazione. Valida entrambe le direzioni di chiamata, l'identità del chiamante, l'audio e il trasferimento prima di fare affidamento su quella configurazione.

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 le impostazioni di autenticazione e media nel client. Mantieni l'instradamento dei numeri esistente mentre valuti il nuovo percorso.

Il porting di un numero telefonico non migra l'applicazione che lo utilizza. Conferma la portabilità e la procedura di cutover prevista per ogni paese e tipo di numero. Prepara la nuova rotta in ingresso prima di fare affidamento sullo spostamento del numero.

## Testa l'intero percorso del 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.
- I prompt e le 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 richieste, producono l'evidenza prevista.

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

## Sposta il traffico in modo deliberato

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

Riconcilia i costi tariffati al termine delle chiamate. Includi tutti i tratti rilevanti e qualsiasi servizio separato di voce, registrazione o modello quando confronti il nuovo flusso di lavoro.

## 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 Vapi to Bird.
1. Read https://bird.com/docs/guides/voice/migrate/vapi.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 Vapi 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 Vapi](https://docs.vapi.ai/advanced/sip)
- [Documentazione workflow Vapi](https://docs.vapi.ai/tools/default-tools)

## Passi successivi

- [Trunk SIP](/docs/guides/voice/sip-trunks)
- [Eventi Voice](/docs/guides/voice/events)
- [Log delle 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)
