API do Identity Insights agora em versão beta

Observação: A API do Identity Insights já está disponível para o público em geral! Saiba mais sobre ela em nosso anúncio de lançamento.

Estamos muito animados em anunciar que nossa novíssima API Identity Insights já está disponível na versão beta! Este lançamento representa um grande avanço para ajudar os desenvolvedores a aproveitar os recursos interessantes da Rede Móvel relacionados à análise de números de telefone. 

O que é a API do Identity Insights?

A API Identity Insights permite que as marcas criem jornadas do cliente sem atritos, seguras e personalizadas, com informações em tempo real sobre a operadora, o dispositivo e o assinante por trás de cada número de telefone.

Diagram showing how the Identity Insights API connects phone data from operators and regulatory authorities to customer journeys for fraud prevention and personalization

• Solicite qualquer combinação dos conjuntos de atributos disponíveis (Insights) em uma única chamada de API.

• Projetado para ser discreto, sem complicações e transparente para o titular do número de telefone.

• Adote novos recursos com facilidade a partir de um único ponto de acesso.

• Expanda instantaneamente seu alcance para centenas de operadoras e autoridades regulatórias em todo o mundo — sem precisar gerenciar interconexões, métodos de integração ou complexidades de conformidade. Nós cuidamos de tudo isso para você.

Explore a lista completa de Insights disponíveis na documentação técnica.

O que você pode fazer com o Identity Insights

O Identity Insights pode oferecer suporte a muitos outros casos, dependendo das suas necessidades. Aqui estão alguns casos de uso comuns:

Fortalecer a verificação de identidade e combater a fraude

Os fraudadores utilizam troca de cartões SIM, phishing e identidades falsas para contornar a segurança. A API Identity Insights ajuda a detectar sinais de fraude em tempo real, como trocas recentes de cartões SIM ou tipos de números suspeitos, para que as empresas possam reforçar a autenticação apenas quando necessário, reduzindo o risco sem causar atritos.

Validar números de telefone para uma comunicação confiável

Nem todos os números são iguais. Verifique instantaneamente se um número possui um formato válido, uma operadora de celular atribuída e se é adequado para a finalidade pretendida (por exemplo, se é possível entrar em contato com o cliente por Voice, SMS, RCS, ou notificação por aplicativo) para evitar problemas de conformidade, reduzir custos de mensagens e melhorar a qualidade dos dados no momento do cadastro.

Otimize o engajamento e aprimore os dados dos clientes

Utilize informações de telefonia em tempo real (como fuso horário, operadora ou tipo de linha) para personalizar suas abordagens, aumentar o engajamento e tomar decisões mais inteligentes, como segmentação de usuários e personalização.

Como funciona a API do Identity Insights?

Quando você faz uma solicitação à API do Identity Insights, ela identifica a melhor fonte para obter os dados, consultando centenas de operadoras de telefonia móvel e autoridades regulatórias em todo o mundo, e retorna as informações para você em tempo real.

Isso simplifica a complexidade de lidar com diversas normas, integrações e exigências regulatórias em diferentes regiões.

Você só precisa se concentrar nas informações necessárias e em como interpretá-las para tomar decisões bem fundamentadas.

Você pode usar qualquer combinação de insights em uma única chamada de API; por exemplo, esta solicitação retornará os insights de Formato e Troca de SIM:

curl -X POST https://api-eu.vonage.com/v0.1/identity-insights \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
   "phone_number": "447009000000",
   "purpose": "FraudPreventionAndDetection",  
   "insights": {
      "format": {},
      "sim_swap": {
         "period": 240
      }
    }
  }'

A resposta conterá, então, os resultados das duas solicitações de análise:

{
   "request_id": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
   "insights": {
      "format": {
         "country_code_iso2": "GB",
         "country_code_iso3": "GBR",
         "country_name": "United Kingdom",
         "country_prefix": "44",
         "offline_location": "United Kingdom",
         "time_zones": [
                "Europe/Guernsey",
                "Europe/Isle_of_Man",
                "Europe/Jersey",
                "Europe/London"
            ],
         "number_international": "447920000000",
         "number_national": "07920 000000",
         "format_valid": true,
         "status": {
            "code": "OK",
            "message": "Success"
         }
      },
      "sim_swap": {
         "latest_sim_swap_at": "2024-07-08T09:30:27.504Z",
         "swapped": true,
         "status": {
            "code": "OK",
            "message": "Success"
         }
      }
   }
}

Experimente!

É fácil começar:

1. Visite nosso Portal do Desenvolvedor

2. Crie um Account / Use suas credenciais existentes

3. Configure o ambiente e crie um novo aplicativo

4. Faça sua primeira chamada de API

   1. Como usar o painel

   2. Usando o cURL

Dê uma olhada nas especificações da API.

E agora?

Nos próximos meses, vamos:

• Ampliando cobertura geográfica.

• Adicionando novos insights, como correspondência de assinantes, verificação de localização, status de roaming e status de acessibilidade.

• Descontinuando APIs legadas que se sobrepõem, como Number Insights v2 e SIM Swap Standalone.

Animado para começar a usar a API do Identity Insights? Participe da Comunidade da Vonage no Slack e nos ajude a moldar essa API novinha em folha! Você pode participar do #network-apis e receber as últimas atualizações diretamente da equipe. Além disso, entre em contato conosco se tiver dúvidas ou preocupações sobre a migração das APIs Number Insight ou Sim Swap.