API de eSIM

Construa a conexão completa.

Integre conectividade à sua aplicação por meio de um único modelo de serviço. Conecte o catálogo a uma compra autorizada, acompanhe o provisionamento e a instalação e ajude os clientes a gerenciar o serviço que compraram. Mantenha a experiência do cliente no controle da jornada.

Explore a plataforma de eSIM

Uma integração que você pode acompanhar

EXEMPLO

BIRD · CONECTIVIDADE

Um serviço. Registros conectados.

1

Descubra e selecione

Consulte cobertura, termos, preço e elegibilidade.

2

Compre e provisione

Acompanhe um pedido aceito até seu resultado.

3

Instale e use

Resolva a configuração privada e observe o primeiro uso.

Fluxo de integração ilustrativo. Siga o contrato atual da API para operações suportadas e comportamento de recuperação.

Comece pelo contrato

Modele o serviço que seu cliente está comprando.

Um perfil identifica o eSIM, um pacote descreve uma franquia e um pedido registra a compra. Uma assinatura recorrente adiciona períodos de cobrança e serviço contínuo. Conecte essas identidades na sua aplicação sem unificar seus estados distintos.

Leia antes de escrever

Descubra as ofertas e as capacidades efetivas para o cliente pretendido. Use preços publicados e elegibilidade atual em vez de manter um catálogo fixo separado no app.

Preserve a intenção aceita

Preserve a oferta selecionada e a identidade da solicitação ao longo da compra. Acompanhe o pedido existente após uma resposta incerta, para que a recuperação não se torne uma cobrança acidental duplicada.

Construa uma jornada completa

Conecte a compra a um dispositivo funcionando.

Acompanhe o pedido desde a aprovação financeira até o provisionamento e forneça um caminho privado de instalação. Reporte o resultado real em cada etapa em vez de marcar o cliente como conectado quando o checkout termina.

Mantenha as credenciais privadas

Resolva as credenciais de instalação pela experiência autorizada do cliente. Exclua-as de telemetria, Markdown público, relatórios de incidentes e mensagens de suporte geral.

Reaja ao estado observado

Use os eventos e leituras suportados para o serviço. Retenha os horários de observação, trate informações ausentes de forma explícita e permita que sua interface retome a partir do estado que realmente recebe.

Opere a integração

Faça da recuperação parte da implementação.

Teste uma compra, instalação e primeiro uso controlados, depois uma operação interrompida ou recusada. Use as mesmas identidades de serviço para conectar suporte, registros financeiros e mudanças de ciclo de vida.

Trabalhe com seu agente de código

Forneça ao agente a descrição atual da API e o guia de tarefas relevante. Peça que ele mapeie as operações suportadas, implemente o fluxo autorizado e mostre evidências do resultado completo para o cliente.

Leve a aquisição por toda a jornada

Mantenha os identificadores de campanha junto à aquisição e à transferência do cliente. Vincule-os à conversão de negócio registrada na sua aplicação; passar um parâmetro de query é apenas uma parte da atribuição.

Perguntas sobre a API de eSIM

A API de eSIM é apenas um endpoint de código de instalação?
Não. Uma integração útil também cobre descoberta de ofertas, compra, fulfillment, estado do serviço e gestão contínua. As credenciais de instalação são uma parte privada desse ciclo de vida.
Um agente de código consegue construir a integração?
Um agente pode trabalhar a partir da descrição atual da API, dos guias de tarefas e da sua aplicação. Faça-o inspecionar as operações suportadas e demonstrar uma jornada completa e controlada; não presuma que um método existe com base em um exemplo de marketing.
Como devemos lidar com uma resposta de compra incerta?
Mantenha a solicitação original e a identidade do pedido, depois use o comportamento de recuperação documentado para determinar o resultado. Iniciar uma nova compra pode gerar outra cobrança ou serviço.
O que incluir na medição de conversão?
Registre o resultado de negócio que você deseja otimizar, como uma compra concluída ou um primeiro uso verificado. Preserve o contexto de aquisição ao longo da transição relevante e vincule-o a esse resultado sem incluir credenciais privadas de instalação.

Coloque em prática.

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Obtenha um resumo de implementação

Comece com um caminho de integração completo.

Mapeie as operações de catálogo, compra e instalação suportadas para a sua aplicação. Ensaie a recuperação com o mesmo pedido antes de expandir a integração.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor