Connettori condivisi - Base44 Support Documentation

Un connettore condiviso collega un unico account per l’intera app. Tutti gli utenti dell’app condividono lo stesso token OAuth. Usalo per account di servizio, come pubblicare in un canale Slack aziendale, leggere da un Google Calendar condiviso o interrogare uno spazio di lavoro Notion condiviso. Per configurare un connettore condiviso:

Configura un file JSONC per ciascun servizio necessario
Distribuisci e autorizza tramite la CLI
Usa nelle funzioni backend chiamando getConnection() per i connettori OAuth, oppure usando direttamente l’API REST di Stripe per i pagamenti

Configura

Ogni connettore è un file JSONC nella directory dei connettori del progetto. Il file definisce il tipo di integrazione e gli scope necessari alla tua app. Per impostazione predefinita la directory è base44/connectors/, ma puoi personalizzare il percorso nella configurazione del progetto.

connectors

googlecalendar.jsonc

slack.jsonc

slackbot.jsonc

notion.jsonc

Esempio

Questo esempio configura un connettore Google Calendar con scope di lettura e gestione degli eventi:

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

Riferimento dei campi

type

string

obbligatorio

L’identificatore del tipo di integrazione. Consulta la tabella dei servizi supportati per l’elenco completo dei valori accettati.Ogni tipo di connettore può essere definito una sola volta nel progetto.

scopes

array

obbligatorio

Array di scope OAuth richiesti dall’integrazione. Gli scope specifici dipendono dal servizio esterno e dalle operazioni che la tua app deve eseguire. Consulta la documentazione permessi e scope dei connettori per gli scope disponibili per ciascun servizio.

Distribuisci e autorizza

Distribuisci i connettori con connectors push o deploy. Per scaricare i connettori esistenti da Base44, usa connectors pull. Quando esegui il push, la CLI gestisce ciascun connettore in base al suo tipo:

Connettori OAuth: la CLI ti chiede di autorizzare ciascun connettore uno alla volta. Suggerisce di aprire il browser automaticamente e, se accetti, itera in sequenza attraverso la pagina di autorizzazione di ogni integrazione. Dopo il completamento dell’autorizzazione, i token OAuth vengono memorizzati in modo sicuro e puoi recuperarli tramite l’SDK.
Stripe: la CLI predispone una sandbox Stripe per la tua app e restituisce un URL di rivendicazione per completare l’onboarding. Non è necessario alcun flusso OAuth.

Usa nelle funzioni backend

Una volta distribuito e autorizzato, usa il connettore nelle tue funzioni backend. L’approccio dipende dal modello di autenticazione del connettore:

Connettori OAuth
Stripe

Chiama connectors.getConnection() con il tipo del connettore per recuperare un accessToken da usare per chiamate API autenticate. Alcuni connettori restituiscono anche una connectionConfig con parametri aggiuntivi (ad esempio un sottodominio o un ID account).Questo esempio recupera una connessione Google Calendar e ottiene i prossimi eventi:

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 non usa getConnection(). La piattaforma memorizza invece le chiavi API di Stripe come app secrets quando esegui il provisioning del connettore. Nelle tue funzioni backend, leggi STRIPE_SECRET_KEY dall’ambiente e chiama direttamente l’API REST di Stripe.Questo esempio crea una sessione Stripe Checkout e restituisce l’URL di pagamento:

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 });
});

Automazioni dei connettori

Le automazioni dei connettori consentono alle funzioni backend di rispondere in tempo reale agli eventi dei servizi collegati. Ad esempio, puoi eseguire una funzione quando arriva una nuova email in Gmail o quando cambia un file in Google Drive. Configura le automazioni dei connettori nel file function.jsonc insieme alle altre automazioni. Consulta Automazioni dei connettori per il riferimento completo dei campi, gli eventi supportati e la documentazione dei payload.

Vedi anche

Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.

​Configura

​Esempio

​Riferimento dei campi

​Distribuisci e autorizza

​Usa nelle funzioni backend

​Automazioni dei connettori

​Vedi anche

Configura

Esempio

Riferimento dei campi

Distribuisci e autorizza

Usa nelle funzioni backend

Automazioni dei connettori

Vedi anche