Atualizações silenciosas de autenticação na Verify API

Estamos introduzindo melhorias importantes no Autenticação Silenciosa na Verify API. Essas atualizações foram projetadas para melhorar a experiência dos desenvolvedores e dos testes, além de oferecer a você mais controle sobre os fluxos de autenticação.

Aqui está tudo o que você precisa saber e quais medidas tomar antes de 1º de maio de 2026.

Novo parâmetro `coverage_check`

Um dos desafios mais comuns da Autenticação Silenciosa é lidar com redes não compatíveis de maneira eficiente. Anteriormente, a validação da cobertura costumava ocorrer em uma etapa posterior do fluxo, o que podia causar redirecionamentos desnecessários. 

Ouvimos seus comentários e estamos aprimorando isso. Estamos adicionando um novo coverage_check parâmetro booleano à Verify API. 

Como funciona

coverage_check=true (padrão)

• Validação síncrona

• Se a rede for compatível, a API verifica se o aplicativo da Vonage está configurado corretamente, com a autenticação silenciosa ativada

• Se todas as verificações forem bem-sucedidas, o check_url é retornado

• Retorna um erro imediato se a rede não for compatível

• Evita fluxos de redirecionamento desnecessários

coverage_check=false 

• Comportamento assíncrono

• Sempre retorna um check_url

• Permite que você gerencie a validação de rede do seu lado

Observações importantes

• Se silent_auth for o único canal, uma rede não compatível gera um erro.

• Se um canal de failover estiver configurado, a solicitação recorre automaticamente ao próximo canal.

É necessário o registro na rede para a produção

Para melhorar as integrações com as operadoras e reduzir as tentativas de autenticação malsucedidas, o registro na rede está se tornando obrigatório para solicitações de Autenticação Silenciosa em produção.

Como configurá-lo

Você deve concluir o processo de Registro na Rede. 

O assistente irá ajudá-lo a criar os Perfis de Negócio e de Aplicação. Seu Perfil de Aplicação deve ter um Perfil de Aplicação de Rede com o status status “Aceito” (aprovado pelas operadoras de celular) e estar vinculado ao seu aplicativo da Vonage no Painel do Desenvolvedor.

Você pode seguir essas etapas no seu Painel do Desenvolvedor da Vonage:

1. Abra o Painel

2. Acesse Registro de Rede no menu à esquerda

3. Conclua o processo de inscrição

4. Ative o recurso “Registro de Rede” no seu Vonage Applications "Aplicativos"

Assim que estiver concluída, sua aplicação estará devidamente configurada para o tráfego de Autenticação Silenciosa em produção.

Então, o que vai acontecer depois de 1º de maio? 

Se for feita uma solicitação e o Perfil de Aplicação de Rede ainda não tiver sido aprovado pelas operadoras de telefonia móvel, será retornado um erro:

• Quando coverage_check=true, a solicitação é rejeitada de forma síncrona com um erro 412.

• Quando coverage_check=false, o erro é retornado de forma assíncrona por meio de um callback.

Descontinuação do parâmetro “sandbox”

Também estamos modernizando a forma como você testa a Autenticação Silenciosa. 

O sandbox parâmetro está sendo descontinuado. Daqui em diante, os testes devem ser realizados por meio do Network Registry Playground, que fornece tráfego em tempo real em um ambiente seguro e controlado.

O Playground oferece uma experiência de desenvolvimento significativamente aprimorada:

• Dados de tráfego em tempo real para APIs e países compatíveis, com até 5 números de telefone registrados. 

• Suporte de operadora virtual para testar a API nos países onde ela ainda não está disponível.

Em vez de depender de um sinalizador de solicitação, agora você dispõe de um ambiente de testes mais realista e robusto.

A migração para o novo Playground nunca foi tão fácil:

• Remova o sandbox parâmetro da sua integração com a Verify API.

• Siga as etapas descritas no guia do Network Registry Playground para habilitar o ambiente de testes em seu aplicativo Vonage. Não se esqueça de criar um novo aplicativo dedicado para uso no Playground. Um único aplicativo Vonage não pode suportar tanto o tráfego do Playground quanto o de produção.

O que acontecerá após 1º de maio? A API funcionará da seguinte maneira:

• Solicitações com sandbox=true retornarão um erro 422 Parâmetros inválidos. 

• Solicitações com sandbox=false (ou sem sandbox parâmetro) continuarão funcionando normalmente (o parâmetro será ignorado).

Lista de verificação de ações

Veja o que você precisa fazer antes de 1º de maio de 2026:

Para coverage_check

• Analise sua integração atual

• Escolha entre síncrono (true) ou assíncrono (false)

• Atualize suas chamadas de API de acordo com isso

Para registro na rede

• Confirme se o seu Perfil de Aplicação de Rede está devidamente vinculado

Sobre a descontinuação do Sandbox

• Pare de usar sandbox=true

• Migrar os testes para o Network Registry Playground

• Certifique-se de que os fluxos de trabalho de produção não dependam do parâmetro “sandbox”

Data de referência: 1º de maio de 2026

Nesta data:

• coverage_check ficar disponível (padrão: true)

• O registro na rede passa a ser obrigatório para o tráfego em tempo real

• sandbox=true retornará um erro 422. Use o Network Registry Playground em vez disso

Conclusão

A autenticação silenciosa continua a evoluir, tornando-se mais confiável, mais previsível e mais fácil de operar em grande escala. Essas atualizações refletem três objetivos principais:

• Melhorar a experiência do desenvolvedor. O coverage_check parâmetro reduz redirecionamentos desnecessários e fornece feedback imediato sobre redes não compatíveis.

• Melhor gestão da cobertura de rede. O registro obrigatório garante uma melhor integração com as operadoras e menos falhas de autenticação.

• Testes melhores. Substituir sandbox pelo Network Registry Playground proporciona um ambiente de testes mais realista e robusto.