Skip to main content
Conectores permitem que seu app Base44 trabalhe com as ferramentas e os dados que sua empresa já usa, do Gmail e Slack ao Google Workspace, Snowflake e Databricks.
Blocos de conectores sobre um gradiente azul com o Gmail em destaque

Conectando seu app a ferramentas externas

Você precisa do Builder plan ou superior para usar conectores.

​
Sobre conectores

Conecte as ferramentas que sua equipe já usa e crie fluxos no app com base nelas.

Enviar relatórios e alertas

Envie relatórios, alertas ou resumos por email pelo Gmail ou Outlook.

Gerar documentos e arquivos

Crie documentos, planilhas, apresentações ou arquivos usando as ferramentas do Google Workspace.

Gerenciar eventos e disponibilidade

Crie e gerencie eventos ou disponibilidade usando o Google Calendar ou o Outlook.

Notificar sua equipe

Envie notificações ou atualizações para equipes pelo Slack.

Acompanhar código e issues

Acompanhe a atividade de código, issues e pull requests com a GitHub API.

Consultar dados e criar dashboards

Consulte dados externos e crie dashboards com Snowflake ou Databricks.

​
Tipos de conector

Todo conector tem um tipo, que define de quem é a conta usada pela conexão. Você escolhe o tipo ao adicionar o conector.

Conector compartilhado

Você conecta uma conta uma única vez, e todos que usam seu app compartilham essa conexão e os dados dela.Ideal para uma conta da equipe ou uma plataforma de dados, como alertas do Slack no canal da sua equipe ou um dashboard do Snowflake.

Conector de usuário do app

Cada pessoa conecta a própria conta, para que seu app trabalhe com os dados que essa conta pode acessar.Ideal para ações por pessoa, como um CRM em que cada vendedor envia email do próprio Gmail.
Somente admins do workspace podem configurar um conector de usuário do app. Se você não é admin, essa opção fica desativada ao adicionar um conector. Peça a um admin para configurá-lo.

​
Adicionando um conector

Você adiciona um conector pela página Connectors do seu workspace, por um app ou pedindo ao chat de IA.

​
Pela página Connectors

Adicione um conector compartilhado para que todos que usam seu app possam usar a mesma conta conectada. Para adicionar um conector compartilhado:
  1. Clique em Connectors na barra lateral do seu workspace.
  2. Clique em Add connector.
  3. Pesquise o conector e clique nele.
  4. Se o conector oferecer os dois tipos, selecione Shared connector e clique em Next.
  5. Insira um Connection name.
  6. Em Who can access, selecione onde a conexão pode ser usada. O padrão é Apps and Super agent. Para o Slack, essa configuração é fixa em Apps only.
  7. (Opcional) Em Permissions, selecione Read-only ou Read & write. Isso aparece apenas nos conectores que oferecem essa escolha.
  8. Clique em Add connector e autorize a conta que você quer compartilhar na janela do provedor.
Para adicionar um conector de usuário do app, selecione App user connector no passo 4 e siga Usando seu próprio cliente OAuth.

​
Pelo seu app

Adicione um conector compartilhado sem sair do app em que você está trabalhando. Para adicionar um conector compartilhado por um app:
  1. No seu app, clique em Dashboard e depois em Integrations.
  2. Clique em Add connector.
  3. Pesquise o conector e clique nele.
  4. Se o conector oferecer os dois tipos, selecione Shared connector e clique em Next.
  5. (Opcional) Em Permissions, selecione Read-only ou Read & write. Isso aparece apenas nos conectores que oferecem essa escolha.
  6. Clique em Add connector e autorize a conta na janela do provedor.

​
Pelo chat de IA

Diga ao chat de IA o que você quer conectar e como quer usar. Ele sugere conectores com base na estrutura, nas páginas e nos dados do seu app. Quando um fluxo precisa de acesso, o chat mostra um cartão pedindo que você aprove a conexão antes de continuar a construção. Para ver a lista completa com categorias e prompts de exemplo, consulte o catálogo de conectores.

​
Como os conectores funcionam no seu app

Depois de conectar uma ferramenta, você pode reutilizá-la em páginas, fluxos e funções de backend. Peça ao chat de IA para criar páginas, tabelas, dashboards ou automações que leiam ou gravem dados no conector. Quando você inclui um conector em um fluxo, a Base44 cria uma função de backend. Para revisar o código, vá para o dashboard do seu app, clique em Code e abra a função em base44 > functions. Você pode editá-la por conta própria ou pedir ao chat de IA para atualizá-la. Por exemplo:
Se depois você adicionar um fluxo que precise de permissões extras, o chat de IA pede que você aprove as novas permissões para essa ferramenta.
Editor de código mostrando uma função de backend que publica uma mensagem no Slack pelo conector.

