Operadora atual

A informação “Operadora atual” identifica a operadora de rede móvel à qual um determinado número de telefone está atribuído no momento. Ao contrário das informações baseadas na atribuição original, esse recurso reflete a portabilidade numérica, oferecendo informações atualizadas sobre a operadora à qual um número de telefone está associado.

Essa informação é essencial em situações em que a eficiência da comunicação, a capacidade de entrega e a verificação do usuário são fundamentais. Ao confirmar se um número está efetivamente atribuído a uma rede móvel, as empresas podem garantir o roteamento preciso de comunicações por SMS, voz ou dados. Isso permite que as organizações evitem custos desnecessários e ineficiências operacionais associadas ao contato com números desativados (não associados a nenhuma operadora) ou não móveis.

Um dos principais casos de uso inclui a limpeza e a atualização de bancos de dados de clientes, garantindo que as informações de contato estejam atualizadas e válidas. Por exemplo, identificar que um número não está mais vinculado a uma operadora de celular pode ajudar a evitar falhas na entrega de mensagens, reduzir o número de tentativas e manter um alto nível de engajamento do usuário. Isso também contribui para uma comunicação que respeita a privacidade, ao priorizar números de celular, que geralmente são mais pessoais e têm maior probabilidade de serem usados por um indivíduo, em comparação com linhas fixas, virtuais ou premium.

Nos processos de prevenção de fraudes e verificação de identidade, saber qual é a operadora de celular atual pode servir como um indicador para validar a legitimidade do usuário e reduzir o risco.

Ao aproveitar essas informações, as empresas obtêm maior controle sobre seus fluxos de trabalho de comunicação, melhoram a experiência do usuário e otimizam as estratégias de engajamento com base em dados analíticos sobre números de telefone em tempo real.

Pré-requisitos

Para usar o Identity Insights, você deve verificar se sua conta está configurada corretamente; consulte o Introdução guia para obter mais informações sobre:

• Criando seu account,
• Criação de uma aplicação da Vonage para uso com a API do Identity Insights,
• Os diferentes ambientes disponíveis e como configurar sua Account para utilizá-los,
• E como usar a interface de usuário “Introdução” do Painel de Controle para utilizar a API sem precisar escrever nenhum código.

Este guia explicará como utilizar o Current Carrier Insight programaticamente por meio do cURL.

Fazendo uma chamada de API

A autenticação na API do Identity Insights é feita por meio de JWTs, um token JSON compacto e autônomo. Para gerar um JWT, você pode usar nosso gerador online, ou, se preferir, use o CLI da Vonage. Você precisará do ID do seu aplicativo e da chave privada para gerar o JWT. Assim que tiver o JWT, poderá enviar uma solicitação à API.

Este exemplo mostra uma solicitação cURL para a informação “Operadora atual”:

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "current_carrier": {}
        }
    }'

A API retornará, então, informações sobre a rede à qual o número de telefone está atribuído no momento, incluindo o nome, o tipo de rede e o código do país:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "current_carrier": {
         "name": "Orange Espana, S.A. Unipersonal",
         "network_type": "MOBILE",
         "country_code": "ES",
         "network_code": "21403",
         "status": {
            "code": "OK",
            "message": "Success"
         }
      }
  }
}

Aqui, o status O objeto indica o status das informações retornadas para o número de telefone especificado:

Se status.code na resposta está OK, você também poderá ver os campos descritos na tabela abaixo. Se um campo estiver marcado como “Sim” na coluna “Obrigatório”, ele sempre será retornado quando o status for OK. Se um campo estiver marcado como “Não”, ele poderá ou não ser retornado.

Leitura complementar

• Saiba mais sobre a API do Identity Insights no Referência da API.
• Se tiver alguma dúvida, entre em contato conosco pelo Slack da Comunidade Vonage.