Como integrar validação de CPF em Zapier sem código

Para validar CPF no Zapier sem escrever código, adicione a ação Webhooks by Zapier > GET ao seu Zap e configure a URL https://api.cpfhub.io/cpf/{{CPF}} com o header x-api-key. A API responde em ~150 ms com nome, gênero e data de nascimento do titular, e o resultado pode ser usado em filtros condicionais para separar cadastros válidos de inválidos no mesmo fluxo. A configuração completa leva menos de 20 minutos e não exige nenhuma linha de código.

Por que validar CPF em fluxos automatizados

O problema de cadastros não verificados

Quando leads chegam por formulários, landing pages ou integrações com CRMs, os CPFs informados podem conter erros de digitação, números fictícios ou dados inconsistentes. Sem validação automática, esses registros defeituosos se propagam por toda a cadeia de sistemas.

Benefícios da validação no-code

Integrar a validação de CPF diretamente no Zapier traz vantagens significativas:

• Sem dependência de desenvolvedores -- equipes de marketing e operações configuram sozinhas.
• Tempo real -- a validação acontece no momento em que o dado entra no fluxo.
• Ações condicionais -- CPFs válidos seguem um caminho, inválidos seguem outro.
• Auditoria -- cada validação fica registrada no histórico do Zapier.

Visão geral do fluxo

O fluxo completo funciona em quatro etapas:

1. Trigger -- um evento dispara o Zap (novo registro no Google Sheets, envio de formulário Typeform, novo contato no HubSpot, etc.).
2. Webhook -- o Zapier faz uma chamada GET à API do CPFHub.io com o CPF capturado.
3. Filtro -- uma condição verifica se a resposta indica sucesso.
4. Ação -- com base no resultado, o Zap atualiza o registro, envia um e-mail ou cria uma tarefa.

Configurando o Trigger

Exemplo com Google Sheets

Selecione o trigger Google Sheets > New Spreadsheet Row. Configure para monitorar a planilha onde novos cadastros são inseridos. O Zapier detectará automaticamente as colunas disponíveis, incluindo a que contém o CPF.

Exemplo com Typeform

Se você usa Typeform para capturar leads, selecione Typeform > New Entry. O campo de CPF do formulário será mapeado como variável disponível nos próximos passos.

Configurando o Webhook para a API de CPF

Passo 1 -- Adicionar a ação Webhooks by Zapier

Adicione uma nova etapa ao Zap e selecione Webhooks by Zapier > GET. Esta é a etapa que fará a chamada à API.

Passo 2 -- Configurar a URL

No campo URL, insira:

https://api.cpfhub.io/cpf/{{CPF_DO_PASSO_ANTERIOR}}

Substitua {{CPF_DO_PASSO_ANTERIOR}} pela variável dinâmica do Zapier que contém o CPF capturado no trigger.

Passo 3 -- Configurar os Headers

Adicione os seguintes headers:

Passo 4 -- Configurar timeout

Na seção Unflatten, deixe como "no". Em configurações avançadas, se disponível, defina o timeout para 10 segundos. O Zapier tem um timeout padrão de 30 segundos por step, mas a API do CPFHub.io responde em ~150 ms, então não haverá problemas.

Testando o Webhook

Antes de testar no Zapier, confirme que a API responde corretamente via terminal:

curl --max-time 10 -X GET "https://api.cpfhub.io/cpf/12345678901" \
    -H "x-api-key: SUA_API_KEY_AQUI" \
    -H "Accept: application/json"

Resposta esperada:

{
    "success": true,
    "data": {
    "cpf": "12345678901",
    "name": "João da Silva",
    "nameUpper": "JOAO DA SILVA",
    "gender": "M",
    "birthDate": "01/01/1990",
    "day": "01",
    "month": "01",
    "year": "1990"
    }
}

Clique em Test step no Zapier. Se tudo estiver correto, você verá o JSON de resposta com os dados do CPF.

Adicionando filtros condicionais

Filtrando CPFs válidos

Adicione um passo Filter by Zapier após o webhook. Configure a condição:

• Campo: Webhooks > data > success
• Condição: (Boolean) Is true

Apenas os registros com CPF válido seguirão adiante no fluxo.

Criando caminhos com Paths

Para tratar CPFs válidos e inválidos de formas diferentes, use Paths by Zapier em vez de Filter. Crie dois caminhos:

• Caminho A (CPF válido) -- success é true. Ação: atualizar o registro com o nome retornado.
• Caminho B (CPF inválido) -- success é false. Ação: enviar alerta para a equipe de operações.

Ações práticas com os dados retornados

Enriquecendo registros no Google Sheets

Adicione um passo Google Sheets > Update Spreadsheet Row e mapeie os campos:

• Coluna "Nome Completo" -- data > name
• Coluna "Gênero" -- data > gender
• Coluna "Data de Nascimento" -- data > birthDate
• Coluna "Status" -- valor fixo "Validado"

Atualizando contatos no HubSpot

