Como integrar validação de CPF em Power Automate para workflows corporativos

Para validar CPF em workflows do Power Automate, use a ação HTTP Premium para chamar GET https://api.cpfhub.io/cpf/{CPF} com o header x-api-key e processe a resposta com um bloco Parse JSON. A CPFHub.io retorna nome, gênero e data de nascimento do titular com latência de ~900ms — tempo suficiente para o timeout padrão de 120 segundos da plataforma. O resultado alimenta condicionais que atualizam listas do SharePoint, notificam canais do Teams ou bloqueiam fluxos de onboarding com CPF inválido.

Pre-requisitos

Para utilizar o conector HTTP no Power Automate, você precisa de:

• Licença Power Automate Premium -- O conector HTTP e classificado como Premium e não esta disponível no plano gratuito. Consulte os planos do Power Automate para entender as opções disponíveis.
• Chave de API da CPFHub.io -- Obtida gratuitamente em cpfhub.io
• Acesso ao Power Automate -- Via portal.office.com ou flow.microsoft.com.

Fluxo básico de validação de CPF

O fluxo mais simples recebe um CPF como input manual e retorna os dados do titular:

Passo 1 -- Trigger manual

Crie um novo fluxo com trigger "Manually trigger a flow" e adicione um input de texto chamado "CPF".

Passo 2 -- Limpar formatacao do CPF

Adicione uma ação "Compose" para remover a formatacao:

replace(replace(replace(triggerBody()?['text'], '.', ''), '-', ''), ' ', '')

Passo 3 -- Chamar a API via HTTP

Adicione a ação "HTTP" com a seguinte configuração:

{
    "method": "GET",
    "uri": "https://api.cpfhub.io/cpf/@{outputs('Limpar_CPF')}",
    "headers": {
    "x-api-key": "SUA_CHAVE_DE_API",
    "Accept": "application/json"
    },
    "retryPolicy": {
    "type": "fixed",
    "count": 2,
    "interval": "PT5S"
    }
}

A configuração de retry garante que falhas transientes sejam tratadas automaticamente, com 2 tentativas e intervalo de 5 segundos.

Passo 4 -- Parsear resposta JSON

Adicione a 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 5 -- Condicao de sucesso

Adicione uma condicao: body('Parse_JSON')?['success'] e igual a true.

No ramo "Sim", exiba os dados ou envie para o próximo passo do workflow. No ramo "Não", notifique o responsável sobre o CPF inválido.

Fluxo automatizado com SharePoint

Um cenário comum e validar CPFs quando novos itens são adicionados a uma lista do SharePoint:

Configuração do fluxo

Trigger: Quando um item e criado (SharePoint)
    -> Limpar CPF (Compose)
    -> HTTP GET para API CPFHub.io (com timeout de 10s)
    -> Parse JSON
    -> Condicao: success == true
    -> Sim: Atualizar item no SharePoint com dados validados
    -> Nao: Enviar email para responsavel

Ação de atualização no SharePoint

Configure a ação "Update item" para preencher os campos da lista:

Notificação via Microsoft Teams

Quando um CPF não e encontrado ou ha erro na validação, envie uma notificação para o canal de compliance:

Acao: Postar mensagem no Teams
Canal: Compliance - Validacoes
Mensagem:
    "CPF @{triggerBody()?['CPF']} nao foi validado.
    Motivo: CPF nao encontrado na base da Receita Federal.
    Item SharePoint: @{triggerBody()?['ID']}
    Acao necessaria: verificar dados manualmente."

Armazenamento seguro da chave de API

No Power Automate, existem formas seguras de armazenar a chave de API:

Azure Key Vault (recomendado)

Utilize o conector Azure Key Vault para recuperar o segredo em tempo de execução:

Acao: Obter segredo (Azure Key Vault)
Nome do cofre: meu-cofre-segredos
Nome do segredo: cpfhub-api-key

Use o valor retornado no header da ação HTTP:

