Antes de começar a usar os datasets do grupo de Contatos, é importante compreender alguns conceitos fundamentais que orientam a interpretação correta das informações retornadas pela API. Esses conceitos — como status de validade, prioridade e datas de referência — ajudam a contextualizar os dados recebidos, permitindo avaliar sua confiabilidade, relevância e atualidade.

A seguir, detalhamos os principais elementos que apoiam essa interpretação.

Dados inválidos e status

Os datasets do grupo Contatos podem retornar tanto contatos válidos quanto inválidos, variando conforme o tipo de informação (e-mail, telefone, endereço etc.) e os processos de validação específicos de cada categoria. Esses indicadores de status são mantidos no retorno porque, mesmo quando o contato é inválido, essa informação é altamente relevante em análises de risco, fraude, comportamento ou completude de dados.

Para contatos sujeitos à validação ativa — como e-mails ou telefones — o status pode mudar ao longo do tempo. No caso dos e-mails, por exemplo, os estágios finais do processo incluem a comunicação direta com o servidor responsável pelo domínio, e a resposta depende exclusivamente da configuração daquele servidor. Isso significa que situações comuns do dia a dia podem alterar a classificação de um contato, tais como:

Desativações temporárias (ex.: ausência prolongada da pessoa);
Contas corporativas que são desabilitadas e posteriormente reativadas;
Contatos cancelados e depois reativados para funções específicas, como spam traps;
Reconfiguração de servidores para modo accept-all, fazendo com que todos os endereços sob o domínio sejam considerados válidos;
Reativações motivadas por necessidade de preservar comunicações críticas.

Por esse motivo, o status de validade de um contato deve ser entendido como dinâmico, refletindo o estado mais recente da informação no momento da captura. A recomendação é realizar validações de forma recorrente, especialmente em processos que dependem fortemente da qualidade dos meios de contato.

Prioridade

Os datasets de Contatos oferecem mecanismos para ajudar a identificar, entre todos os contatos encontrados, quais tendem a ser os mais relevantes ou mais eficazes para uso em comunicação, enriquecimento ou processos operacionais.

O primeiro desses mecanismos é o atributo Prioridade (Priority), que atribui a cada contato uma ordem de relevância — quanto menor o número, maior a prioridade estimada pela BigDataCorp. Essa priorização leva em conta múltiplos fatores, como consistência do contato, estabilidade ao longo do tempo e força de associação com a entidade.

Além disso, cada passagem relacionada ao contato oferece insumos complementares. De modo geral:

Quanto mais passagens um contato possui com uma mesma entidade, maior tende a ser sua relevância.
A recência das passagens indica o quão atual aquele contato é.
A quantidade de entidades associadas a um mesmo contato pode ser um sinal importante: um telefone muito recente, mas compartilhado com dezenas de pessoas, talvez não seja o melhor ponto de contato.

Por fim, o próprio status de validação (quando aplicável) também informa sobre a utilidade prática do contato: um item fortemente associado à pessoa, mas marcado como inválido, dificilmente será adequado para comunicação ou tomada de decisão.

É importante ressaltar que a definição de “melhor contato” pode variar de acordo com o processo de negócio. Para alguns casos, o contato mais antigo é o ideal; em outros, o mais recente ou o mais recorrente. Os atributos disponibilizados permitem que cada cliente aplique sua própria lógica de priorização.

Linha do tempo do contato

Os datasets do grupo Contatos possuem alguns marcadores temporais associados a cada contato que indicam quando aquela informação foi observada, validada ou atualizada em nossas bases. Elas funcionam como pontos de contexto que permitem interpretar não apenas o valor do contato, mas também sua atualidade, estabilidade e relevância ao longo do tempo.

Esses marcadores podem incluir, por exemplo:

Data da primeira observação do contato nas fontes públicas;
Data da última observação em que o contato foi identificado novamente;
Data da última validação, quando aplicável (como no caso de e-mails ou telefones);
Data da última atualização do dado no processo interno de coleta ou processamento.

Eles permitem:

Avaliar a recência do contato;
Entender o histórico de estabilidade, ou seja, há quanto tempo aquele contato aparece em nossas fontes;
Acompanhar a evolução de status, identificando mudanças relevantes (por exemplo, um contato que se tornou inválido recentemente);
Comparar diferentes contatos entre si para definir prioridades de uso.

Assim como outros atributos, as linhas do tempo do contato devem ser interpretadas de acordo com o objetivo do seu processo. Um contato antigo pode ser excelente para análises históricas, enquanto um contato recém-observado pode ser mais adequado para ações operacionais que exigem informações atualizadas.