Descrição
Dataset que retorna números de telefones associados à pessoa consultada, com atributos de classificação, validação e priorização que apoiam análises de contato, segmentação, modelagem de dados e decisões automatizadas. O retorno inclui informações individuais dos telefones identificados e indicadores agregados consolidados.
Para mais informações sobre contexto de negócio, aplicações e casos de uso, consulte a documentação de Contatos.
Nome técnico do dataset: phones_extended.
Tabela de preços
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10.000 | R$ 0,060 |
| 10.001 - 50.000 | R$ 0,057 |
| 50.001 - 100.000 | R$ 0,054 |
| 100.001 - 500.000 | R$ 0,051 |
| 500.001 - 1.000.000 | R$ 0,049 |
| 1.000.001 - 5.000.000 | R$ 40.000,00 (preço fixo) |
| 5.000.001 e acima | Entre em contato |
Chaves complementares relevantes
As chaves abaixo representam algumas das chaves complementares aceitas que permitem refinar a consulta ou alterar a forma como os dados de telefone são analisados e retornados.
| Chave | Descrição | Valores Possíveis |
|---|---|---|
| phone | Telefone adicional utilizado para enriquecer ou refinar a consulta, independentemente da associação direta com o documento informado | Número de telefone |
| returnonlydifferentphones | Retorna apenas telefones diferentes dos informados na consulta | true, false |
| withmatchrate | Calcula o nível de similaridade entre o telefone informado e os telefones retornados | true, false |
Para conhecer todas as chaves disponíveis e entender como combiná-las, consulte a seção Parâmetros de Consulta.
Filtros
Os filtros abaixo permitem refinar os resultados retornados conforme características específicas dos telefones identificados.
| Campo | Descrição do filtro | Tipo do filtro | Valores Possíveis do Filtro |
|---|---|---|---|
| type | Tipo do telefone | Igual | mobile, work, home |
| isactive | Indica se o telefone está ativo | Igual | true, false |
| isrecent | Indica se o telefone é recente | Igual | true, false |
| ismain | Indica se o telefone é principal | Igual | true, false |
| isindonotcalllist | Indica se o telefone consta em listas de bloqueio | Igual | true, false |
| areacode | Código de área do telefone | Igual | 11, 21, 61, ... |
Limite
Este dataset permite limitar a quantidade de registros retornados utilizando o modificador .limit(x) no campo Datasets.
Para entender como aplicar filtros, limitar a quantidade de resultados, fazer paginação e personalizar o retorno dos dados, consulte a seção Personalizar Retorno.
Interpretando o campo ValidationStatus
ValidationStatusO campo ValidationStatus indica o resultado do processo de validação do número de telefone, refletindo a origem e a qualidade da informação verificada. Os possíveis valores e seus significados estão descritos na tabela abaixo.
| ValidationStatus | Descrição |
|---|---|
| FOUND IN ABRT | Número encontrado e validado na base da ABRT |
| NUMBER IN RANGE LIST | Formato válido, mas não validado junto à ABRT |
| NOT FOUND IN ABRT | Número não encontrado na base da ABRT |
| NUMBER NOT FOUND IN RANGE LIST | Número não encontrado na lista de faixas numéricas válidas |
| INVALID NUMBER LENGTH | O número possui comprimento inválido |
| AREA CODE DOESNT EXIST | O código de área informado não existe |
| INVALID NUMBER STRUCTURE | A estrutura do número é inválida |
| UNKNOWN | O status de validação não pôde ser determinado |
| (vazio) | O telefone ainda não passou pelo processo de validação |
| FOUND IN ALO BASE | Telefone válido na data da consulta. Atualmente não consultamos mais esta tabela — são dados históricos |
| NUMBER IN ALO LIST | Telefone válido na data da consulta. Atualmente não consultamos mais esta tabela — são dados históricos |
| NUMBER IN RANGE LIST BUT IS REPETITION OR SEQUENCE | Telefone válido na tabela da ABRT, mas com muitas repetições ou sequências numéricas, o que indica risco de ser uma informação incorreta. Para estes telefones, recomenda-se recorrer ao serviço de validação da relação documento/telefone junto às operadoras |
| NUMBER IS A SERVICE | O telefone é válido, mas trata-se de um número de serviço (ex: 0300, 0800), normalmente sem interesse para o cliente |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||