# Planeje sua integração eSIM

O acesso público ao API de eSIM ainda não está disponível. Este guia ajuda você a preparar um resumo de integração para um [especialista em eSIM](/demo?product=esim-api). Confirme o acesso e obtenha o contrato API suportado antes de implementar requisições ou designar um agente para construir a integração.

## Defina o cliente e o serviço

Identifique quem compra o serviço, quem usa o dispositivo e quem paga. Uma compra de viagem pode pertencer a uma única conta de cliente. Um serviço corporativo também precisa de uma atribuição a uma pessoa e um responsável que possa aprovar alterações.

Liste os registros que sua aplicação precisa conectar: a compra, o perfil instalado e sua franquia. Um serviço móvel recorrente também precisa do relacionamento contínuo do plano do assinante. Esses são requisitos para confirmar com o contrato do serviço receptor.

## Especifique o resultado da compra

Decida onde os clientes veem a oferta selecionada, a cobertura, a validade e o preço publicado. Mantenha a moeda cotada intacta. Sua aplicação não deve reconstruir uma tarifa para o cliente a partir de custos de atacado ou de uma conversão de moeda estimada.

Para cada compra, defina o que o cliente vê após a aceitação, o cumprimento ou a recusa. Inclua um caso de resposta perdida no resumo de integração. Confirme como o API identifica uma operação existente antes de projetar uma nova tentativa que possa gerar outra cobrança.

Um checkout concluído não comprova que um dispositivo instalou ou usou o serviço. Mantenha esses resultados separados na jornada do cliente.

## Planeje a instalação e o suporte

Escolha os dispositivos suportados e a pessoa responsável por ajudar o cliente a se conectar. As credenciais de instalação precisam de um canal de entrega privado e autorizado. Mantenha-as fora de analytics, exemplos públicos e capturas de tela de suporte.

Liste as informações de que o cliente precisa após a compra: instruções de configuração, o plano adquirido, observações de franquia e um contato de suporte. Confirme quais estados e tempos de observação o serviço pode fornecer antes de projetar a exibição de status.

## Acorde a checklist de implementação

Peça ao seu especialista Bird para confirmar os mercados, as ofertas elegíveis, os requisitos de acesso e as operações publicadas para o seu caso de uso. Obtenha as definições de requisição e resposta, os requisitos de autorização, o comportamento de nova tentativa e os métodos de instalação suportados.

Quando o contrato estiver disponível, forneça ao seu agente de codificação o contrato e o modelo de identidade da sua aplicação. Faça-o rastrear uma compra até o resultado confirmado e cobrir uma requisição recusada e uma resposta incerta. Teste com uma conta e um dispositivo explicitamente autorizados antes de oferecer o serviço aos clientes.

## Conecte a aquisição ao resultado

Preserve o contexto de campanha permitido ao longo do cadastro e da jornada do cliente na sua aplicação. Defina qual resultado registrado contará como conversão, como uma compra concluída ou um primeiro uso verificado. Um identificador de campanha em uma URL de cadastro, sozinho, não prova que uma compra posterior foi atribuída.

## Próximos passos

- [Planeje uma oferta de viagem](/docs/guides/esim/travel)
- [Prepare a instalação](/docs/guides/esim/installation)
- [Defina o suporte ao serviço](/docs/guides/esim/operations)
- [Opções de integração eSIM](/products/esim/api)

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