Documentação Técnica

Score de Risco

Descrição

O dataset Score de Risco auxilia na identificação de atividades potencialmente fraudulentas ao analisar o risco associado a um número de telefone. Para a requisição, deve-se enviar um número de telefone e, opcionalmente, um e-mail e/ou endereço de IP associado ao mesmo número de telefone. Os identificadores individuais são avaliados separadamente e, então, é retornado um score que informa o quão arriscada é a transação atual. Além do score, também é retornado um conjunto de códigos de razão de insights que fornecem uma inteligência mais detalhada e contextual sobre o comportamento digital que impulsiona o score de risco.

Origem da Informação

Os dados dos dispositivos são coletados e inferidos pela Telesign através dos seus diferentes canais de contato com indivíduos e empresas.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,380
10001 - 100000R$ 0,360
100001 - 500000R$ 0,320
500001 - 1000000R$ 0,270
1000001 - 10000000R$ 0,240
10000001 e acimaR$ 0,210

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
phoneNúmero de TelefoneQualquer número válido, com DDD. Ex.: 21991234567🛑 Obrigatório
account_lifecycle_eventEvento do ciclo da contacreate (para a criação de uma nova conta), sign-in (quando um usuário final faz login em sua conta), transact (quando um usuário final completa uma transação dentro de sua conta), update (quando uma atualização é realizada, como a atualização de informações da conta ou algo semelhante), delete (quando uma conta é excluída)🛑 Obrigatório
emailParâmetro opcional para auxiliar no cálculo do scoreQualquer textoℹ️  Opcional
ipParâmetro opcional para auxiliar no cálculo do scoreQualquer IP válidoℹ️  Opcional

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "partner_telesign_phone_score_person",
    "q": "phone{number}, account_lifecycle_event{event}"  
}  

Descrição das categorias do retorno

CategoriaDescrição
ScoreNível de risco associado a um número de telefone (acompanhado da descrição do risco e recomendações)
CategoryFornece uma conclusão global sobre o risco relativo apresentado pela transação, colocando a transação em uma categoria de risco
A2PMensagens de aplicativo para pessoa (a2p): mensagens automatizadas enviadas a uma pessoa, como códigos de verificação, lembretes de compromissos, etc.
P2PMensagens pessoa a pessoa (p2p): mensagens bidirecionais entre dois humanos, como um amigo enviando mensagens de texto para outro
Number TypeTipo de número de telefone
IPAtividade do endereço IP que você forneceu para este número de telefone
EmailAtividade do endereço de e-mail que você forneceu para este número de telefone

Descrição dos riscos e recomendação

Relação do significado da pontuação de risco, além da recomendação de ação e comentários adicionais explicando o porquê desse nível.

ScoreNível de RiscoRecomendaçãoComentários
1-200BaixoPermitirAinda não há dados suficientes para confirmar que existe uma grande probabilidade de a transação pertencer a um usuário genuíno
201-400Médio-BaixoPermitirA transação recebe o nível de risco “médio-baixo” porque tem atividade suficiente para sugerir que provavelmente pertence a um usuário genuíno
401-600MédioManter alertaTransação suspeita
601-800Médio-AltoBloquearTransação arriscada
801-1000AltoBloquearTransação arriscada

Descrição dos códigos de Category

CódigoNomeDescrição
10010Baixa atividadeNão há atividade ou atributos suficientes para classificar a transação como arriscada ou confiável
10020Baixa atividade regularCategoria confiável, baseada em comportamentos passados
10021Atividade regularCategoria mais confiável, baseada em comportamentos passados
10030Atividade irregular de baixo riscoCategoria de risco, baseada em comportamentos passados
10031Atividade irregular de médio riscoCategoria de alto risco, com base em comportamentos passados
10032Atividade irregular de alto riscoCategoria de maior risco, com base em comportamentos passados
10040Tipo de número irregularEste número possui atributos estáticos arriscados, como tipo de telefone VOIP ou estar em uma lista de bloqueio

Descrição dos códigos de A2P para Atividade

Códigos relacionados à quantidade de atividade observada para este número, em comparação com o que seria esperado de um bom usuário. Isto leva em consideração o número de transações de comunicação (chamadas, SMS, etc.) de ou para este número, a quantidade de números únicos comunicados e o número de contas comunicadas.

