Como validar CPF em Power Automate e Power Apps da Microsoft

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 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:

Passo 3: Parsear a resposta JSON

Após a ação HTTP, adicione uma ação "Parse JSON" com o seguinte schema:

{
    "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:

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

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 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).

Conclusão

A integração da validação de CPF via 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 — 50 consultas mensais gratuitas, sem cartão de crédito — e automatize sua verificação de CPF no Power Automate hoje mesmo.