Transportadora original

O recurso “Original Carrier” fornece informações de baixa latência sobre a operadora e o tipo de rede originalmente associados a um número de telefone, utilizando a inteligência do Plano de Numeração exclusivo da Vonage. Ele oferece metadados sem a necessidade de consultas em tempo real a fornecedores ou operadoras terceirizadas, tornando-o rápido e confiável para diversos casos de uso.

Embora essa informação se concentre na atribuição original, e não em quaisquer alterações posteriores — e, portanto, não reflita mudanças relacionadas à portabilidade —, ela continua sendo extremamente valiosa para identificar a natureza de um número de telefone. Ela pode indicar se um número foi inicialmente designado como celular, fixo, ligação gratuita, tarifa premium ou virtual — categorias frequentemente relevantes para a prevenção de fraudes, o controle de custos e a qualificação do usuário.

Os principais benefícios incluem:

• Sinais de risco de fraude: Identifique tipos de números virtuais, premium ou de alto risco que possam indicar suplantação de identidade ou tráfego inflado artificialmente.
• Relação custo-benefício: Evite entrar em contato com números caros ou inválidos logo no início do processo.
• Qualidade dos dados: Faça uma triagem prévia de leads e registros de clientes ao identificar a origem dos números.

O Original Carrier é ideal para empresas que buscam simplificar as comunicações, reduzir o tráfego artificialmente inflado e otimizar seus fluxos de trabalho baseados em números com inteligência leve.

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 Original 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 sobre a operadora original:

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": {
      "original_carrier": {}
        }
    }'

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

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "original_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.