# Migrar Voice do Bandwidth

Faça o inventário de realms, credenciais, prioridades de rotas de entrada, pesos de endpoints, atribuições de números de telefone e qualquer comportamento separado de Programmable Voice. Para uma integração com IA, registre o runtime e suas regras de origem de entrada separadamente da conexão com a operadora.

## Mapeie o comportamento de chamadas

Mapeie a conexão de saída do cliente e a rota de entrada do número como operações separadas. Preserve o comportamento de chamada voltado ao cliente no PBX, o sistema telefônico corporativo que roteia chamadas, ou no runtime do assistente que você pretende manter. Confirme como autenticação, identidade do chamador e configurações de mídia mudam antes de mover o tráfego.

Você pode avaliar uma mudança de conexão mantendo a aplicação se os requisitos de SIP, autenticação e mídia forem compatíveis. Reconfigure a conexão deliberadamente e verifique chamadas de entrada e saída, identidade do chamador, áudio e transferência. Uma integração existente não é prova de compatibilidade com um novo caminho de operadora.

Use o [guia de design de sequência de chamadas](/docs/guides/voice/call-sequences) para planejar etapas de chamada definidas e o [guia de integração de voz com IA](/docs/ai/voice-conversations) para um runtime conversacional.

## Prepare a conexão substituta

Crie o espaço de trabalho, o trunk e a identidade de chamada Bird para um teste controlado. Habilite o destino e configure autenticação e mídia no cliente. Mantenha o roteamento de números existente enquanto avalia o novo caminho.

A portabilidade de um número de telefone não migra a aplicação por trás dele. Confirme a portabilidade e o procedimento de virada esperado para cada país e tipo de número. Prepare a nova rota de entrada antes de depender da mudança do número.

## Teste a jornada completa do cliente

Use um número que você controla e verifique estes resultados:

- O cliente pretendido se autentica e o destino de teste toca.
- O áudio funciona nas duas direções e a chamada encerra corretamente.
- Prompts e escolhas do teclado chegam à ramificação esperada.
- Ferramentas de negócio distinguem sucesso, falha e resultado incerto.
- O registro da chamada e os eventos se conectam ao resultado na sua aplicação.
- Gravação ou transcrição, quando necessárias, produzem a evidência pretendida.

Teste uma chamada recusada e uma dependência de negócio indisponível, além do caminho de sucesso. Uma solicitação aceita sozinha não comprova uma substituição funcional.

## Mova o tráfego deliberadamente

Confirme capacidade, acesso e a rota final do número. Mantenha uma forma de restaurar a rota anterior enquanto avalia o tráfego inicial. Preserve registros históricos do provedor e mantenha um mapeamento para a identidade de cliente ou tarefa da sua aplicação.

Reconcilie os custos tarifados após as chamadas terminarem. Inclua todos os trechos relevantes e quaisquer serviços separados de fala, gravação ou modelo ao comparar o novo fluxo de trabalho.

## Trabalhe com um agente de código

Cole este prompt no seu agente de código com a integração que você quer migrar. O procedimento numerado começa com um inventário e mantém as mudanças de produção explícitas.

```text
Help me evaluate a Voice migration from Bandwidth to Bird.
1. Read https://bird.com/docs/guides/voice/migrate/bandwidth.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 Bandwidth 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.
```

## Referências do fornecedor

- [Documentação de chamadas do Bandwidth](https://dev.bandwidth.com/docs/voice/sip-trunking/sip-getting-started/)
- [Documentação de workflows do Bandwidth](https://dev.bandwidth.com/docs/voice/integrations/vapi/)

## Próximos passos

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