Verifique e-mails do Airtable sem plugin

O Airtable é onde muitas equipes guardam seus contatos — um formulário de inscrição alimenta uma base, uma Interface coleta leads, uma importação de CSV despeja a lista de participantes do evento da semana passada. Mas o campo de e-mail do Airtable só verifica se um endereço parece correto; ele não consegue dizer se a caixa de correio realmente existe, se é um descartável, ou se vai dar hard bounce logo no seu primeiro envio. Este guia mostra duas formas práticas de verificar e-mails do Airtable com a Qualisend: em tempo real, com uma automação que roda um script curto a cada novo registro, e em massa, exportando uma visualização para CSV. Nenhuma delas precisa de um plugin nativo — ainda não existe um — apenas as automações nativas do Airtable ou seu botão de exportação.

A resposta curta#

Escolha o caminho que combina com quando você precisa da resposta:

• Tempo real — construa uma Automação do Airtable com uma ação Executar um script. A cada novo registro (ou registro atualizado), ela lê o e-mail, chama a API da Qualisend com fetch e grava o veredito de volta em um campo na mesma linha. O registro agora carrega um status e um score que você pode filtrar, agrupar e rotear.
• Em massa — exporte uma tabela ou visualização para CSV, passe-a pela verificação em massa da Qualisend e reimporte o arquivo limpo para preencher uma coluna de status em tudo que já está na sua base.

Por que o campo de e-mail do Airtable não é suficiente#

O tipo de campo Email do Airtable roda uma checagem de formato — ele garante que há um @, um domínio e nenhum lixo óbvio. Essa é a mesma classe de checagem que um regex faz, e ela falha pelos mesmos motivos: formato não é entregabilidade. jane@gmial.com passa na checagem de formato. throwaway@mailinator.com também, e um endereço de aparência real em um domínio que desligou silenciosamente no ano passado também passa.

Nenhum deles é pego até você enviar — e, a essa altura, um endereço morto é um hard bounce que corrói a sua taxa de bounce e a reputação de remetente. A verificação de verdade adiciona as camadas que uma planilha não tem: uma consulta de DNS/MX e uma sondagem de caixa de correio via SMTP, além de sinalizadores para endereços descartáveis, de função (role) e catch-all. Se esse pipeline é novo para você, o que a verificação de e-mail realmente checa é a introdução.

Duas formas de verificar e-mails do Airtable#

A restrição importante primeiro: a verificação acontece depois que uma linha existe, não como um portão inline no formulário ou na Interface que a criou. O Airtable não tem uma forma suportada de bloquear um envio no meio do preenchimento com uma chamada a uma API externa, então você verifica o registro no momento em que ele chega e depois age sobre o veredito — e isso molda ambos os caminhos abaixo.

A maioria das equipes acaba fazendo os dois: um script na captação ao vivo, mais uma limpeza de lista ocasional para pegar endereços que ficaram obsoletos desde que foram adicionados.

Caminho 1: tempo real com uma automação do Airtable#

As Automações do Airtable podem rodar um trecho de JavaScript com uma ação Executar um script, e esse trecho pode chamar uma API externa com fetch — tudo o que você precisa para verificar um registro sem sair do Airtable.

1. Escolha o gatilho. Em Automações, crie uma e escolha um gatilho:

• Quando um registro é criado — a escolha mais simples para um formulário ou Interface que anexa novas linhas.
• Quando um registro corresponde a condições (por exemplo, Status do e-mail está vazio) — bom para pular linhas que você já verificou.
• Quando um registro entra em uma visualização — aponte-a para uma visualização filtrada por Status do e-mail = vazio para que reexecuções nunca cobrem em dobro pelo mesmo endereço.

2. Adicione a ação "Executar um script" e configure duas variáveis de entrada no painel esquerdo da ação: mapeie email para o campo de e-mail do registro que disparou o gatilho, e recordId para o ID de registro do Airtable desse registro. O script as lê através de input.config().

3. Escreva o script. Ele chama a Qualisend e, em seguida, grava o veredito de volta na mesma linha. Confirme o endpoint exato e o formato da requisição em na documentação para desenvolvedores — os espaços reservados abaixo são seus para preencher:

// Airtable automation → "Run a script" action.
// Input variables (set in the action's left panel):
//   email     → the triggering record's email field
//   recordId  → the triggering record's record ID
let { email, recordId } = input.config();

let table = base.getTable("Contacts");

try {
  let response = await fetch("https://api.qualisend.com/v1/verify", {
    method: "POST",
    headers: {
      // Use a scoped, verify-only key — see the note below on key safety.
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ email }),
  });

  // Response shape: { result: { status, score, reason, sub_flags } }
  let { result } = await response.json();

  await table.updateRecordAsync(recordId, {
    "Email status": result.status, // text: deliverable / risky / undeliverable / unknown
    "Email score": result.score,   // number: 0–100
  });
} catch (err) {
  // Fail open: never lose a contact if the API is briefly unreachable.
  await table.updateRecordAsync(recordId, { "Email status": "unknown" });
}

Algumas coisas tornam isso robusto e seguro:

