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

# Créer des connecteurs

> Les connecteurs sont des intégrations OAuth qui permettent à votre application Base44 de se connecter à des services externes comme Google Calendar, Slack, Notion, etc. Une fois connectés, vous pouvez utiliser les tokens d'accès dans les fonctions backend...

<Warning>
  Cette page fait partie d'une compétence d'agent de code IA et est écrite pour les agents, pas pour les humains. Pour la documentation Base44 lisible par un humain, consultez la [documentation développeur](/developers).
</Warning>

# Créer des connecteurs

Les connecteurs sont des intégrations OAuth qui permettent à votre application Base44 de se connecter à des services externes comme Google Calendar, Slack, Notion, etc. Une fois connectés, vous pouvez utiliser les tokens d'accès dans les fonctions backend pour appeler directement des API externes.

## Concepts clés

* **Accès direct à l'API** : les connecteurs fournissent des tokens d'accès OAuth bruts — vous appelez les API externes directement depuis les fonctions backend
* **Compte du builder** : connecte votre compte (le créateur de l'application), pas ceux de vos utilisateurs finaux
* **Fonctions backend uniquement** : les tokens ne sont accessibles que côté serveur pour des raisons de sécurité

## Emplacement des fichiers

Créez les fichiers de connecteurs dans le répertoire `base44/connectors/` (ou le répertoire spécifié par `connectorsDir` dans votre config.jsonc).

**Nommage des fichiers :** `{type}.jsonc` ou `{type}.json`

Exemples :

* `base44/connectors/googlecalendar.jsonc`
* `base44/connectors/slack.jsonc`
* `base44/connectors/notion.json`

## Schéma

Chaque fichier de connecteur doit spécifier un `type` et éventuellement une liste de `scopes` :

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

### Champs

| Champ    | Type      | Requis | Description                                                                                   |
| -------- | --------- | ------ | --------------------------------------------------------------------------------------------- |
| `type`   | string    | Oui    | Le type d'intégration (exécutez `npx base44 connectors list-available` pour voir les options) |
| `scopes` | string\[] | Non    | Scopes OAuth à demander (par défaut `[]`)                                                     |

## Découvrir les types de connecteurs disponibles

Exécutez la commande suivante pour obtenir la liste à jour des types de connecteurs pris en charge. Remarque : `stripe` est aussi un type valide mais n'est pas retourné par cette commande — traitez-le comme pris en charge (voir l'exemple Stripe ci-dessous).

```bash theme={null}
npx base44 connectors list-available
```

Cela retourne un objet JSON avec toutes les intégrations disponibles, leurs noms d'affichage, descriptions et tous les champs de configuration de connexion requis. Exemple de sortie (tronquée) :

```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"
                }
            ]
        }
    ]
}
```

Utilisez la valeur `integration_type` de cette sortie comme champ `type` dans votre fichier de connecteur. Certains connecteurs requièrent des `connection_config_fields` supplémentaires — consultez la sortie pour les détails.

### Stripe (Sandbox)

```jsonc theme={null}
// base44/connectors/stripe.jsonc
{
  "type": "stripe",
  "scopes": []
}
```

Note : Stripe ne nécessite pas de flux OAuth dans le navigateur. Lorsque vous poussez ce connecteur, Base44 provisionne automatiquement un compte sandbox Stripe côté serveur. Vous pouvez recevoir une URL de réclamation dans la sortie du push pour lier le sandbox à votre compte Stripe.

## Règles et contraintes

1. **Un connecteur par type** : vous ne pouvez pas avoir plusieurs connecteurs du même type (par exemple, deux connecteurs `googlecalendar`)

2. **Le type doit être valide** : le champ `type` doit être un type d'intégration valide (exécutez `npx base44 connectors list-available` pour voir les types disponibles)

3. **Les scopes sont propres au fournisseur** : chaque service a son propre format de scope — consultez la documentation du fournisseur

## Étapes suivantes

Après la création des fichiers de connecteurs, poussez-les vers Base44 :

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

Cela vous invite à autoriser chaque nouveau connecteur OAuth dans votre navigateur. Stripe est l'exception — il est provisionné automatiquement sans flux navigateur. Consultez [connectors-push.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-push.md) pour les détails.

Pour récupérer les connecteurs existants de Base44 vers des fichiers locaux :

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

Consultez [connectors-pull.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-pull.md) pour les détails.

<Note>Cette page a été traduite à l'aide de l'IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](/). </Note>