Conector do Slack em funções de backend

​
Usando seu próprio cliente OAuth

Alguns conectores funcionam com seu próprio cliente OAuth em vez do cliente da Base44. Você registra o cliente no provedor e adiciona as credenciais dele no seu workspace. A partir daí, o conector passa a usá-las.
Antes de começar: Você precisa ser admin do workspace. Registre um aplicativo OAuth no provedor e obtenha as credenciais dele. Adicione a callback URL às redirect URIs permitidas do provedor.
Para adicionar um conector com seu próprio cliente OAuth:
  1. Clique em Connectors na barra lateral do seu workspace.
  2. Clique em Add connector.
  3. Pesquise o conector e clique nele.
  4. Se o conector oferecer os dois tipos, selecione App user connector e clique em Next. Snowflake e Databricks abrem este formulário diretamente.
  5. Insira um Connector name para identificar esta configuração.
  6. Insira seu Client ID e, se necessário, o Client Secret. Preencha os outros campos exibidos para o seu conector.
  7. Em Scopes, revise os escopos selecionados e adicione ou remova os que precisar. Para permissões que não estão na lista, insira um escopo por linha em Additional scopes.
  8. Clique em Add Connector.
Trate seu Client Secret como uma senha. Não o compartilhe nem o inclua em capturas de tela.

​
Registrando callback URLs

Quando você configura um conector com seu próprio cliente OAuth, você registra uma callback URL no seu provedor OAuth. Assim, ele sabe para onde enviar as pessoas de volta após a autorização.

​
Usando a callback URL única

Todo conector que você adiciona usa uma callback URL para todos os seus apps. Você a registra no seu provedor OAuth uma vez, e ela continua funcionando conforme você cria mais apps e conecta domínios personalizados. Adicione esta URL às redirect URIs permitidas do seu provedor OAuth:

​
Vendo suas callback URLs

Uma conexão que ainda usa URLs por app as lista por app, divididas em Builder e Live app. A callback URL única aparece no próprio formulário do conector quando você o adiciona. Para ver as callback URLs por app:
  1. Clique em Connectors na barra lateral do seu workspace.
  2. Ao lado do conector, clique em View.
  3. Ao lado da conexão, clique em View connection.
  4. Clique em View redirect URIs.
  5. Em OAuth Redirect URIs, selecione um app em App.
  6. Encontre as URLs em Builder e Live app. Expanda Per-app URLs (for legacy connectors), se aparecer.

​
Migrando uma conexão mais antiga

Conexões adicionadas antes de 17 de agosto de 2026 registram uma URL separada para cada host de app. Elas mostram um selo Per-app URLs ao lado do nome. Cada conexão é migrada individualmente. Um mesmo conector pode ter algumas conexões na callback URL única e outras ainda em URLs por app. Vale a pena migrar se você está adicionando apps ou domínios personalizados e precisa registrar uma nova URL para cada um. Se sua configuração está estável e funcionando, não há necessidade de migrar. As conexões existentes continuam funcionando nas URLs por app enquanto você as deixar lá.
Mantenha suas callback URLs por app registradas no provedor ao migrar. As pessoas que conectaram antes da migração ainda precisam delas, e mudanças no seu provedor podem levar alguns minutos para ter efeito.
Para migrar uma conexão para a callback URL única:
  1. Clique em Connectors na barra lateral do seu workspace.
  2. Ao lado do conector, clique em View.
  3. Ao lado da conexão, clique em View connection.
  4. Em Callback URLs, que mostra Uses per-app callback URLs, clique em Switch to a single URL.
  5. Adicione a URL mostrada às redirect URIs permitidas do seu provedor OAuth. Selecione I’ve added the URL to my OAuth provider e clique em Switch.
Para reverter uma conexão depois, abra-a de novo e clique em Switch back to per-app URLs. Antes, confira se o provedor ainda tem as URLs por app registradas. Uma conexão criada na callback URL única pode nunca ter tido essas URLs.

​
Escolhendo escopos do Google