• Use uma chave com escopo. Os scripts de automação do Airtable armazenam a chave no texto do script, onde qualquer colaborador da base pode lê-la, e não há um cofre de segredos do lado do servidor para um trecho como este. Então gere uma chave com escopo somente de verificação para esta automação em vez de uma de acesso total — se ela algum dia vazar, só poderá verificar endereços e nada mais. A documentação para desenvolvedores mostra como limitar o escopo de uma chave. Este é o equivalente no Airtable da regra "a chave fica no lado do servidor" no padrão serverless de verificação na inscrição.
• Falhe de forma aberta (fail open). Se a requisição der erro ou expirar, não descarte o registro — o bloco catch grava unknown para que uma pessoa (ou uma reexecução posterior) possa retomá-lo. Uma API de verificação é um filtro de qualidade, não um portão de autenticação; uma queda transitória nunca deveria apagar um lead real.
• Evite loops de reacionamento do gatilho. Se o seu gatilho for Quando um registro é atualizado, observe um campo específico (o campo de e-mail) — não "qualquer campo" — ou a gravação de volta acima vai disparar a automação sobre si mesma. Disparar na criação do registro ou em uma visualização filtrada evita isso por completo.
• Combine com os tipos dos seus campos. Gravar em um campo de texto de linha única aceita a string de status como está. Se preferir usar uma seleção única (single-select), passe { name: result.status } e crie previamente as quatro opções (deliverable, risky, undeliverable, unknown) para que a gravação não falhe.

A própria chamada de verificação é agnóstica de linguagem — a mesma requisição funciona a partir de um webhook do Typeform ou de uma Custom Request do Zapier se parte da sua stack vive fora do Airtable. Apenas a cola input.config() / updateRecordAsync acima é específica do Airtable.

Caminho 2: verifique em massa uma exportação CSV#

Se você já tem uma base cheia de contatos, ou prefere limpar em um cronograma a rodar um script por linha, vá em lotes. Esta também é a escolha certa quando uma automação por registro consumiria a cota de execuções do seu plano.

1. Exporte uma visualização para CSV. Na grade, abra o menu da visualização → Baixar CSV (ou selecione primeiro uma visualização filtrada para exportar apenas as linhas que importam). Você terá uma linha por registro, com o e-mail em sua própria coluna.
2. Passe o arquivo pela verificação em massa e deixe a Qualisend aplicar o pipeline completo — MX, SMTP e os sinalizadores de descartável / função (role) / catch-all — em cada linha.
3. Baixe o arquivo anotado. Cada endereço volta com um status, um código de reason e um score de 0 a 100.
4. Reimporte para o Airtable. Traga o CSV limpo de volta, casando pela coluna de e-mail, para preencher um campo de status na base. Depois, suprima os não entregáveis antes do seu próximo envio e trate as linhas arriscadas com cuidado — a rotina de ponta a ponta está em como limpar uma lista de e-mails.

Em massa é a ferramenta certa para um acúmulo, mas é limpeza, não prevenção: um endereço que você pega aqui geralmente já está parado na sua base. Combine uma passagem em massa periódica com a automação do Caminho 1 para que novos endereços ruins sejam sinalizados no momento em que chegam.

Agindo sobre o veredito#

Seja qual for o caminho que entrega o resultado, o formato é o mesmo — um status, um reason, um score e os sub_flags. Mapeie cada um para uma ação:

Como o veredito mora em um campo, tudo o que vem depois vira um simples filtro do Airtable — uma visualização de "lista limpa" de Status do e-mail = deliverable, uma visualização de supressão para undeliverable. Para o quadro completo de como o pipeline chega a cada status, veja como a verificação de e-mail funciona.

Perguntas frequentes#

Existe uma integração nativa da Qualisend para o Airtable?#

Por enquanto não. As integrações nativas de plataforma da Qualisend estão sendo reconstruídas, então ainda não há uma extensão de um clique para instalar a partir do Airtable — está no roteiro. Até que ela chegue, a forma suportada de verificar e-mails do Airtable é a ação de automação nativa Executar um script apontada para a API da Qualisend, exatamente como este guia descreve. Essa abordagem também é mais flexível: você controla a requisição, a gravação de volta no campo e as condições do gatilho.

Preciso de um plano pago do Airtable para verificar e-mails automaticamente?#

Você precisa de automações, que todo plano inclui — mas o número de execuções de automação é limitado pelo seu nível, e cada registro verificado consome uma execução. No plano gratuito, um script por registro dá conta de baixo volume; em escala, ou migre para um plano com mais execuções ou recorra ao caminho do CSV em massa, que verifica uma exportação inteira em um único job em vez de uma execução por linha.

O Airtable consegue verificar endereços de e-mail por conta própria?#

Apenas o formato. O tipo de campo Email do Airtable confirma que um endereço está bem formado — tem um @ e um domínio — mas não resolve registros MX nem sonda a caixa de correio, então um endereço com erro de digitação ou descartável que parece válido ainda passa. A verificação de verdade precisa das camadas de DNS e SMTP que um serviço como a Qualisend adiciona por cima da checagem de formato.

Devo usar o script de automação ou a exportação por CSV?#

Use o script quando o timing importa — você quer cada endereço verificado e etiquetado no momento em que seu registro é criado. Use a exportação por CSV quando estiver limpando um acúmulo, fazendo higiene periódica ou de olho na sua cota de execuções de automação. A maioria das equipes faz os dois: o script mantém os novos registros limpos, e uma passagem em massa ocasional pega tudo que escapou ou envelheceu.

Pronto para montar tudo? Pegue uma chave com escopo, somente de verificação, e o formato exato da requisição em na documentação para desenvolvedores, faça um teste de sanidade em um único endereço no verificador gratuito de e-mails, ou comece com os 100 créditos gratuitos em todo plano para testar ambos os caminhos de ponta a ponta antes de se comprometer.