Skip to main content
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

CampoTipoObrigatórioDescrição
typestringSimO tipo de integração (execute npx base44 connectors list-available para ver opções)
scopesstring[]NãoEscopos 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

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