O que é o NumDetect?
O NumDetect é uma plataforma assíncrona de verificação de telefones em massa. Você envia uma lista de números no formato E.164, escolhe uma de cinco verificações independentes e baixa um arquivo de resultado quando a tarefa termina. Não há consulta de número único em tempo real aqui — todo produto é uma tarefa em segundo plano sobre uma lista inteira. As cinco verificações respondem a perguntas diferentes sobre a mesma lista: Validação de número de telefone retorna sinais de validade e ativação, Atividade do número e E-commerce ativo retornam a disponibilidade de um sinal de atividade, Usuários de alto valor retorna um sinal de público true/false e Consulta global de operadora acrescenta o contexto da operadora. Cada uma tem preço e execução separados; portanto, verificar uma lista com dois produtos significa duas tarefas e duas cobranças.
Qual produto devo escolher?
Escolha pela pergunta que você precisa responder, não por pacote. Validação de número de telefone verifica se os números são válidos e apresentam sinais de ativação — use-a para limpar uma lista antes de um contato. Atividade do número sinaliza registros com um sinal de atividade recente, para reativação e segmentação. E-commerce ativo sinaliza números com um sinal de atividade comercial observado, para listas de público e remarketing. Usuários de alto valor retorna um sinal true/false derivado de características de dispositivos de alto padrão e de atividade de rede recente. Consulta global de operadora acrescenta o contexto da operadora para listas internacionais, em todo o mundo e não apenas em um conjunto fixo de redes. Os produtos são independentes: executar dois deles sobre uma lista gera duas tarefas. Os preços por número estão na página de preços e na página de cada produto.
Como preparo e envio minha lista?
Use um .txt ou .csv com uma única coluna, um número por linha, no formato E.164 — sinal de mais, código do país e, em seguida, o número do assinante, sem espaços nem separadores. Cada tarefa aceita de 500 a 500.000 números e abrange um país: você seleciona esse país no envio, e todo número deve incluir o código do país e pertencer a ele — números sem código do país ou de outro país são deixados de fora e não são cobrados. Se restarem menos de 500 números válidos após a remoção de linhas inválidas e duplicadas, a tarefa é recusada e reembolsada integralmente; divida qualquer lista acima de 500.000 em várias tarefas. Guarde sua planilha original localmente — o arquivo de resultado traz as colunas próprias do produto, não colunas arbitrárias da sua origem.
Quanto tempo leva uma tarefa e como obtenho o resultado?
As tarefas são executadas em segundo plano, então você envia e volta depois, em vez de esperar com uma solicitação aberta. A duração depende do produto e do tamanho da lista; a página da tarefa mostra o status atual e uma previsão de conclusão. Quando a tarefa termina, você baixa um arquivo de resultado com as colunas declaradas pelo produto — por exemplo, Validação de número de telefone retorna number e activated, enquanto Consulta global de operadora retorna number, carrier, underlying_carrier, number_type, country_code, region e city. O conjunto de colunas não muda quando a fonte não tem nada para uma linha: as mesmas colunas voltam vazias, em vez de ausentes, para que seu parser veja um formato estável em todas as execuções.
Posso experimentar grátis primeiro?
Sim. Crie uma conta gratuita e fale com o suporte para receber crédito grátis que cobre 500 números — exatamente uma tarefa de tamanho mínimo, sem necessidade de recarga.
Como o preço é calculado?
Cada produto tem um preço por número; os valores estão na página de preços e na página de cada produto. Usuários pré-pagos e assinantes pagam o mesmo valor. Quando você envia uma tarefa, o custo estimado é reservado do seu saldo; na liquidação, a parte que a verificação não conseguiu responder é devolvida, então você paga pelos números que realmente retornaram. Cada tarefa aceita de 500 a 500.000 números — um arquivo abaixo desse mínimo é recusado no envio e nada é cobrado. O saldo permanente não expira nem se renova; um plano de 30 dias é renovado automaticamente a cada 30 dias até que a renovação automática seja desativada, o que interrompe cobranças futuras sem remover o plano ou o saldo atual.
O que significa um resultado ausente ou vazio?
Um campo vazio significa que a verificação não conseguiu responder para aquele número — não é uma resposta negativa nem prova de que o número é inválido ou inativo. As fontes de dados publicam o que publicam; a ausência de um sinal é ausência de evidência, não evidência de ausência. Trate linhas vazias como desconhecidas e decida separadamente se deve excluí-las. Os resultados também descrevem o que as fontes mostram no momento da execução; portanto, execute a lista novamente quando uma resposta atual for importante. Problemas no nível da tarefa são informados separadamente de linhas vazias: um arquivo recusado no envio não custa nada, e uma tarefa que falha enquanto o arquivo está sendo preparado não é enviada para verificação e é reembolsada integralmente — em ambos os casos, a mensagem explica o motivo.