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.

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:

{
  "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).

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):

{
    "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)

// 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

Um conector por tipo: Você não pode ter vários conectores do mesmo tipo (por exemplo, dois conectores googlecalendar)
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)
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:

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 para detalhes. Para extrair conectores existentes da Base44 para arquivos locais:

npx base44 connectors pull

Veja connectors-pull.md para detalhes.

Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.

Getting started

Building your app

Designing your app

Managing app data

Adding logic to your app

Selling on your app

Using on mobile

Domains

Securing your app

Measuring your app

Growing your app's reach

Superagents

Integrations

Criando Conectores

Criando Conectores

Conceitos-chave

Localização do arquivo

Schema

Campos

Descobrindo tipos de conector disponíveis

Stripe (Sandbox)

Regras e restrições

Próximos passos

​Criando Conectores

​Conceitos-chave

​Localização do arquivo

​Schema

​Campos

​Descobrindo tipos de conector disponíveis

​Stripe (Sandbox)

​Regras e restrições

​Próximos passos

Criando Conectores

Conceitos-chave

Localização do arquivo

Schema

Campos

Descobrindo tipos de conector disponíveis

Stripe (Sandbox)

Regras e restrições

Próximos passos