CódigoNomeDescrição
20001Nenhuma atividade de longo prazoAtividade muito menor do que o esperado(ou nenhuma) para este número nos últimos 90 dias. Não é possível classificar
20002Alta atividade de longo prazoAtividade mais do que esperada para este número nos últimos 90 dias
20003Alta atividade de curto prazoAtividade mais do que esperada para este número nas últimas 24 horas
20004Atividade moderada de longo prazoAtividade esperada para este número nos últimos 90 dias
20005Atividade moderada de curto prazoAtividade esperada para este número nas últimas 24 horas
20006Atividade escassa de longo prazoAtividade esparsa, volume regular de verificações neste número nos últimos 90 dias
20007Atividade contínua de longo prazoVolume contínuo e regular de verificações neste número nos últimos 90 dias
20008Atividade muito alta de longo prazoVolume muito alto de verificações neste número nos últimos 90 dias
20009Atividade muito alta de curto prazoVolume muito alto de verificações neste número nas últimas 24 horas
20010Sem atividadeVolume muito baixo de verificações (ou nenhuma) foi observada neste número
20011Atividade baixa de longo prazoBaixo volume de verificações neste número nos últimos 90 dias
20012Atividade baixa de curto prazoBaixo volume de verificações neste número nas últimas 24 horas. Volume muito baixo de verificações (ou nenhuma) nos últimos 90 dias
20013Atividade baixaMenos atividade do que o esperado para este número

Descrição dos códigos de A2P para Faixa

Códigos associados à avaliação da atividade de um intervalo de risco (uma sequência de números consecutivos) a que um número pertence, quando aplicável, em comparação com um usuário considerado bom.

CódigoNomeDescrição
20101Atividade sem faixaAtividade muito pequena (ou nenhuma) para uma faixa de risco à qual este número pertence nos últimos 90 dias. Também retornado se o número não pertencer a uma faixa de risco
20102Atividade de baixa faixaAlguma atividade para uma faixa de risco à qual este número pertence nos últimos 90 dias
20103Atividade moderada de curto prazo na faixaAtividade significativa para uma faixa de risco à qual este número pertence nas últimas 24 horas
20104Atividade moderada de longo prazo na faixaAtividade significativa para uma faixa de risco à qual este número pertence nos últimos 90 dias
20105Atividade alta de curto prazo na faixaAtividade muito significativa para uma faixa de risco à qual este número pertence nas últimas 24 horas
20106FaixaAtividade alta de longo prazo na faixa
20107FaixaAtividade muito alta de longo prazo na faixa
20108FaixaAtividade muito alta de curto prazo na faixa

Descrição dos códigos de A2P para Serviços Arriscados

Códigos relacionados ao quanto o número se comunicou com serviços de risco.

CódigoNomeDescrição
21001Atividade moderada em serviços arriscadosAtividade significativa deste número para ou proveniente de serviços arriscados nos últimos 90 dias
21002Alta atividade em serviços arriscadosAtividade muito significativa neste número para ou proveniente de serviços arriscados nos últimos 90 dias
21004Atividade de longo prazo em serviços arriscadosTráfego de verificação em serviços arriscados neste número nos últimos 90 dias
21005Atividade de curto prazo em serviços arriscadosTráfego de verificação em serviços arriscados neste número nas últimas 24 horas
21006Alta atividade de longo prazo em serviços arriscadosAlto volume de tráfego de verificação em serviços arriscados neste número nos últimos 90 dias
21007Alta atividade de curto prazo em serviços arriscadosAlto volume de tráfego de verificação em serviços arriscados neste número nas últimas 24 horas
21008Atividade de longo prazo na faixa em serviços arriscadosTráfego de verificação em serviços arriscados na faixa à qual este número pertence nos últimos 90 dias
21009Atividade de curto prazo na faixa em serviços arriscadosTráfego de verificação em serviços arriscados na faixa à qual este número pertence nas últimas 24 horas
21010Alta atividade de longo prazo na faixa em serviços arriscadosAlto volume de tráfego de verificação em serviços arriscados na faixa à qual este número pertence nos últimos 90 dias
21011Alta atividade de curto prazo na faixa em serviços arriscadosAlto volume de tráfego de verificação em serviços arriscados na faixa à qual este número pertence nas últimas 24 horas
21012Atividade muito alta de curto prazo em serviços arriscadosVolume muito alto de tráfego de verificação em serviços arriscados neste número nos últimos 90 dias
21013Atividade muito alta de longo prazo em serviços arriscadosVolume muito alto de tráfego de verificação em serviços arriscados neste número nas últimas 24 horas
21014Atividade muito alta de curto prazo na faixa em serviços arriscadosVolume muito alto de tráfego de verificação em serviços arriscados na faixa à qual este número pertence nos últimos 90 dias
21015Atividade muito alta de longo prazo na faixa em serviços arriscadosVolume muito alto de tráfego de verificação em serviços arriscados na faixa à qual este número pertence nas últimas 24 horas

