Conectores compartidos - Base44 Support Documentation

Un conector compartido conecta una cuenta para toda la app. Todos los usuarios de la app comparten el mismo token OAuth. Usa esto para cuentas de servicio, como publicar en un canal de Slack de empresa, leer un Google Calendar compartido o consultar un workspace compartido de Notion. Para configurar un conector compartido:

Configura un archivo JSONC para cada servicio que necesites
Despliega y autoriza vía el CLI
Úsalo en funciones de backend llamando a getConnection() para conectores OAuth, o usando la API REST de Stripe directamente para pagos

Configurar

Cada conector es un archivo JSONC en el directorio de conectores de tu proyecto. El archivo define el tipo de integración y los scopes que tu app necesita. Por defecto, el directorio es base44/connectors/, pero puedes personalizar la ruta en tu configuración del proyecto.

connectors

googlecalendar.jsonc

slack.jsonc

slackbot.jsonc

notion.jsonc

Ejemplo

Este ejemplo configura un conector de Google Calendar con scopes de lectura y gestión de eventos:

{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events",
  ],
}

Referencia de campos

type

string

requerido

El identificador del tipo de integración. Consulta la tabla de servicios compatibles para la lista completa de valores aceptados.Cada tipo de conector solo puede definirse una vez en tu proyecto.

scopes

array

requerido

Array de scopes OAuth requeridos para tu integración. Los scopes específicos dependen del servicio externo y de qué operaciones necesita realizar tu app. Consulta la documentación de permisos y scopes de conectores para los scopes disponibles para cada servicio.

Desplegar y autorizar

Despliega conectores con connectors push o deploy. Para descargar conectores existentes desde Base44, usa connectors pull. Cuando haces push, el CLI gestiona cada conector según su tipo:

Conectores OAuth: El CLI te pide autorizar cada conector uno a uno. Sugiere abrir tu navegador automáticamente y, si aceptas, recorre las páginas de autorización de cada integración secuencialmente. Después de que se complete la autorización, tus tokens OAuth se almacenan de forma segura y puedes recuperarlos usando el SDK.
Stripe: El CLI aprovisiona un sandbox de Stripe para tu app y devuelve una URL de reclamación para completar el onboarding. No se necesita flujo OAuth.

Usar en funciones de backend

Una vez desplegado y autorizado, usa el conector en tus funciones de backend. El enfoque depende del modelo de auth del conector:

OAuth connectors
Stripe

Llama a connectors.getConnection() con el tipo de conector para recuperar un accessToken para realizar llamadas autenticadas a la API. Algunos conectores también devuelven un connectionConfig con parámetros adicionales (por ejemplo, un subdominio o ID de cuenta).Este ejemplo recupera una conexión de Google Calendar y obtiene los próximos eventos:

const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");

const timeMin = new Date().toISOString();
const url = `https://www.googleapis.com/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=${timeMin}`;

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${accessToken}` },
});

const events = await response.json();

Stripe no usa getConnection(). En su lugar, la plataforma almacena tus claves de API de Stripe como secretos de la app cuando aprovisionas el conector. En tus funciones de backend, lee STRIPE_SECRET_KEY desde el entorno y llama a la API REST de Stripe directamente.Este ejemplo crea una sesión de Stripe Checkout y devuelve la URL de pago:

const STRIPE_SECRET_KEY = Deno.env.get("STRIPE_SECRET_KEY");

Deno.serve(async (req) => {
  const { priceId, successUrl, cancelUrl } = await req.json();

  const response = await fetch("https://api.stripe.com/v1/checkout/sessions", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${STRIPE_SECRET_KEY}`,
      "Content-Type": "application/x-www-form-urlencoded",
    },
    body: new URLSearchParams({
      "payment_method_types[]": "card",
      "line_items[0][price]": priceId,
      "line_items[0][quantity]": "1",
      mode: "payment",
      success_url: successUrl || `${req.headers.get("origin")}?success=true`,
      cancel_url: cancelUrl || `${req.headers.get("origin")}?canceled=true`,
    }),
  });

  const session = await response.json();
  return Response.json({ url: session.url });
});

Automatizaciones de conectores

Las automatizaciones de conectores permiten que tus funciones de backend respondan a eventos de servicios conectados en tiempo real. Por ejemplo, puedes ejecutar una función cuando llega un nuevo email a Gmail o cuando cambia un archivo en Google Drive. Configura las automatizaciones de conectores en tu archivo function.jsonc junto a tus otras automatizaciones. Consulta Automatizaciones de conectores para la referencia completa de campos, eventos compatibles y documentación del payload.

Ver también

Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.

​Configurar

​Ejemplo

​Referencia de campos

​Desplegar y autorizar

​Usar en funciones de backend

​Automatizaciones de conectores

​Ver también

Configurar

Ejemplo

Referencia de campos

Desplegar y autorizar

Usar en funciones de backend

Automatizaciones de conectores

Ver también