# Planeje uma migração de conectividade a partir do Gigs

Planeje a migração em torno do serviço ativo do cliente. Preserve as informações necessárias para entender os compromissos existentes e defina o que pode ser transferido antes de pedir ao assinante que mude qualquer coisa.

## Pré-requisitos

Prepare o acesso autorizado ao seu projeto Gigs, um espaço de trabalho Bird, os contatos comerciais e de suporte relevantes e uma pequena coorte de avaliação. Faça o inventário dos serviços ativos e das obrigações de pagamento. Confirme que as ofertas Bird pretendidas atendem aos requisitos de cada cliente.

## 1. Faça o inventário do relacionamento existente

Mapeie o identificador do cliente para o usuário, assinatura, plano, SIM e registros de portabilidade do provedor. Registre o estado atual do serviço e a próxima renovação ou expiração. Mantenha os acordos de pagamento vigentes e o histórico de suporte acessíveis às equipes que precisam deles.

Trate uma credencial de instalação como um segredo. Ela não pertence a uma planilha de comparação exportada nem a um prompt de agente. Use referências e acesso autorizado para trabalho operacional.

## 2. Defina o serviço de destino

Selecione o mercado de destino, os serviços inclusos, a franquia e os termos comerciais. Confirme a compatibilidade do dispositivo e se é necessária uma nova instalação de perfil. Se o cliente vai manter o número de celular, confirme o processo de portabilidade suportado e as informações exigidas do serviço doador.

Um plano com nome parecido não é um contrato idêntico. Revise cobertura, políticas de velocidade, validade, renovação, cancelamento e quaisquer obrigações remanescentes do cliente antes de selecionar o substituto.

## 3. Mapeie comportamentos, não nomes de API

Mapeie descoberta de plano, compra, provisionamento, instalação, uso, recargas e alterações de serviço para a integração documentada do Bird. Preserve a distinção entre uma solicitação do cliente, seu resultado financeiro e o serviço de rede resultante.

Para uma integração assistida por agente, forneça os contratos de origem aprovados e um mapa de campos anonimizado. Peça ao agente de código para identificar operações não suportadas e resultados ambíguos antes de implementar adaptadores. Não permita que ele infira um mapeamento um-para-um apenas a partir dos nomes de recursos.

## 4. Ensaie uma transição controlada

Use um cliente de teste aprovado e um dispositivo compatível. Siga a compra de destino, a instalação privada e qualquer portabilidade necessária. Verifique os dados inclusos, as chamadas recebidas e realizadas e as mensagens separadamente.

Exercite a instalação interrompida, observações atrasadas e uma recusa de solicitação recuperável. Verifique o que o assinante vê e o que a equipe de suporte pode fazer. Mantenha um pedido existente em investigação quando o resultado for incerto, em vez de criar outra compra.

## 5. Faça o rollout com um plano de saída

Convide uma coorte delimitada somente após o caminho de migração e as instruções ao cliente serem verificados. Monitore a conclusão, as necessidades de suporte e os relacionamentos financeiros ativos. Encerre o serviço anterior de acordo com seus termos e somente quando a transição acordada permitir.

Registre quem pode pausar o rollout e como os clientes restantes mantêm o serviço. Um rollback pode exigir uma nova operação de serviço; alterar uma configuração de aplicação não restaura todos os perfis ou transferências de número.

## Solução de problemas

Se um perfil não puder ser movido, use o caminho de nova instalação acordado. Se uma portabilidade for recusada, siga os requisitos informados e os registros do doador. Se houver uso faltando, inspecione a atualização das observações separadamente do estado de compra e serviço.

## Referências do provedor

Use o [guia de assinaturas do Gigs](https://developers.gigs.com/docs/create-a-subscription), o [guia de SIM](https://developers.gigs.com/docs/core/sims) e o [processo de portabilidade](https://developers.gigs.com/docs/porting/how-porting-in-works) para entender o serviço de origem.

## Inicie uma avaliação assistida por agente

Forneça ao seu agente de código este prompt com os contratos aprovados e um inventário anonimizado. Mantenha as credenciais nas ferramentas autorizadas, fora do prompt.

```text
Assess a migration from Gigs to Bird eSIM for this application.

1. Discover the repository instructions and authorized read-only tools.
   Read https://bird.com/docs/guides/esim/migrate/gigs.md and
   https://bird.com/docs/guides/esim/api.md. Inspect the current Gigs
   integration and the Bird contracts supplied for this evaluation.
2. Inventory customers, subscriptions, plans, SIM references, billing,
   installation and porting behavior. Use redacted references. Do not
   retrieve or print installation credentials, payment data or tokens.
3. Map each operation to a documented destination. Separate supported
   operations from requirements that still need Bird confirmation.
   Do not invent an API from a similarly named resource.
4. Propose the customer journey, compatibility checks, idempotent
   purchase handling, delayed observations and recovery paths. Identify
   service continuity and financial obligations for a bounded cohort.
5. Produce a reviewable integration plan, test cases and unresolved
   questions. Stop for explicit approval before changing live accounts,
   buying or activating service, moving numbers, cancelling subscriptions,
   changing billing, or sending customer invitations.
```

## Próximos passos

- [Compare Bird com Gigs](/products/esim/compare/bird-vs-gigs).
- [Prepare uma integração de eSIM com Bird](/docs/guides/esim/api).
- [Guie a instalação no dispositivo](/docs/guides/esim/installation).
- [Planeje a portabilidade de número de celular](/docs/guides/esim/number-porting).

## Related resources

- [What is an eSIM?](/explained/esim/what-is-an-esim) (answer)
- [eSIM](/products/esim) (product)
- [eSIM connectivity guide](/docs/guides/esim/overview) (docs)

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