Skip to main content
Questa pagina fa parte di una skill per agenti IA di programmazione ed è scritta per gli agenti, non per gli umani. Per la documentazione Base44 leggibile dagli umani, consulta la documentazione per sviluppatori.

​
Creare connettori

I connettori sono integrazioni OAuth che permettono alla tua app Base44 di connettersi a servizi esterni come Google Calendar, Slack, Notion e altri. Una volta connessi, puoi usare i token di accesso nelle funzioni backend per chiamare direttamente le API esterne.

​
Concetti chiave

  • Accesso API diretto: i connettori forniscono token di accesso OAuth grezzi - chiami direttamente le API esterne dalle funzioni backend
  • Account del creatore dell’app: connette il tuo account (il creatore dell’app), non gli account degli utenti finali
  • Solo funzioni backend: i token sono accessibili solo lato server per motivi di sicurezza

​
Posizione dei file

Crea i file dei connettori nella directory base44/connectors/ (o nella directory specificata da connectorsDir nel tuo config.jsonc). Denominazione dei file: {type}.jsonc o {type}.json Esempi:
  • base44/connectors/googlecalendar.jsonc
  • base44/connectors/slack.jsonc
  • base44/connectors/notion.json

​
Schema

Ogni file di connettore deve specificare un type e facoltativamente un elenco di scopes: 
{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}

​
Campi

CampoTipoObbligatorioDescrizione
typestringSìIl tipo di integrazione (esegui npx base44 connectors list-available per vedere le opzioni)
scopesstring[]NoScope OAuth da richiedere (predefinito [])

​
Scoprire i tipi di connettore disponibili

Esegui il seguente comando per ottenere l’elenco aggiornato dei tipi di connettore supportati. Nota: stripe è anche un tipo valido ma non viene restituito da questo comando — trattalo come supportato (vedi esempio Stripe qui sotto). 
npx base44 connectors list-available
Questo restituisce un oggetto JSON con tutte le integrazioni disponibili, i loro nomi visualizzati, descrizioni e qualsiasi campo di configurazione della connessione richiesto. Esempio di output (troncato): 
{
    "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 il valore integration_type da questo output come campo type nel tuo file di connettore. Alcuni connettori richiedono connection_config_fields aggiuntivi — controlla l’output per i dettagli.

​
Stripe (Sandbox)

// base44/connectors/stripe.jsonc
{
  "type": "stripe",
  "scopes": []
}
Nota: Stripe non richiede un flusso OAuth nel browser. Quando invii questo connettore, Base44 provisiona automaticamente un account sandbox Stripe lato server. Potresti ricevere un URL di rivendicazione nell’output del push per collegare la sandbox al tuo account Stripe.

​
Regole e vincoli

  1. Un connettore per tipo: non puoi avere più connettori dello stesso tipo (ad es. due googlecalendar)
  2. Il tipo deve essere valido: il campo type deve essere un tipo di integrazione valido (esegui npx base44 connectors list-available per vedere i tipi disponibili)
  3. Gli scope sono specifici del provider: ogni servizio ha il proprio formato di scope - fai riferimento alla documentazione del provider

​
Passaggi successivi

Dopo aver creato i file dei connettori, inviali a Base44: 
npx base44 connectors push
Questo ti chiederà di autorizzare ogni nuovo connettore OAuth nel tuo browser. Stripe è l’eccezione — viene provisionato automaticamente senza un flusso nel browser. Consulta connectors-push.md per i dettagli. Per scaricare i connettori esistenti da Base44 ai file locali: 
npx base44 connectors pull
Consulta connectors-pull.md per i dettagli.
Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.