Custom Connectors en la Power Platform: integrar cualquier API REST

Los Custom Connectors encapsulan las llamadas a APIs externas en un formato reutilizable en Power Apps y Power Automate. En lugar de usar el conector HTTP genérico en cada flujo, se crea un conector compartido con autenticación, tipos y acciones bien definidos.

Crear a partir de OpenAPI/Swagger

// make.powerapps.com → Datos → Custom Connectors → Nuevo → Importar fichero OpenAPI
// O: importar la URL del endpoint Swagger de la API

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

Configurar autenticación OAuth2

// En el Custom Connector → Seguridad → Tipo de autenticación: OAuth 2.0
Provider: Azure Active Directory
Client ID: (App Registration client_id)
Client Secret: (guardado en el Custom Connector — no visible al usuario)
Resource URL: api://su-api-app-id
Redirect URL: https://global.consent.azure-apim.net/redirect

Acciones y triggers

// Acción: crear proyecto
POST /proyectos
Request body:
  { "nombre": string, "cliente_id": integer, "budget": number }
Response: { "id": integer, "nombre": string, "estado": string }

// Trigger (webhook): notificado cuando un proyecto cambia de estado
// Configura el webhook en el create, devuelve el id del webhook en el response
// Power Automate hace unsubscribe automático cuando se elimina el flujo

Usar en Power Automate

// Tras publicar el conector:
// Power Automate → Nueva conexión → Custom Connectors → API Proyectos BConcepts
// El usuario autoriza con su cuenta Azure AD
// Acciones disponibles: "Listar proyectos", "Crear proyecto", etc.

Conclusión

Los Custom Connectors transforman las integraciones ad-hoc en activos reutilizables compartidos por toda la organización. La inversión de crear un conector bien documentado con autenticación OAuth2 ahorra horas a cada colaborador que necesite integrar la misma API en flujos futuros.