Use HubSpot > Update Contact para enriquecer o perfil do lead com os dados retornados pela API. Isso melhora a segmentação e personalização de campanhas.

Enviando alertas por Slack

Para CPFs inválidos, adicione um passo Slack > Send Channel Message com uma mensagem como:

CPF inválido detectado no cadastro: {CPF}. Registro necessita revisão manual.

Tratando erros e edge cases

CPF com formatação

Formulários podem enviar CPFs com pontos e hífen (123.456.789-01). Adicione um passo Formatter by Zapier > Text > Replace antes do webhook para remover caracteres especiais:

• Input: CPF do trigger
• Find: . e -
• Replace: (vazio)

Lidando com falhas do webhook

O Zapier possui retry automático para webhooks que falham. Caso a API retorne erro temporário, o Zap tentará novamente. Para falhas persistentes, configure um passo de fallback que registre o CPF em uma planilha de "pendentes" para reprocessamento posterior.

Gerenciando o volume de consultas

O plano gratuito do CPFHub.io permite 50 créditos por mês. Se seu fluxo recebe mais leads do que isso, considere o plano Pro com 1.000 créditos mensais por R$149. No Grátis, os 50 créditos esgotados geram HTTP 403 com "Limite de créditos excedido" e as consultas param. Se o plano pago incluir excedente, a cobrança sai depois — confira a página de preços. Estourar o ritmo por minuto gera HTTP 429 com Retry-After.

Exemplo completo de Zap

Aqui está a estrutura completa de um Zap de validação de CPF:

1. Trigger: Google Sheets > New Spreadsheet Row
    └── Planilha: "Cadastros 2026", Coluna A = CPF

2. Formatter: Text > Replace
    └── Remove "." e "-" do CPF

3. Webhooks by Zapier: GET
    └── URL: https://api.cpfhub.io/cpf/{CPF_limpo}
    └── Headers: x-api-key, Accept

4. Paths by Zapier:
    ├── Path A (success = true):
    │ └── Google Sheets > Update Row
    │ └── Nome = data.name
    │ └── Status = "Validado"
    │
    └── Path B (success = false):
    └── Slack > Send Message
    └── "CPF inválido: {CPF}"

Alternativas ao Zapier

Make (Integromat)

O Make oferece funcionalidade similar com módulos HTTP. A configuração é análoga: use o módulo HTTP > Make a request com método GET, os mesmos headers e URL.

n8n

Para quem prefere ferramentas open-source, o n8n permite o mesmo fluxo com o nó HTTP Request. A vantagem é não ter limites de execuções no plano self-hosted.

Boas práticas de segurança

Protegendo a chave de API

No Zapier, suas credenciais ficam armazenadas de forma segura nos steps. Evite compartilhar o link do Zap ou exportar configurações que exponham a chave. Para referências sobre boas práticas de segurança em integrações com APIs externas, consulte a documentação de segurança do Zapier.

LGPD e dados pessoais

A API do CPFHub.io retorna apenas os dados necessários para identificação. Certifique-se de não armazenar informações além do que sua operação exige, e documente a base legal para o tratamento de CPF conforme orientação da ANPD.

Perguntas frequentes

Como configurar o Webhook no Zapier para chamar a API CPFHub.io?

Adicione a ação Webhooks by Zapier > GET ao seu Zap e configure a URL como https://api.cpfhub.io/cpf/{{CPF}}, onde {{CPF}} é a variável dinâmica do passo anterior. Nos headers, adicione x-api-key com sua chave de API. A resposta em ~150 ms traz success: true com nome, gênero e data de nascimento quando o CPF é válido.

A API CPFHub.io bloqueia quando o limite de consultas é atingido?

A cota mensal e o limite por minuto não se confundem. No plano Grátis, zerar os 50 créditos pausa as consultas com HTTP 403 ("Limite de créditos excedido"); nos planos pagos, o excedente eventual é faturado depois, no preço da página de preços. Acima do limite por minuto a API responde HTTP 429 e informa o Retry-After.

Como garantir conformidade com a LGPD ao usar uma API de CPF no Zapier?

Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A ANPD orienta que dados de identificação devem ser tratados com o princípio da necessidade.

É possível tratar CPFs inválidos de forma diferente no mesmo Zap?

Sim. Use Paths by Zapier para criar dois caminhos condicionais: o Caminho A avança quando success é true (CPF válido) e o Caminho B trata os registros com success igual a false, podendo enviar alertas por Slack, marcar a linha na planilha como pendente ou criar uma tarefa de revisão manual.

Conclusão

Integrar a validação de CPF ao Zapier é uma forma acessível e eficiente de automatizar a verificação de cadastros sem depender de desenvolvedores. Com o recurso de Webhooks, qualquer equipe pode conectar a API do CPFHub.io

A combinação de no-code com uma API confiável -- 99,9% de uptime e tempo de resposta de ~150 ms -- democratiza o acesso à validação de CPF para empresas de todos os tamanhos.

Cadastre-se em cpfhub.io