# Migrar Voice desde Vonage

Inventaría la generación de NCCO, los webhooks de respuesta y eventos, las operaciones de control de llamada de REST, el enrutamiento de números y las integraciones de cliente. Registra en qué punto tu aplicación modifica una llamada después de iniciarla.

## Mapea el comportamiento de llamada

Traduce los prompts, el audio y las decisiones de teclado al flujo de llamada de Bird elegido. Revisa por separado la semántica de conversación, conexión, grabación y entrada. Mantén la ruta original hasta que el recorrido del cliente correspondiente haya superado una prueba real de llamada controlada.

NCCO describe el comportamiento de llamada en el formato de Vonage. Traduce el resultado de cada acción y luego verifica el manejo de entrada, la temporización de webhooks, el origen de la grabación y cualquier comportamiento multipartito. Coincidir con el nombre de una acción no basta para establecer un comportamiento equivalente.

Usa la [guía de diseño de secuencia de llamada](/docs/guides/voice/call-sequences) para planificar pasos de llamada definidos y la [guía de integración de voz con IA](/docs/ai/voice-conversations) para un entorno conversacional.

## Prepara la conexión de reemplazo

Crea el espacio de trabajo, el trunk y la identidad de llamada de Bird para una prueba controlada. Habilita el destino y configura la autenticación y los ajustes de medios en el cliente. Mantén el enrutamiento de números existente mientras evalúas la nueva ruta.

La portabilidad de un número telefónico no migra la aplicación detrás de él. Confirma la portabilidad y el procedimiento de corte esperado para cada país y tipo de número. Prepara la nueva ruta de entrada antes de depender del traslado del número.

## Prueba el recorrido completo del cliente

Usa un número que controles y verifica estos resultados:

- El cliente previsto se autentica y el destino de prueba suena.
- El audio funciona en ambas direcciones y la llamada termina correctamente.
- Los prompts y las opciones de teclado llegan a la rama esperada.
- Las herramientas de negocio distinguen éxito, fallo y resultado incierto.
- El registro de llamada y los eventos se conectan con el resultado en tu aplicación.
- La grabación o transcripción, cuando se requiere, produce la evidencia esperada.

Prueba también una llamada rechazada y una dependencia de negocio no disponible, además de la ruta exitosa. Una solicitud aceptada por sí sola no establece un reemplazo funcional.

## Mueve el tráfico de forma deliberada

Confirma la capacidad, el acceso y la ruta de número final. Mantén una forma de restaurar la ruta anterior mientras evalúas el tráfico inicial. Conserva los registros históricos del proveedor y mantén un mapeo con la identidad de cliente o tarea de tu aplicación.

Concilia los costos tarifados una vez que las llamadas terminen. Incluye todos los tramos relevantes y cualquier servicio separado de voz, grabación o modelo al comparar el nuevo flujo.

## Trabaja con un agente de código

Pega este prompt en tu agente de código junto con la integración que quieres migrar. El procedimiento numerado comienza con un inventario y mantiene explícitos los cambios en producción.

```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.
```

## Referencias del proveedor

- [Documentación de llamadas de Vonage](https://developer.vonage.com/en/voice/voice-api/technical-details)
- [Documentación de flujos de Vonage](https://developer.vonage.com/en/voice/voice-api/ncco-reference)

## Próximos pasos

- [Trunks de SIP](/docs/guides/voice/sip-trunks)
- [Eventos de voz](/docs/guides/voice/events)
- [Registro de llamadas](/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)
