Orientação de produto
Como realizar uma verificação de entregabilidade de e-mail em lote em uma lista preparada
Prepare uma lista TXT ou CSV, inicie uma tarefa em lote assíncrona, monitore o status e classifique o arquivo de resultados em entregável, não entregável e indeterminado.
Um fluxo de trabalho passo a passo para a verificação de e-mail em lote com o EmailCheckPro: prepare o arquivo, inicie a tarefa, monitore o status e utilize o arquivo de resultados.
A verificação de e-mail em lote com o EmailCheckPro é uma tarefa assíncrona. Prepare um arquivo TXT ou CSV simples com um endereço completo por linha, envie-o como uma tarefa em lote, monitore a tarefa até que ela seja concluída e faça o download de um CSV com os resultados. Cada endereço é relatado como entregável (ele poderia receber e-mail no momento da verificação) ou não entregável. Endereços que não puderam ser processados, como domínios do tipo catch-all, permanecem como indeterminado e são tratados separadamente. A verificação não envia nada para nenhum endereço da lista.
Prepare a lista antes de uma verificação de e-mail em lote
A maioria das execuções com falha ou desperdício começa no arquivo, não na verificação. Antes de enviar, siga esta pequena lista:
- Use apenas TXT ou CSV. Um endereço completo por linha, com uma parte local, um sinal de @ e um domínio. Formatos de planilha como XLSX não são aceitos, portanto, exporte para CSV primeiro.
- Remova espaços em branco e erros de digitação óbvios. Um espaço perdido ou um domínio ausente torna a linha inutilizável.
- Remova duplicatas sempre que possível. Linhas inválidas e duplicadas são removidas durante a preparação, mas limpá-las você mesmo mantém a contagem que você espera.
- Mantenha um produto por arquivo. Um arquivo de entregabilidade e um arquivo de avatar são tarefas diferentes. A Verificação de avatar de e-mail aceita apenas endereços Gmail, Yandex e Mail.ru, portanto, uma lista mista deve ser usada na tarefa de entregabilidade.
- Verifique os limites por produto. O tamanho do arquivo e a contagem de endereços variam de acordo com o produto; a documentação da API lista os limites atuais.
Mantenha a exportação original intacta. Você unirá os resultados a ela posteriormente.
Inicie a tarefa e monitore o status
As tarefas em lote são enviadas com POST /api/v1/bulk-tasks, carregando o arquivo preparado. A chamada não retorna resultados; ela cria uma tarefa que é executada em segundo plano. Essa é a principal diferença em relação ao trabalho em tempo real: uma verificação única e uma verificação síncrona de vários endereços respondem na mesma chamada, enquanto uma tarefa em lote é algo que você consulta posteriormente.
Verifique o progresso com GET /api/v1/bulk-tasks/{id}. Não monitore com frequência superior a 30 segundos; um intervalo menor adiciona solicitações sem fazer com que a tarefa termine mais rápido. Quando o status relatar sucesso, a resposta conterá um link de download para um CSV. Esse link permanece válido por 12 horas, e consultar a mesma tarefa novamente o atualiza, portanto, uma janela perdida não significa um resultado perdido.
Se a preparação falhar, por exemplo, porque um arquivo contém conteúdo não suportado, a tarefa não prossegue para uma cobrança. Corrija o arquivo e envie novamente.
Leia o CSV de resultados
A tarefa de entregabilidade retorna um CSV. Ele associa cada endereço a um sinalizador que indica se ele era entregável. A tarefa de avatar adiciona uma coluna para um avatar público e um link para ele; o link pode estar vazio mesmo quando um avatar foi encontrado.
Classifique as linhas em três grupos:
| Grupo | Significado no momento da verificação | Ação típica |
|---|---|---|
| Entregável | O endereço poderia receber e-mail | Manter na lista |
| Não entregável | O endereço não poderia receber e-mail | Suprimir ou corrigir |
| Indeterminado ou ausente | Nenhum resultado concluído, por exemplo, um domínio catch-all | Manter separadamente; não tratar como nenhum dos vereditos |
Uma linha ausente ou indeterminada não é um veredito de não entregável. Apenas resultados concluídos são faturáveis, portanto, linhas indeterminadas não são cobradas.
Coloque os resultados em prática
Una o CSV de resultados à sua exportação original na coluna de endereço e, em seguida, escreva o veredito em um campo no seu CRM ou ferramenta de envio, em vez de excluir linhas. Isso mantém uma trilha de auditoria e permite que você execute novamente apenas os registros que mudaram.
Dois hábitos ajudam. Primeiro, execute a verificação próxima ao envio ou importação, pois um resultado descreve o endereço no momento da verificação e não diz nada sobre seu status futuro. É uma entrada para a higiene da lista, juntamente com seus próprios registros de supressão e consentimento.
Para acompanhamentos menores, como algumas centenas de novos cadastros, uma chamada síncrona de vários endereços de 1 a 100 endereços é mais simples do que uma nova tarefa em lote.
Perguntas frequentes
Como as equipes podem saber quando uma tarefa em lote foi concluída?
Monitore o endpoint de status da tarefa em um intervalo de 30 segundos ou mais. Quando o status relatar sucesso, a resposta incluirá um link para o CSV de resultados. O link dura 12 horas e pode ser atualizado consultando a mesma tarefa novamente, portanto, não há necessidade de fazer o download imediatamente.
O que acontece com as linhas que não são endereços válidos?
Linhas inválidas e duplicadas são removidas enquanto o arquivo é preparado. Um formato inválido não é um veredito de não entregável; ele simplesmente não é um endereço verificável. Limpar o arquivo de antemão mantém a contagem preparada próxima ao que a equipe espera.
Uma tarefa em lote pode ser iniciada a partir de um cliente de IA via MCP?
Nenhuma ferramenta de tarefa de arquivo em lote está documentada para o endpoint MCP. O MCP suporta verificações únicas, até 100 endereços por chamada, listagem de produtos e consultas de saldo. As tarefas de arquivo em lote usam o fluxo de trabalho da Web ou a API REST.
Saiba mais
Escolha as informações do produto que se ajustam à próxima etapa do seu fluxo de trabalho.