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

# Criando Conectores

> Conectores são integrações OAuth que permitem que seu aplicativo Base44 se conecte a serviços externos como Google Calendar, Slack, Notion e mais. Uma vez conectado, você pode usar tokens de acesso em funções de backend...

<Warning>
  Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a [documentação para desenvolvedores](/developers).
</Warning>

# Criando Conectores

Conectores são integrações OAuth que permitem que seu aplicativo Base44 se conecte a serviços externos como Google Calendar, Slack, Notion e mais. Uma vez conectado, você pode usar tokens de acesso em funções de backend para chamar APIs externas diretamente.

## Conceitos-chave

* **Acesso direto à API**: Conectores fornecem tokens de acesso OAuth brutos - você chama as APIs externas diretamente das funções de backend
* **Conta do App Builder**: Conecta sua conta (o construtor do aplicativo), não as contas dos seus usuários finais
* **Apenas funções de backend**: Os tokens só são acessíveis no lado do servidor por segurança

## Localização do arquivo

Crie arquivos de conector no diretório `base44/connectors/` (ou o diretório especificado por `connectorsDir` no seu config.jsonc).

**Nomenclatura de arquivo:** `{type}.jsonc` ou `{type}.json`

Exemplos:

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

## Schema

Cada arquivo de conector deve especificar um `type` e opcionalmente uma lista de `scopes`:

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

### Campos

| Campo    | Tipo      | Obrigatório | Descrição                                                                             |
| -------- | --------- | ----------- | ------------------------------------------------------------------------------------- |
| `type`   | string    | Sim         | O tipo de integração (execute `npx base44 connectors list-available` para ver opções) |
| `scopes` | string\[] | Não         | Escopos OAuth a solicitar (padrão para `[]`)                                          |

## Descobrindo tipos de conector disponíveis

Execute o seguinte comando para obter a lista atualizada de tipos de conector suportados. Nota: `stripe` também é um tipo válido, mas não é retornado por este comando — trate-o como suportado (veja o exemplo Stripe abaixo).

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

Isto retorna um objeto JSON com todas as integrações disponíveis, seus nomes de exibição, descrições e quaisquer campos de configuração de conexão obrigatórios. Exemplo de saída (aparado):

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

Use o valor `integration_type` desta saída como o campo `type` no seu arquivo de conector. Alguns conectores requerem `connection_config_fields` adicionais — verifique a saída para detalhes.

### Stripe (Sandbox)

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

Nota: O Stripe não requer um fluxo de navegador OAuth. Quando você envia este conector, a Base44 provisiona automaticamente uma conta sandbox Stripe no lado do servidor. Você pode receber uma URL de reivindicação na saída de push para vincular a sandbox à sua conta Stripe.

## Regras e restrições

1. **Um conector por tipo**: Você não pode ter vários conectores do mesmo tipo (por exemplo, dois conectores `googlecalendar`)

2. **O tipo deve ser válido**: O campo `type` deve ser um tipo de integração válido (execute `npx base44 connectors list-available` para ver os tipos disponíveis)

3. **Escopos são específicos do provedor**: Cada serviço tem seu próprio formato de escopo - consulte a documentação do provedor

## Próximos passos

Depois de criar arquivos de conector, envie-os para a Base44:

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

Isto solicitará que você autorize cada novo conector OAuth no seu navegador. Stripe é a exceção — ele é provisionado automaticamente sem um fluxo de navegador. Veja [connectors-push.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-push.md) para detalhes.

Para extrair conectores existentes da Base44 para arquivos locais:

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

Veja [connectors-pull.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-pull.md) para detalhes.

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>