Peça o escopo mais restrito que faça o trabalho. Ler o email de alguém é restricted, enquanto enviar em nome dessa pessoa é sensitive. Assim, um app que só precisa enviar email pode ficar fora do grupo restricted se não pedir para ler. O Google separa as permissões que um app pode pedir em 3 grupos, e o grupo em que você cai decide o quanto você precisa fazer antes que seu app vá ao ar. Isso importa mais para Gmail, Drive, Calendar e Google Fit. Se você conectar o Google usando seu próprio projeto do Google Cloud em vez do conector gerenciado da Base44, seu app é o que está registrado no Google, então qualquer coisa que o Google pedir aqui é pedida a você em vez de à Base44. Quando exigida, essa avaliação se chama CASA e é conduzida pela App Defense Alliance, não pelo Google. Ela analisa todo o seu aplicativo, incluindo como as pessoas fazem login, como as sessões são tratadas e como o código de terceiros é gerenciado. Planeje isso antes de construir, não depois. A verificação de escopos restricted pode levar várias semanas. Até ela ser concluída, o Google pode limitar quantas pessoas podem usar seu app e mostrar um aviso de app não verificado. Os requisitos, prazos e exceções são definidos pelo Google, então consulte a documentação para desenvolvedores do Google antes de se planejar.
Onde a Base44 se encaixa:
  • Seu projeto do Google Cloud, seu app OAuth e sua verificação são seus para gerenciar. A Base44 não pode enviá-los em seu nome.
  • Uma avaliação pergunta sobre a plataforma em que seu app roda, bem como sobre o seu próprio código. Entre em contato com o suporte cedo se você estiver passando por uma, para que as pessoas certas possam ajudar.

​
Gerenciando seus conectores

Mantenha as conexões de cada app funcionando: reconecte uma que expirou ou remova uma de que você não precisa mais. Em um conector de usuário do app, cada pessoa reconecta a própria conta dentro do seu app. Para gerenciar uma conexão:
  1. No seu app, clique em Dashboard e depois em Integrations.
  2. Em App connections, encontre a conexão.
  3. Clique no ícone de ações (···) e selecione uma opção:
    • Reconnect para restaurar uma conexão que expirou ou foi revogada.
    • Remove para excluir a conexão deste app.

​
Gerenciando configurações OAuth do workspace

As configurações OAuth do workspace são separadas das contas conectadas dentro de um app. Você pode editar as credenciais e os escopos, adicionar outra conexão ou excluir uma configuração.
A exclusão de uma configuração OAuth do workspace não pode ser desfeita.
Para gerenciar uma configuração OAuth do workspace:
  1. Clique em Connectors na barra lateral do seu workspace.
  2. Ao lado do conector, clique em View.
  3. Escolha o que fazer:
    • Para editar uma configuração, clique em View connection ao lado da conexão. Atualize o nome, as credenciais ou os escopos e clique em Save Changes. Deixe Client Secret vazio para manter o secret atual.
    • Para adicionar outra conexão ao mesmo conector, como o outro tipo de conector, clique em Add another connector.
    • Para excluir uma configuração, clique em View connection ao lado da conexão, clique em Delete Connector e confirme.
As alterações de escopo valem para novas conexões. Quem já se conectou mantém o acesso aprovado até se conectar novamente. As listas de escopos também podem mudar no lado do provedor, então sempre revise as permissões mostradas durante o fluxo de conexão.

​
Controlando a disponibilidade no workspace

Donos e admins do workspace podem escolher quais conectores as pessoas do workspace podem usar. Veja Gerenciando a disponibilidade de conectores no seu workspace.
Você precisa de um plano Business ou Enterprise para gerenciar a disponibilidade de conectores.

​
Perguntas frequentes

Você pode precisar reconectar se a conta foi desconectada, o acesso dela foi revogado ou o serviço conectado exige que você entre de novo. Para os passos, veja Gerenciando seus conectores acima.
Quando você usa seu próprio cliente OAuth, a callback URL registrada no serviço precisa corresponder exatamente à que a Base44 envia. Confira se https://connectors.base44.com/api/oauth/callback está registrada no seu app OAuth. Se a conexão ainda usa URLs por app, todas as URLs listadas precisam estar registradas. Para encontrá-las, veja Vendo suas callback URLs acima.
Um conector de usuário do app só funciona para as pessoas que seu próprio app OAuth admite. A maioria dos provedores mantém um novo app OAuth restrito a um público de teste ou interno até você publicá-lo ou distribuí-lo. Confira a configuração de público do seu app OAuth no provedor.
Precisa de mais controle sobre uma API específica? Use uma integração personalizada.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.