x-api-key: @{body('Obter_segredo')?['value']}

Variavel de ambiente (alternativa)

Para ambientes sem Azure Key Vault, utilize variaveis de ambiente do Power Platform:

1. Acesse o Power Platform Admin Center.
2. Crie uma variavel de ambiente tipo "Segredo".
3. Referencie no fluxo com @{parameters('cpfhub_api_key')}.

Tratamento de erros no Power Automate

Configure o fluxo para lidar com falhas na chamada HTTP:

Scope com try-catch

Scope: Tentar Validacao
    -> HTTP GET para API CPFHub.io
    -> Parse JSON
    -> Processar resultado

Scope: Tratar Erro (configurar "Run After" = "has failed")
    -> Registrar erro no SharePoint
    -> Enviar alerta por email
    -> Definir status como "Erro na validacao"

Configuração de timeout na ação HTTP

Na ação HTTP, adicione o timeout nas configurações avancadas:

{
    "timeout": "PT10S"
}

Isso garante que o fluxo não fique preso esperando uma resposta que nunca chega, limitando a espera a 10 segundos.

Fluxo de onboarding de funcionarios

Um fluxo completo de onboarding que inclui validação de CPF:

1. Trigger: Formulario de admissao preenchido (Microsoft Forms)
2. Limpar e validar formato do CPF
3. Consultar API CPFHub.io
4. Condicao: CPF valido?
    Sim:
    -> Criar usuario no Azure AD
    -> Adicionar a lista de funcionarios no SharePoint
    -> Enviar email de boas-vindas
    -> Notificar gestor no Teams
    Nao:
    -> Enviar email para RH solicitando correcao
    -> Pausar fluxo ate correcao

Monitoramento e analytics

O Power Automate oferece analytics integrados:

• Histórico de execucoes -- Visualize cada execução do fluxo com detalhes de cada ação.
• Metricas de falha -- Identifique padrões de falha na integração com a API.
• Tempo de execução -- Monitore a latência total do fluxo para garantir SLAs.
• Power Platform CoE -- Para organizações maiores, o Center of Excellence oferece dashboards centralizados.

Limites e custos

Perguntas frequentes

O conector HTTP do Power Automate funciona com autenticação por header customizado?

Sim. A ação HTTP Premium permite adicionar headers arbitrários, incluindo x-api-key. Configure o header diretamente na ação ou recupere o valor de um Azure Key Vault na etapa anterior do fluxo — essa é a abordagem recomendada para ambientes corporativos, pois evita que a chave fique exposta no JSON do fluxo.

A API CPFHub.io retorna erro 429 quando o limite de consultas é atingido no Power Automate?

Não. Quando o limite mensal é ultrapassado, a API não bloqueia nem retorna 429 — ela continua respondendo e cobra R$0,15 por consulta adicional. No plano gratuito o limite é de 50 consultas/mês; no Pro, 1.000 consultas mensais por R$149. Configure alertas de consumo no painel da CPFHub.io para monitorar o volume antes de extrapolar o plano contratado.

Como tratar timeouts na chamada HTTP dentro de um fluxo do Power Automate?

Configure "timeout": "PT10S" nas configurações avançadas da ação HTTP para limitar a espera a 10 segundos. Combine isso com um Scope de tratamento de erros com "Run After" configurado para "has failed" — assim o fluxo registra a falha, notifica o responsável e define o status do item como "Erro na validação" sem interromper toda a automação.

Como garantir conformidade com a LGPD ao validar CPF em workflows corporativos?

Armazene apenas os dados necessários no SharePoint ou no sistema destino, nunca o CPF em texto simples em logs de execução. Documente a base legal para o tratamento de dados pessoais e restrinja o acesso ao histórico de execuções do fluxo a usuários com necessidade de negócio. A ANPD orienta que dados de identificação devem seguir o princípio da necessidade e da finalidade.

Conclusão

O Power Automate democratiza a integração com APIs como a CPFHub.io

Cadastre-se em cpfhub.io