Sign inGet Started

Instalar e compartilhar um eSIM

Use este guia depois que seu pedido for concluído. Você precisa de permissão para ler credenciais de instalação, um dispositivo compatível desbloqueado e uma conexão de internet funcionando nesse dispositivo. Verifique a regra de ativação do pacote antes de instalar para saber quando a validade começa.

1. Abra a página de instalação

Abra o perfil em eSIMs e selecione Install. Escolha iPhone ou Android para exibir as instruções correspondentes. Mantenha esta página privada: o QR code e os detalhes de ativação podem instalar o eSIM.

Um eSIM em modo de teste contém credenciais de exemplo para testes de integração. Essas credenciais não conseguem instalar um perfil nem ativar serviço em um telefone.

2. Envie a configuração para outra pessoa

Se outra pessoa for usar o eSIM, volte à página de detalhes e selecione Send install link em Install link deliveries. Escolha Email ou SMS, informe o destinatário pretendido e selecione Send link. A atribuição por si só não envia os detalhes de instalação. Para enviar um link de instalação após cada nova compra com um contato vinculado, ative Automatically send install links after purchase em eSIM settings. Essa opção fica desativada por padrão. O link é enviado por email, ou por SMS se o contato não tiver um endereço de email. O destinatário abre o link e seleciona Show installation details sem entrar em um workspace.

Verifique Install link deliveries para conferir o destinatário, o status de entrega e a Link expiry. Uma mensagem na fila ainda não confirmou a entrega, e a entrega não confirma a instalação. Se o envio estiver desativado, verifique Send install credentials to travelers em eSIM Settings e suas permissões de credenciais.

Qualquer pessoa com o link hospedado pode acessar os detalhes de instalação até que ele expire ou seja revogado. Se você enviou para a pessoa errada, use Revoke para esse destinatário na Danger zone do eSIM. A revogação interrompe o acesso futuro pelo link; credenciais já reveladas e perfis já instalados continuam utilizáveis.

Para seu próprio fluxo de entrega, crie um link de instalação hospedado pela API e compartilhe-o de forma privada. Use a expiração retornada para decidir se um link existente ainda é adequado para envio.

3. Instalar o perfil

Conecte o telefone desejado a uma rede Wi-Fi ou a um hotspot e escolha um método na página de instalação:

MétodoO que fazer
Escanear um QR codeExiba a página de instalação em outra tela. No iPhone, escaneie com a Câmera e abra a notificação de plano celular. No Android, abra as configurações de SIM, escolha adicionar um eSIM e escaneie o código.
Instalar neste telefoneAbra a página no telefone que usará o eSIM. Expanda Install on this phone e selecione o botão para abrir a configuração do iPhone ou Android. Se a configuração não abrir, use QR ou entrada manual.
Inserir detalhes manualmenteExpanda Enter details manually. No iPhone, insira o valor do campo SM-DP+ address e o código de ativação identificado como o ID correspondente. No Android, insira o código de ativação completo. Siga as etapas de configuração manual exibidas na página.

Siga as instruções do dispositivo para concluir a adição do perfil. Insira um código de confirmação se a página fornecer um; caso contrário, deixe esse campo vazio. Os nomes dos menus no Android variam conforme o dispositivo.

4. Conectar aos dados móveis

Dê um nome reconhecível à linha instalada e selecione-a para dados móveis. Se a página de instalação instruir você a ativar o roaming de dados, ative-o para este eSIM. Se um APN for fornecido e a configuração manual for necessária, copie esse valor nas configurações de rede do eSIM.

Em um destino coberto, desligue o Wi-Fi brevemente e abra uma página da web para testar os dados móveis. Uma compra concluída ou um perfil instalado não confirma uma conexão móvel funcionando. Em um dispositivo dual-SIM, verifique se o teste de dados usa a linha pretendida.

Volte à página de detalhes do eSIM para revisar Device installation e Data packages. Relatórios de instalação e atualizações de saldo podem atrasar em relação ao resultado no dispositivo; guarde os IDs do eSIM e do pedido caso precise de suporte.

Solução de problemas

ProblemaPróximo passo
O link de instalação não chegouVerifique o destinatário e o status de entrega antes de reenviar.
O link hospedado expirou ou foi revogadoEnvie um novo link para o eSIM existente após confirmar o destinatário.
O telefone rejeita o perfilVerifique a compatibilidade do dispositivo e o status de bloqueio da operadora. Registre o erro exato e entre em contato com o suporte antes de excluir o perfil ou tentar outro dispositivo.
O perfil foi instalado, mas não tem dadosVerifique a linha de dados selecionada, o país coberto, a validade do pacote e as instruções de roaming e APN fornecidas. Siga o guia de recuperação de serviço.

Se os detalhes de instalação estiverem temporariamente indisponíveis, reabra o eSIM existente. Essa falha não significa que a compra falhou. Mantenha QR codes, códigos de ativação e links privados de instalação fora de mensagens públicas, ferramentas de analytics e anotações de suporte rotineiras.

Próximos passos

Continue com a documentação, guias e exemplos sobre este tópico.