# Como integrar API de CPF com Zapier e Make (Integromat) sem código > Tutorial completo para integrar a API de CPF da CPFHub.io com Zapier e Make (Integromat) sem escrever uma linha de código. **Publicado:** 11/05/2024 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/como-integrar-api-de-cpf-com-zapier-e-make-sem-codigo --- Para integrar a API de CPF da CPFHub.io com Zapier ou Make sem escrever código, use o módulo Webhooks (Zapier) ou HTTP (Make) configurado com Method: GET, URL: `https://api.cpfhub.io/cpf/{CPF}` e o header `x-api-key` com sua chave. A configuração leva menos de 10 minutos e permite automatizar consultas de CPF disparadas por qualquer evento — nova linha em planilha, cadastro em formulário ou registro em CRM. ## Introdução Nem todo profissional que precisa validar CPFs no dia a dia é um desenvolvedor. Equipes de operações, compliance, RH e financeiro frequentemente precisam automatizar consultas de CPF sem ter acesso a um time de engenharia disponível para construir integrações personalizadas. Ferramentas de automação no-code como Zapier e Make (anteriormente Integromat) resolvem exatamente esse problema. Com essas plataformas, é possível criar fluxos automatizados que consultam a API de CPF em resposta a eventos como o preenchimento de um formulário, a adição de uma linha em uma planilha ou a chegada de um e-mail, tudo sem escrever uma única linha de código. --- ## Pré-requisitos Antes de começar, você vai precisar de: * **Conta na CPFHub.io** -- Crie uma conta gratuita em [cpfhub.io](https://www.cpfhub.io/) e obtenha sua API key no painel. * **Conta no Zapier ou Make** -- Ambas oferecem planos gratuitos com limitações de execuções. * **Uma fonte de dados** -- Google Sheets, Google Forms, Typeform, Airtable ou qualquer outra ferramenta que contenha os CPFs a serem consultados. --- ## Integração com Zapier ### Passo 1: criar um novo Zap Acesse o Zapier e clique em "Create Zap". O Zap terá duas partes: o gatilho (trigger) e a ação (action). ### Passo 2: configurar o gatilho Escolha a fonte de dados como gatilho. Por exemplo, se você quer validar CPFs inseridos em uma planilha do Google Sheets: * **App**: Google Sheets * **Evento**: New or Updated Spreadsheet Row * **Planilha**: Selecione a planilha que contém os CPFs * **Coluna do CPF**: Mapeie a coluna que contém o número do CPF ### Passo 3: adicionar a ação de consulta à API Adicione uma nova ação ao Zap: * **App**: Webhooks by Zapier * **Evento**: Custom Request Configure a requisição com os seguintes parâmetros: * **Method**: GET * **URL**: `https://api.cpfhub.io/cpf/` seguido do campo de CPF mapeado do gatilho * **Headers**: * `x-api-key`: SUA_CHAVE_DE_API * `Accept`: application/json A configuração equivale a esta chamada cURL: ```bash curl -X GET https://api.cpfhub.io/cpf/12345678900 \ -H "x-api-key: SUA_CHAVE_DE_API" \ -H "Accept: application/json" ``` ### Passo 4: processar a resposta A resposta da API será disponibilizada como dados estruturados no Zapier. Você pode usar esses dados para: * **Atualizar a planilha** -- Preencher colunas com nome, gênero e data de nascimento retornados pela API. * **Enviar notificação** -- Alertar via e-mail ou Slack se o CPF não for encontrado. * **Atualizar CRM** -- Enriquecer o cadastro do cliente com os dados verificados. ### Passo 5: adicionar ação de resposta Adicione uma segunda ação para gravar os resultados. Por exemplo: * **App**: Google Sheets * **Evento**: Update Spreadsheet Row * **Campos**: Mapeie `data.name`, `data.gender`, `data.birthDate` para as colunas correspondentes --- ## Integração com Make (Integromat) O Make oferece uma interface visual mais flexível que o Zapier, com suporte a fluxos condicionais e manipulação avançada de dados. ### Passo 1: criar um novo cenário Acesse o Make e clique em "Create a new scenario". ### Passo 2: adicionar o módulo de gatilho Selecione a fonte de dados. Por exemplo: * **Módulo**: Google Sheets -- Watch Rows * **Planilha**: Selecione a planilha com os CPFs * **Intervalo**: Defina a frequência de verificação (a cada 15 minutos, por exemplo) ### Passo 3: adicionar o módulo HTTP Adicione o módulo "HTTP -- Make a request" com a seguinte configuração: * **URL**: `https://api.cpfhub.io/cpf/` concatenado com o CPF da linha * **Method**: GET * **Headers**: * Name: `x-api-key` | Value: SUA_CHAVE_DE_API * Name: `Accept` | Value: `application/json` * **Parse response**: Yes ### Passo 4: adicionar roteador condicional O Make permite adicionar um roteador (Router) após a consulta HTTP para tratar diferentes cenários: * **Rota 1: CPF encontrado** -- Condição: `data.success` igual a `true`. Ação: atualizar planilha com dados retornados. * **Rota 2: CPF não encontrado** -- Condição: `data.success` igual a `false`. Ação: enviar alerta por e-mail ou marcar a linha como pendente. ### Passo 5: configurar o tratamento de erros No Make, adicione um módulo de tratamento de erros (Error Handler) para lidar com situações como timeout da API ou rate limit excedido. Configure para: * **Status 429 (rate limit)** -- Aguardar 2 segundos e tentar novamente. * **Status 500/503** -- Registrar o erro e prosseguir para o próximo CPF. --- ## Cenários práticos de automação ### Validação de leads em CRM Quando um novo lead é cadastrado no CRM (Hubspot, Salesforce, Pipedrive), o Zap consulta o CPF e enriquece o registro com nome verificado e data de nascimento. Leads com CPF inválido são sinalizados automaticamente. ### Verificação de candidatos em processos seletivos Quando um candidato preenche um formulário de inscrição (Google Forms, Typeform), o fluxo válida o CPF e notifica o RH caso haja divergência nos dados informados. ### Emissão de documentos fiscais Antes de gerar uma nota fiscal ou RPA, o fluxo consulta o CPF do cliente ou prestador para garantir que os dados estão corretos, evitando rejeição do documento fiscal. ### Controle de acesso em eventos Quando um participante se inscreve para um evento, o CPF é validado automaticamente. Inscrições com CPF inválido são bloqueadas ou encaminhadas para revisão manual. --- ## Dicas para otimizar a automação ### Respeitar rate limits O plano gratuito da [**CPFHub.io**](https://www.cpfhub.io/) oferece 50 consultas mensais — suficiente para automações de baixo volume ou para testar o fluxo antes de escalar. ### Evitar consultas duplicadas Adicione uma condição no fluxo para verificar se o CPF já foi consultado anteriormente. Isso economiza consultas e evita processamento desnecessário. ### Armazenar resultados Sempre grave o resultado da consulta em uma planilha ou banco de dados para evitar reconsultas desnecessárias e manter um histórico auditável. ### Monitorar execuções Tanto o Zapier quanto o Make oferecem logs de execução. Monitore regularmente para identificar falhas e otimizar o fluxo. --- ## Comparativo Zapier vs. Make para integração com API de CPF | Aspecto | Zapier | Make | | --- | --- | --- | | Facilidade de uso | Mais simples | Mais flexível | | Fluxos condicionais | Limitados (requer Paths) | Nativo (Router) | | Manipulação de dados | Básica | Avançada | | Tratamento de erros | Básico | Robusto | | Plano gratuito | 100 tarefas/mês | 1.000 operações/mês | | Módulo HTTP | Webhooks by Zapier | HTTP nativo | | Melhor para | Automações simples | Automações complexas | --- ## Limitações da abordagem no-code Embora Zapier e Make sejam excelentes para automações rápidas, existem cenários em que uma integração programática é mais adequada: * **Alto volume de consultas** -- Para milhares de consultas diárias, uma integração direta via código é mais eficiente e econômica. * **Latência crítica** -- Se a validação precisa ocorrer em tempo real no checkout ou onboarding, a chamada direta à API é mais rápida. * **Lógica complexa de negócio** -- Fluxos com múltiplas condições, cálculos e integrações com banco de dados são melhor atendidos por código. Para esses cenários, a CPFHub.io oferece documentação com exemplos de código em mais de 13 linguagens, incluindo Node.js, Python, PHP, Go, Ruby, Java, .NET, Rust e Elixir. --- ## Perguntas frequentes ### Qual a diferença entre Webhooks by Zapier e o módulo HTTP do Make para consultar a API de CPF? O Webhooks by Zapier faz requisições HTTP simples sem suporte nativo a lógica condicional — é necessário adicionar Paths separados para tratar respostas diferentes. O Make tem módulo HTTP nativo com roteamento condicional (Router) e tratamento de erros embutido, tornando-o mais flexível para fluxos complexos, como tratar CPF não encontrado de forma diferente de timeout. ### É seguro armazenar minha API key da CPFHub.io diretamente no Zapier ou Make? Sim, desde que use os campos de armazenamento seguro dessas plataformas. No Zapier, utilize campos marcados como "password" para o header `x-api-key`. No Make, armazene a chave em uma conexão HTTP com autenticação por header. Nunca cole a API key em campos de texto visíveis nos logs ou no título dos steps. ### O Zapier e o Make conseguem processar respostas JSON da API de CPF automaticamente? Sim. Ambas as plataformas parsificam automaticamente respostas JSON. No Zapier, os campos `data.name`, `data.birthDate` e `data.gender` ficam disponíveis como variáveis para os próximos steps. No Make, o JSON é mapeado como uma estrutura navegável com notação de ponto, permitindo usar `data.name` diretamente nos campos dos módulos seguintes. ### Qual plataforma é mais adequada para validar CPF em alto volume — Zapier, Make ou código? Para até 100 validações/mês, Zapier ou Make são suficientes. Para volumes entre 100 e 1.000, o Make é mais econômico (1.000 operações gratuitas vs 100 tarefas do Zapier). Acima de 1.000 validações mensais ou para integrações em tempo real (checkout, onboarding), a integração direta via API com código é mais eficiente, mais barata e sem latência adicional das plataformas de automação. ### Leia também - [Como consumir API de CPF em n8n para automações self-hosted](https://cpfhub.io/blog/como-consumir-api-cpf-n8n-automacoes-self-hosted) - [Como consumir API de CPF em Google Apps Script para automações no Google Sheets](https://cpfhub.io/blog/como-consumir-api-cpf-google-apps-script-automacoes-google-sheets) - [API de CPF grátis para desenvolvedores: como começar em 5 minutos](https://cpfhub.io/blog/api-cpf-gratis-desenvolvedores-comecar-5-minutos) - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) --- ## Conclusão Integrar a API de CPF da CPFHub.io com Zapier e Make é uma forma acessível e rápida de automatizar a validação de CPF sem depender de equipes de desenvolvimento. Em poucos minutos, é possível criar fluxos que consultam CPFs a partir de planilhas, formulários ou CRMs e retornam dados cadastrais verificados. Essa abordagem é ideal para equipes de operações, compliance e RH que precisam de automação imediata sem complexidade técnica. Para cenários de maior volume ou complexidade, a migração para uma integração programática é simples, graças à documentação completa da API. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e monte sua primeira automação de CPF no Zapier ou Make ainda hoje.