Descrição dos códigos de A2P para Outros

Outros códigos A2P que não se enquadram nas subcategorias acima.

CódigoNomeDescrição
21003Atividade semelhante a máquinaPadrão de comportamento que sugere que este número está sendo usado por um bot. Embora esperemos que um número enviado envolvido em tráfego A2P se comunique com sistemas automatizados, não esperamos que o usuário desse número seja um sistema automatizado
21016Atividade de longo prazo semelhante a máquina na faixaVolume extremamente alto de tráfego de verificação em um período muito curto (menos de 1 hora) na faixa à qual este número pertence

Descrição dos códigos de A2P para Atualizações

Códigos de motivo relacionados ao tempo em que o número esteve ativo.

CódigoNomeDescrição
22001Visto nas últimas 24 horasEste número foi visto no tráfego de verificação nas últimas 24 horas
22007Visto nas últimas 7 diasEste número foi visto no tráfego de verificação nas últimas 7 dias
22015Visto nas últimas 15 diasEste número foi visto no tráfego de verificação nas últimas 15 dias
22101Visto no último mêsEste número foi visto no tráfego de verificação no último mês
22102Visto nos últimos 2 mesesEste número foi visto no tráfego de verificação nos últimos 2 meses
22103Visto nos últimos 3 mesesEste número foi visto no tráfego de verificação nos últimos 3 meses
22203Visto há mais de 3 mesesEste número não foi visto no tráfego de verificação nos últimos 3 meses

Descrição dos códigos de P2P

CódigoNomeDescrição
30201Análise sem dados P2POs dados P2P não foram analisados. Não é possível classificar

Descrição dos códigos de Number Type

CódigoNomeDescrição
40001Número premiumEste é um número premium
40002Número VOIPEste é um número VOIP
40003Número gratuitoEste é um número gratuito
40004Número inválidoEste é um número inválido
40005Número de orelhãoEste número está associado a um orelhão
40006Número de caixa postalEste é um número de caixa postal
40007Número de pagerEste número está associado a um pager
40008Tipo de telefone de alto riscoEste número tem outro tipo de telefone que é arriscado e que não é coberto por nenhum dos outros códigos de motivo do tipo de número
40009Operadora de alto riscoEste número está associado a uma operadora muito arriscada
40010Operadora de médio riscoEste número está associado a uma operadora arriscada
40011Prefixo de alto riscoEste número tem um prefixo arriscado
40012Telefone muito longoEste número é inválido porque é muito longo, mesmo após a aplicação de regras de limpeza
40013Número na lista negraEste número foi marcado como uma fonte de fraude. A inteligência sempre recomenda bloquear este número
40014País de alto riscoO código do país deste número pertence a um país de alto risco, que origina uma parcela desproporcional de ataques de fraude
40015Número técnicoEste número é usado para fins técnicos especiais por empresas de telecomunicações, como para roaming
40016Número usado por aplicativoA Telesign reservou este número para uso por clientes com nossos aplicativos (por exemplo, para enviar mensagens de verificação), mas parece que está sendo usado para um propósito diferente
40017Número na lista branca do clienteVocê marcou este número como seguro. A inteligência sempre recomenda permitir este número
40018Telefone muito curtoEste número é muito curto para ser um número de telefone válido

Descrição dos códigos de IP

