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

> Aprenda a criar fluxos no Power Automate que validam CPF via API CPFHub.io com conectores HTTP, condicoes e integrações com SharePoint e Teams.

**Publicado:** 29/09/2026
**Autor:** Lucas Vieira
**URL:** https://www.cpfhub.io/blog/como-integrar-validacao-cpf-power-automate-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](https://www.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](https://learn.microsoft.com/en-us/power-automate/getting-started) para entender as opções disponíveis.
* **Chave de API da CPFHub.io** -- Obtida gratuitamente em [cpfhub.io](https://www.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:

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

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

| Campo SharePoint | Valor |
|---------------------|------------------------------------------|
| Nome Validado | `body('Parse_JSON')?['data']?['name']` |
| Genero | `body('Parse_JSON')?['data']?['gender']` |
| Data Nascimento | `body('Parse_JSON')?['data']?['birthDate']` |
| Status Validação | "Validado" |
| Data Validação | `utcNow()` |

---

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

```json
{
 "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

| Aspecto | Valor |
|----------------------------|------------------------------------|
| Ações por fluxo/dia | 100.000 (plano Premium) |
| Conectores Premium | Inclusos no plano Premium |
| Timeout por ação HTTP | Até 120 segundos |
| Retries automáticos | Até 4 tentativas |
| CPFHub.io plano gratuito | 50 consultas/mes |
| CPFHub.io plano Pro | 1.000 consultas/mes por R$149 |

---

## 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](https://www.gov.br/anpd) orienta que dados de identificação devem seguir o princípio da necessidade e da finalidade.

### Leia também

- [Como validar CPF no frontend com React e API REST](https://cpfhub.io/blog/como-validar-cpf-no-frontend-com-react-e-api-rest)
- [Boas práticas para consumir APIs de CPF de forma segura](https://cpfhub.io/blog/boas-praticas-consumir-apis-cpf-segura)
- [Autenticação em APIs REST: como garantir segurança na consulta de CPF](https://cpfhub.io/blog/autenticacao-apis-rest-seguranca-consulta-cpf)
- [Como integrar validação de CPF no Salesforce com Apex para CRM corporativo](https://cpfhub.io/blog/como-integrar-validacao-cpf-salesforce-apex-crm-corporativo)

---

## Conclusão

O Power Automate democratiza a integração com APIs como a [**CPFHub.io**](https://www.cpfhub.io/)

Cadastre-se em [cpfhub.io](https://www.cpfhub.io/)