Custom Connectors no Power Platform: integrar qualquer API REST

Os Custom Connectors encapsulam chamadas a APIs externas num formato reutilizável em Power Apps e Power Automate. Em vez de usar o conector HTTP genérico em cada fluxo, cria-se um conector partilhado com autenticação, tipos e acções bem definidos.

Criar a partir de OpenAPI/Swagger

// make.powerapps.com → Dados → Custom Connectors → Novo → Importar ficheiro OpenAPI
// Ou: importar URL do Swagger endpoint da API

// Exemplo OpenAPI mínimo:
openapi: "3.0.0"
info:
  title: API Projectos BConcepts
  version: "1.0"
servers:
  - url: https://api.bconcepts.pt/v1
paths:
  /projectos:
    get:
      summary: Listar projectos
      operationId: ListarProjectos
      parameters:
        - name: estado
          in: query
          schema: { type: string }
      responses:
        "200":
          description: Lista de projectos
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/Projecto"

Configurar autenticação OAuth2

// No Custom Connector → Segurança → Tipo de autenticação: OAuth 2.0
Provider: Azure Active Directory
Client ID: (App Registration client_id)
Client Secret: (guardado no Custom Connector — não visível ao utilizador)
Resource URL: api://sua-api-app-id
Redirect URL: https://global.consent.azure-apim.net/redirect

Acções e triggers

// Acção: criar projecto
POST /projectos
Request body:
  { "nome": string, "cliente_id": integer, "budget": number }
Response: { "id": integer, "nome": string, "estado": string }

// Trigger (webhook): notificado quando projecto muda de estado
// Configura webhook no create, devolve id do webhook no response
// Power Automate faz unsubscribe automático quando o fluxo é apagado

Usar no Power Automate

// Após publicar o conector:
// Power Automate → Nova ligação → Custom Connectors → API Projectos BConcepts
// O utilizador autoriza com a sua conta Azure AD
// Acção disponível: "Listar projectos", "Criar projecto", etc.

Conclusão

Custom Connectors transformam integrações ad-hoc em activos reutilizáveis partilhados por toda a organização. O investimento de criar um conector bem documentado com autenticação OAuth2 poupa horas a cada colaborador que precise de integrar a mesma API em fluxos futuros.