> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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...

<Warning>
  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](/developers).
</Warning>

# 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`:

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

### Campi

| Campo    | Tipo      | Obbligatorio | Descrizione                                                                                   |
| -------- | --------- | ------------ | --------------------------------------------------------------------------------------------- |
| `type`   | string    | Sì           | Il tipo di integrazione (esegui `npx base44 connectors list-available` per vedere le opzioni) |
| `scopes` | string\[] | No           | Scope 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).

```bash theme={null}
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):

```json theme={null}
{
    "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)

```jsonc theme={null}
// 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:

```bash theme={null}
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](https://docs.base44.com/developers/skills/base44-cli/references/connectors-push.md) per i dettagli.

Per scaricare i connettori esistenti da Base44 ai file locali:

```bash theme={null}
npx base44 connectors pull
```

Consulta [connectors-pull.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-pull.md) per i dettagli.

<Note>Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](/). </Note>