Skip to main content
Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la documentación para desarrolladores.

​
Crear conectores

Los conectores son integraciones OAuth que permiten a tu app de Base44 conectarse a servicios externos como Google Calendar, Slack, Notion y más. Una vez conectados, puedes usar tokens de acceso en funciones de backend para llamar directamente a APIs externas.

​
Conceptos clave

  • Acceso directo a la API: Los conectores proporcionan tokens de acceso OAuth sin procesar - llamas directamente a las APIs externas desde funciones de backend
  • Cuenta del constructor de la app: Conecta tu cuenta (el constructor de la app), no las cuentas de tus usuarios finales
  • Solo funciones de backend: Los tokens solo son accesibles del lado del servidor por seguridad

​
Ubicación del archivo

Crea archivos de conector en el directorio base44/connectors/ (o el directorio especificado por connectorsDir en tu config.jsonc). Nomenclatura de archivos: {type}.jsonc o {type}.json Ejemplos:
  • base44/connectors/googlecalendar.jsonc
  • base44/connectors/slack.jsonc
  • base44/connectors/notion.json

​
Esquema

Cada archivo de conector debe especificar un type y opcionalmente una lista de scopes: 
{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}

​
Campos

CampoTipoRequeridoDescripción
typestringSíEl tipo de integración (ejecuta npx base44 connectors list-available para ver las opciones)
scopesstring[]NoAlcances OAuth a solicitar (por defecto [])

​
Descubrir tipos de conectores disponibles

Ejecuta el siguiente comando para obtener la lista actualizada de tipos de conectores admitidos. Nota: stripe también es un tipo válido pero no lo devuelve este comando — trátalo como admitido (ver ejemplo de Stripe abajo). 
npx base44 connectors list-available
Esto devuelve un objeto JSON con todas las integraciones disponibles, sus nombres para mostrar, descripciones y cualquier campo de configuración de conexión requerido. Ejemplo de salida (recortada): 
{
    "integrations": [
        {
            "integration_type": "googlecalendar",
            "display_name": "Google Calendar",
            "description": "Access and manage Google Calendar events",
            "connection_config_fields": []
        },
        {
            "integration_type": "slack",
            "display_name": "Slack User",
            "description": "Send messages and interact with Slack as yourself (user integration)",
            "connection_config_fields": []
        },
        {
            "integration_type": "share_point",
            "display_name": "SharePoint",
            "description": "Manage documents, lists, sites, and collaboration content in SharePoint",
            "connection_config_fields": [
                {
                    "name": "subdomain",
                    "display_name": "SharePoint Site",
                    "description": "The name of your SharePoint site (e.g., sites/mysite)",
                    "placeholder": "sites/mysite",
                    "required": true,
                    "validation_pattern": "^[a-zA-Z0-9/_-]+$",
                    "validation_error": "Please enter a valid SharePoint site path"
                }
            ]
        }
    ]
}
Usa el valor integration_type de esta salida como el campo type en tu archivo de conector. Algunos conectores requieren connection_config_fields adicionales — revisa la salida para más detalles.

​
Stripe (Sandbox)

// base44/connectors/stripe.jsonc
{
  "type": "stripe",
  "scopes": []
}
Nota: Stripe no requiere un flujo OAuth de navegador. Cuando envías este conector, Base44 aprovisiona automáticamente una cuenta sandbox de Stripe del lado del servidor. Es posible que recibas una URL de reclamación en la salida del envío para vincular la sandbox a tu cuenta de Stripe.

​
Reglas y restricciones

  1. Un conector por tipo: No puedes tener varios conectores del mismo tipo (por ejemplo, dos conectores googlecalendar)
  2. El tipo debe ser válido: El campo type debe ser un tipo de integración válido (ejecuta npx base44 connectors list-available para ver los tipos disponibles)
  3. Los alcances son específicos del proveedor: Cada servicio tiene su propio formato de alcance - consulta la documentación del proveedor

​
Próximos pasos

Después de crear archivos de conector, envíalos a Base44: 
npx base44 connectors push
Esto te pedirá autorizar cada nuevo conector OAuth en tu navegador. Stripe es la excepción — se aprovisiona automáticamente sin un flujo de navegador. Consulta connectors-push.md para más detalles. Para extraer conectores existentes de Base44 a archivos locales: 
npx base44 connectors pull
Consulta connectors-pull.md para más detalles.
Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.