CódigoNomeDescrição
50001Atividade moderada de curto prazoNível esperado de atividade para este endereço IP nas últimas 24 horas
50002Atividade moderada de longo prazoNível esperado de atividade para este endereço IP nos últimos 90 dias
50003Atividade moderada de curto prazo em serviços arriscadosAtividade significativa para este endereço IP de ou para serviços arriscados nas últimas 24 horas (veja os serviços arriscados acima para a definição desse termo)
50004Atividade moderada de longo prazo em serviços arriscadosAtividade significativa para este endereço IP de ou para serviços arriscados nos últimos 90 dias (veja os serviços arriscados acima para a definição desse termo)
50005Atividade alta de curto prazoMais atividade do que o esperado para este endereço IP nas últimas 24 horas
50006Atividade alta de longo prazoMais atividade do que o esperado para este endereço IP nos últimos 90 dias
50007Atividade alta de curto prazo em serviços arriscadosAtividade muito significativa para este endereço IP de ou para serviços arriscados nas últimas 24 horas (veja os serviços arriscados acima para a definição desse termo)
50008Atividade alta de longo prazo em serviços arriscadosAtividade muito significativa para este endereço IP de ou para serviços arriscados nos últimos 90 dias (veja os serviços arriscados acima para a definição desse termo)
50009Atividade muito alta de curto prazoMudanças muito frequentes nos atributos do endereço IP no tráfego de verificação deste número nas últimas 24 horas
50010Atividade muito alta de longo prazoMudanças muito frequentes nos atributos do endereço IP no tráfego de verificação deste número nos últimos 90 dias
50011Atividade de curto prazo em serviços arriscadosMudanças nos atributos do endereço IP no tráfego de verificação de serviços arriscados neste número nas últimas 24 horas
50012Atividade de longo prazo em serviços arriscadosMudanças nos atributos do endereço IP no tráfego de verificação de serviços arriscados neste número nos últimos 90 dias
50013Atividade muito alta de curto prazo em serviços arriscadosMudanças muito frequentes nos atributos do endereço IP no tráfego de verificação de serviços arriscados neste número nas últimas 24 horas
50014Atividade muito alta de longo prazo em serviços arriscadosMudanças muito frequentes nos atributos do endereço IP no tráfego de verificação de serviços arriscados neste número nos últimos 90 dias
50015Proxy anônimoEste endereço IP está associado a proxies anônimos, que podem ajudar a ocultar as verdadeiras origens do tráfego online
50016VPNEste endereço IP está associado a redes privadas virtuais (VPNs), que podem ajudar a ocultar as verdadeiras origens do tráfego online
50017Provedor de hospedagemEste endereço IP está associado a servidores de hospedagem na web, que têm um padrão de atividade diferente dos usuários finais genuínos
50018Nó de saída do TOREste endereço IP está associado a navegadores anônimos Tor, que podem ajudar a ocultar as verdadeiras origens do tráfego online

Descrição dos códigos de Email

CódigoNomeDescrição
60001Atividade moderada de curto prazoNível esperado de atividade para este endereço de e-mail nas últimas 24 horas
60002Atividade moderada de longo prazoNível esperado de atividade para este endereço de e-mail nos últimos 90 dias
60003Atividade moderada de curto prazo em serviços arriscadosAtividade significativa para este endereço de e-mail de ou para serviços arriscados nas últimas 24 horas (consulte os serviços arriscados acima para a definição desse termo)
60004Atividade moderada de longo prazo em serviços arriscadosAtividade significativa neste endereço de e-mail de ou para serviços arriscados nos últimos 90 dias (consulte os serviços arriscados acima para a definição desse termo)
60005Atividade alta de curto prazoMais atividade do que o esperado para este endereço de e-mail nas últimas 24 horas
60006Atividade alta de longo prazoMais atividade do que o esperado para este endereço de e-mail nos últimos 90 dias
60007Atividade alta de curto prazo em serviços arriscadosAtividade muito significativa para este endereço de e-mail de ou para serviços arriscados nas últimas 24 horas (consulte os serviços arriscados acima para a definição desse termo)
60008Atividade alta de longo prazo em serviços arriscadosAtividade muito significativa neste endereço de e-mail de ou para serviços arriscados nos últimos 90 dias (consulte os serviços arriscados acima para a definição desse termo)
60009Atividade muito alta de curto prazoVolume muito alto de tráfego de verificação neste endereço de e-mail nas últimas 24 horas
60010Atividade muito alta de longo prazoVolume muito alto de tráfego de verificação neste endereço de e-mail nos últimos 90 dias
60011E-mail gerado por máquinaPadrão de comportamento que sugere que este endereço de e-mail está sendo usado por um programa de software
60012E-mail inválidoEste endereço de e-mail é inválido e não poderia ter sido usado por um usuário final genuíno
60013Domínio de e-mail descartávelEste endereço de e-mail pode ter se originado de um serviço que fornece endereços de e-mail temporários; esses endereços temporários podem ser usados para ocultar a identidade do usuário final
Language
Credentials
Click Try It! to start a request and see the response here!