O que os dias de atividade do Telegram significam nos resultados em lote
Entenda o valor activedays nos resultados em lote do TG Validator, por que ele pode ser aproximado e como priorizar listas de contatos.
Uma explicação prática sobre o valor activedays nos resultados de verificação em lote do Telegram e como utilizá-lo como um sinal de priorização.
Os dias de atividade do Telegram, retornados como activedays em certos resultados em lote, representam o número de dias desde a última atividade de uma conta. O Telegram nem sempre expõe um horário exato de "visto por último", portanto, o valor pode ser aproximado. As equipes utilizam esse dado para classificar números registrados em grupos mais recentes ou mais antigos, e não para confirmar se uma pessoa está online ou se responderá.
O que o valor activedays representa
No TG Validator, activedays pertence aos produtos de atividade em lote e de perfil. Ele expressa os dias desde a última atividade de uma conta que a verificação identificou como registrada. Um número baixo sugere atividade recente; um número alto sugere que a conta está inativa há mais tempo.
O valor é aproximado quando o Telegram oculta o horário exato de "visto por último". A página de ajuda do Telegram explica o motivo: os usuários escolhem quem pode ver seu status de "visto por último", e as pessoas que não têm permissão para vê-lo recebem apenas uma faixa aproximada, como recentemente, dentro de uma semana, dentro de um mês ou há muito tempo (Telegram FAQ). Como esse modelo de privacidade obscurece o sinal subjacente, trate activedays como um dado de classificação geral, e não como um registro de data e hora preciso.
Duas limitações mantêm a precisão do número:
- Trata-se de dias desde a última atividade, não de presença online em tempo real.
- Não faz parte da verificação de número único em tempo real, que retorna apenas o status de registro no Telegram.
Quais serviços em lote retornam activedays
Os dados de atividade provêm de tipos específicos de serviços assíncronos em lote. Escolha o serviço de acordo com a pergunta que sua equipe precisa responder.
| Tipo de serviço em lote | Entrada | O que é retornado |
|---|---|---|
| tg_batch | Números de telefone | Apenas registro |
| tg_active_batch | Números de telefone | Registro, uid, nome de usuário e activedays |
| tg_profile_batch | Números de telefone | Adiciona URL de avatar e estimativas baseadas no avatar |
| tg_username_batch | Nomes de usuário | Se a conta do nome de usuário existe |
| tg_username_profile_batch | Nomes de usuário | Adiciona uid, activedays e URL de avatar |
Se a lista precisa apenas de uma divisão entre registrado ou não registrado, tg_batch é suficiente. Se a equipe também deseja classificar contatos registrados por recência, utilize tg_active_batch para números de telefone ou tg_username_profile_batch para nomes de usuário. Algumas colunas no result.csv dependem do tipo de serviço e podem estar vazias para uma determinada linha; portanto, crie uma lógica de processamento que suporte campos em branco.
Como usar activedays ao priorizar uma lista
O padrão mais útil é converter o número bruto em algumas categorias definidas pela sua própria equipe. Os limites abaixo são exemplos de uma escolha interna, não uma regra do produto.
- Recentemente ativo: um pequeno número de dias. Coloque esses registros primeiro em uma fila de abordagem manual.
- Moderadamente inativo: um intervalo intermediário. Mantenha-os na fila normal com um contato mais leve.
- Muito tempo inativo: um grande número de dias. Mova-os para uma lista de menor prioridade ou de reengajamento.
- Valor vazio: mantenha o registro, marque-o como desconhecido e evite tratá-lo como inativo.
Como o número pode ser aproximado, categorias amplas funcionam melhor do que limites rígidos. Separar 3 dias de 4 dias implicaria uma precisão que os dados não possuem. Agrupe por semana ou mês e revise a distribuição de uma amostra antes de aplicá-la à lista completa.
Além disso, mantenha o resultado do registro separado. Um número que não está registrado não tem nada a ser classificado, portanto, remova-o da análise de atividade e trate-o por meio do seu fluxo de trabalho normal de dados de contato.
Erros comuns ao ler dados de atividade
A maioria dos problemas surge ao exigir que o valor prove mais do que ele pode.
- Ler como presença. Um número pequeno não significa que a pessoa está online agora ou que responderá a uma mensagem.
- Ler como identidade. Nem activedays nem o registro confirmam quem é o proprietário da conta ou se a pessoa concordou em ser contatada. Gerencie o consentimento por meio do seu próprio processo.
- Tratar campos em branco como zero. Uma célula vazia significa que o valor não foi retornado para aquela linha.
- Comparar com a verificação em tempo real. A verificação em tempo real do Telegram retorna apenas o status de registro, portanto, não procure por atividade nela.
- Criar limites complexos demais. Como o valor pode ser aproximado, categorias simples são mais fáceis de defender e manter.
Os produtos de perfil adicionam estimativas baseadas em avatar sobre idade, gênero e cor de pele.
Para regras de faturamento e uso aplicáveis a tarefas em lote, leia a página de preços atual e a documentação da API, em vez de confiar em números copiados para outros documentos.
Fluxo de trabalho simples do upload à decisão
Comece limpando a lista para que cada linha contenha um número de telefone ou um nome de usuário em um arquivo TXT ou CSV. Tarefas de números de telefone precisam de um país e códigos de país internacionais, enquanto tarefas de nomes de usuário não precisam de país e aceitam nomes com ou sem o sinal @. Envie o arquivo pelo painel ou pelo endpoint de tarefas em lote, consulte a tarefa não mais do que uma vez a cada 30 segundos e baixe o result.csv quando a tarefa indicar sucesso.
Em uma planilha ou script, filtre primeiro pelas linhas registradas e, em seguida, agrupe pelas categorias de activedays. Compare os tamanhos das categorias, decida quais grupos merecem atenção manual e registre a escolha para que a próxima lista seja tratada de forma consistente. Feito dessa maneira, activedays ajuda a informar a priorização enquanto os limites do sinal permanecem visíveis para todos que utilizam o resultado.
Perguntas frequentes
activedays é o mesmo que estar online agora?
Não. É o número de dias desde a última atividade de uma conta registrada e pode ser aproximado. Não é um indicador de presença em tempo real.
Quais serviços em lote incluem activedays?
tg_active_batch retorna esse valor para números de telefone e tg_username_profile_batch retorna para nomes de usuário. tg_batch retorna apenas o registro.
Como as equipes podem lidar com linhas onde activedays está vazio?
Mantenha a linha, rotule a atividade como desconhecida e baseie-se no resultado do registro. Evite tratar um valor vazio como prova de inatividade.
Por que activedays pode ser aproximado?
O Telegram permite que cada usuário limite quem pode ver seu horário exato de "visto por último", portanto, o sinal subjacente pode ser uma faixa ampla. Agrupe registros em categorias amplas em vez de limites rígidos.
Saiba mais
Escolha as informações do produto que se adequam à próxima etapa do seu fluxo de trabalho.