# Como validar CPF em Power Automate e Power Apps da Microsoft > Guia passo a passo para integrar a validação de CPF via API da CPFHub.io no Power Automate e Power Apps da Microsoft. **Publicado:** 26/05/2024 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/como-validar-cpf-em-power-automate-e-power-apps --- Para validar CPF no Power Automate, adicione uma ação HTTP com método GET apontando para `https://api.cpfhub.io/cpf/{cpf}` e o header `x-api-key` com sua chave de API, depois use Parse JSON para extrair o campo `name` da resposta e condicione as etapas seguintes ao valor de `success`. No Power Apps, crie um conector personalizado ou chame um fluxo do Power Automate via `FluxoValidarCPF.Run(cpf)` para obter o resultado diretamente em fórmulas Power Fx. ## Introdução O Power Automate e o Power Apps fazem parte da plataforma Power Platform da Microsoft e são amplamente utilizados por empresas brasileiras para automatizar processos e criar aplicativos de negócio sem a necessidade de programação avançada. Integrar a validação de CPF nesses fluxos permite automatizar processos de onboarding, verificação cadastral e compliance de forma eficiente. A [**CPFHub.io**](https://www.cpfhub.io/) disponibiliza uma API REST com latência de ~900ms, autenticação via `x-api-key` e conformidade com a LGPD, tornando a integração com o Power Automate e o Power Apps direta e segura para ambientes corporativos Microsoft. --- ## Por que validar CPF no Power Automate O Power Automate (antigo Microsoft Flow) é uma ferramenta de automação de fluxos de trabalho que conecta centenas de serviços. Ao adicionar validação de CPF aos seus fluxos, você pode: * **Automatizar verificação cadastral** -- Validar CPFs automaticamente quando um novo registro é criado no SharePoint, Dynamics 365 ou Excel Online. * **Enriquecer dados de leads** -- Obter nome completo e data de nascimento de prospects a partir do CPF informado em formulários. * **Garantir compliance** -- Verificar CPFs antes de processar transações financeiras ou emitir documentos fiscais. * **Eliminar validação manual** -- Substituir processos manuais de conferência de CPF por automações confiáveis. --- ## Configurando o Power Automate para consultar CPF ### Passo 1: Criar o fluxo No Power Automate, crie um novo fluxo (pode ser automático, instantâneo ou agendado, conforme sua necessidade). Para este exemplo, usaremos um fluxo instantâneo com gatilho manual. ### Passo 2: Adicionar a ação HTTP Adicione uma ação "HTTP" ao fluxo com as seguintes configurações: * **Método:** GET * **URI:** `https://api.cpfhub.io/cpf/@{triggerBody()['cpf']}` * **Headers:** | Chave | Valor | | --- | --- | | x-api-key | SUA_CHAVE_DE_API | | Accept | application/json | ### Passo 3: Parsear a resposta JSON Após a ação HTTP, adicione uma ação "Parse JSON" com o seguinte schema: ```json { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "cpf": { "type": "string" }, "name": { "type": "string" }, "nameUpper": { "type": "string" }, "gender": { "type": "string" }, "birthDate": { "type": "string" }, "day": { "type": "integer" }, "month": { "type": "integer" }, "year": { "type": "integer" } } } } } ``` ### Passo 4: Usar os dados no fluxo Após o Parse JSON, você terá acesso aos campos individuais como `body('Parse_JSON')?['data']?['name']` para o nome completo. Use esses campos em ações subsequentes como enviar e-mail, atualizar planilha ou criar registro no Dataverse. --- ## Exemplo prático: validação ao inserir linha no Excel Um cenário comum é validar o CPF automaticamente quando alguém adiciona uma nova linha em uma planilha Excel Online: ### Configuração do fluxo 1. **Gatilho:** "Quando uma linha é adicionada" (Excel Online) 2. **Ação HTTP:** Consultar a API da CPFHub.io com o CPF da nova linha 3. **Parse JSON:** Extrair os dados da resposta 4. **Condição:** Verificar se `success` é `true` 5. **Se sim:** Atualizar a linha com o nome completo retornado 6. **Se não:** Enviar notificação de CPF inválido O equivalente em cURL da chamada que o Power Automate faz: ```bash curl -X GET https://api.cpfhub.io/cpf/12345678900 \ -H "x-api-key: SUA_CHAVE_DE_API" \ -H "Accept: application/json" ``` --- ## Integrando com Power Apps O Power Apps permite criar aplicativos de baixo código (low-code) com interfaces visuais. Para integrar a validação de CPF, existem duas abordagens principais. ### Abordagem 1: Conector personalizado Crie um conector personalizado no Power Apps que aponte para a API da CPFHub.io: 1. Acesse **Dados > Conectores personalizados > Novo conector personalizado** 2. Configure o host como `api.cpfhub.io` 3. Defina a ação GET com o path `/cpf/{cpf}` 4. Adicione o header `x-api-key` como parâmetro de autenticação 5. Configure a resposta com o schema JSON da API 6. Teste o conector e publique ### Abordagem 2: Chamar um fluxo do Power Automate Uma alternativa mais simples é criar um fluxo no Power Automate que recebe o CPF como parâmetro, consulta a API e retorna o resultado. No Power Apps, basta chamar o fluxo: ``` // No evento OnSelect de um botão no Power Apps Set( varResultado, FluxoValidarCPF.Run(TextInputCPF.Text) ); If( varResultado.success, Set(varNome, varResultado.name); Notify("CPF válido: " & varNome, NotificationType.Success), Notify("CPF não encontrado", NotificationType.Warning) ) ``` --- ## Tratamento de erros no Power Automate É fundamental tratar os possíveis erros da API dentro do fluxo. Adicione uma ação "Escopo" (Scope) com tratamento de erro: ### Códigos HTTP que o fluxo deve tratar | Código | Significado | Ação recomendada | | --- | --- | --- | | 200 | Sucesso | Processar os dados normalmente | | 400 | CPF com formato inválido | Notificar o usuário para corrigir | | 401 | Chave de API inválida | Verificar configuração da API key | | 429 | Rate limit excedido | Aguardar e tentar novamente | | 500 | Erro interno do servidor | Registrar o erro e tentar novamente | No Power Automate, use a configuração "Run after" (Executar após) para capturar falhas: 1. Adicione a ação HTTP dentro de um Scope "Tentar" 2. Crie um Scope "Capturar erro" configurado para executar após falha do primeiro scope 3. No scope de erro, envie uma notificação ou registre o problema em um log --- ## Validação local de CPF no Power Apps Antes de chamar a API, valide o formato do CPF diretamente no Power Apps para economizar consultas: ``` // Fórmula de validação no Power Apps Set( varCPFLimpo, Substitute( Substitute( Substitute(TextInputCPF.Text, ".", ""), "-", "" ), " ", "" ) ); If( Len(varCPFLimpo) <> 11 || Not(IsMatch(varCPFLimpo, "^\d{11}$")), Notify("CPF deve conter 11 dígitos numéricos", NotificationType.Error), // CPF tem formato válido, prosseguir com a consulta à API Set(varResultado, FluxoValidarCPF.Run(varCPFLimpo)) ) ``` --- ## Cenários avançados de automação ### Validação em massa via SharePoint Crie um fluxo agendado que percorra todos os registros de uma lista do SharePoint e valide os CPFs que ainda não foram verificados: 1. Gatilho: Recorrência (diário ou semanal) 2. Obter itens do SharePoint onde o campo "CPF Validado" é "Não" 3. Para cada item, consultar a API da CPFHub.io 4. Atualizar o item com o nome retornado e marcar como validado 5. Incluir um delay de 2 segundos entre cada consulta (respeitando o rate limit) ### Integração com Dynamics 365 No Dynamics 365, use o Power Automate para validar CPFs quando um novo contato ou conta é criado. O fluxo pode preencher automaticamente campos como nome completo e data de nascimento com os dados verificados pela API. ### Alerta de inconsistência Configure um fluxo que compara o nome informado pelo usuário com o nome retornado pela API. Se houver divergência significativa, envie um alerta por e-mail ou Teams para a equipe responsável. --- ## Considerações de segurança Ao integrar APIs externas no Power Automate e Power Apps, observe estas práticas: * **Armazene a API key em variáveis de ambiente** -- Nunca insira a chave diretamente nas ações do fluxo. Use variáveis de ambiente ou o Azure Key Vault. * **Limite o acesso ao fluxo** -- Restrinja quem pode executar e editar os fluxos que contêm chamadas à API. * **Registre logs de consulta** -- Mantenha um histórico de quais CPFs foram consultados, quando e por quem, para fins de auditoria e conformidade com a LGPD. Consulte as diretrizes da [ANPD](https://www.gov.br/anpd) para entender as obrigações de registro no contexto da Lei Geral de Proteção de Dados. * **Respeite os rate limits** -- Configure delays adequados entre consultas para evitar bloqueios. --- ## Perguntas frequentes ### Como armazenar a API key da CPFHub.io com segurança no Power Automate? Use variáveis de ambiente do Power Platform (em vez de inserir a chave diretamente na ação HTTP) ou recupere a chave do Azure Key Vault via conector dedicado. Isso garante que a chave não fique exposta no histórico de execuções do fluxo e facilita a rotação periódica sem precisar editar cada fluxo individualmente. ### O Power Automate consegue lidar com o rate limit da API CPFHub.io? Sim. Adicione uma ação "Atraso" (Delay) de 2 segundos entre cada chamada HTTP quando processar múltiplos CPFs em um loop. Para o plano Pro (1 requisição/segundo), reduza o delay para 1,1 segundo. Em caso de resposta HTTP 429, configure a ação HTTP para fazer retry automático após 5 segundos usando a opção de política de repetição do conector. ### Posso usar a validação de CPF no Power Apps sem criar um conector personalizado? Sim. A abordagem mais simples é criar um fluxo no Power Automate com um gatilho "Power Apps" que aceita o CPF como parâmetro e retorna os dados da API. No Power Apps, basta chamar o fluxo com `NomeDoFluxo.Run(cpf)` e processar a resposta em variáveis Power Fx — sem precisar configurar um conector personalizado. ### Como garantir conformidade com a LGPD ao validar CPF no Power Platform? Armazene a API key em variáveis de ambiente criptografadas, registre cada consulta em uma lista do SharePoint ou tabela do Dataverse (com CPF mascarado, timestamp e finalidade), limite o acesso aos fluxos apenas a usuários autorizados e documente a base legal para o tratamento dos dados de CPF nos seus registros de atividades de tratamento (Art. 37 da LGPD). ### 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 A integração da validação de CPF via [**CPFHub.io**](https://www.cpfhub.io/) no Power Automate e Power Apps é direta: uma ação HTTP, um Parse JSON e uma condição são suficientes para automatizar verificações cadastrais em qualquer fluxo da Power Platform. Com planos a partir de R$ 0 (50 consultas/mês) e integração em menos de 5 minutos, não há razão para manter processos manuais de verificação de CPF. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e automatize sua verificação de CPF no Power Automate hoje mesmo.