Pular para o conteúdo principal

​
Sobre integrações

As integrações conectam a Base44 ao resto do seu stack para que você possa automatizar fluxos de trabalho, importar dados e chamar serviços externos sem conectar cada chamada de API manualmente. Você pode integrar em 3 níveis:
  • Nível do app: Integrações dentro de um único app:
    • Integrações internas como Invoke LLM e SendEmail.
    • Conectores para conexões baseadas em OAuth com ferramentas como Notion, Slack ou Google Workspace.
    • Chamadas de API externas com funções de backend que usam Secrets e funções por app.
  • Nível do workspace: APIs compartilhadas gerenciadas uma vez para todo o workspace:
    • Integrações OpenAPI personalizadas baseadas em especificações OpenAPI que qualquer app no workspace pode chamar com segurança.
  • Nível da conta: Conexões que ficam na sua conta Base44:
    • Conexões MCP que você configura uma vez para que o chat de IA do Base44 possa usar ferramentas externas enquanto você constrói, sem alterar o código implantado do seu app.

​
Integrações no nível do app

As integrações no nível do app ficam dentro de um único app. Elas incluem integrações internas, conectores e APIs externas com backend que você conecta apenas a esse app.

​
Integrações internas

Algumas integrações vêm pré-instaladas no Base44 e estão disponíveis para uso imediato. Elas não exigem plano pago, configuração extra ou chaves de API separadas. Com essas integrações principais, você pode adicionar IA, mensagens, manipulação de arquivos e lógica avançada a qualquer app sem configuração adicional. As integrações internas do Base44 incluem:
  • Invoke LLM: Gere respostas de IA a partir do modelo de linguagem integrado usando prompts detalhados. Suporta saídas em JSON schema, anexos de arquivos para contexto adicional, análise de imagens e busca na web para informações atualizadas.
  • SendEmail: Envie emails para pessoas no seu app Base44 com nomes de remetentes personalizáveis e conteúdo HTML rico.
    O SendEmail não suporta envio para listas de email externas ou adição de anexos.
  • UploadFile: Permita que pessoas carreguem arquivos para seu app. Use a URL do arquivo retornada em outras integrações ou fluxos de trabalho.
  • GenerateImage: Crie imagens a partir de prompts de texto detalhados. Retorna uma URL para a imagem gerada.
  • ExtractDataFromUploadedFile: Extraia dados estruturados de arquivos carregados (CSV, PNG, JPG, JPEG, PDF) usando JSON schemas. Útil para importar dados em massa.
Saiba mais sobre integrações internas.

​
Conectores

Os conectores são integrações habilitadas para OAuth que permitem que um app específico se conecte a ferramentas suportadas. Você pede ao chat de IA para conectar um serviço, faz login e aprova as permissões solicitadas. Seu app então pode ler ou gravar dados nessa ferramenta com base no que você permitir.
Você precisa do plano Builder ou superior para usar conectores no seu app.
Exemplos do que você pode construir com conectores:
  • Sincronizar um banco de dados do Notion para alimentar uma visualização de conhecimento no seu app.
  • Postar atualizações em um canal do Slack.
  • Sincronizar registros do Salesforce ou HubSpot em um painel interno.
  • Salvar arquivos do seu app no Google Drive.
  • Bloquear horários no Google Calendar quando uma nova reserva for feita.
  • Publicar uma postagem no LinkedIn quando uma nova postagem de blog for publicada.
  • Mostrar estatísticas de perfil do TikTok e contagem de seguidores em um painel.
Saiba mais sobre conectores.

​
Chamadas de API externas com funções de backend

Integrações externas usando funções de backend permitem que um app específico converse diretamente com serviços de terceiros como Stripe, Twilio ou APIs do Google com credenciais por app. Essas chamadas são conectadas através das suas próprias funções de backend e Secrets.
Conectando uma integração ao seu app usando o chat de IA
Use funções de backend quando:
  • Você quer uma integração pontual para um único app.
  • Você precisa de lógica personalizada fortemente acoplada a esse app.
  • O serviço ainda não está configurado como uma integração OpenAPI personalizada no seu workspace.
Exemplos de integrações externas com funções de backend:
  • Enviar emails de boas-vindas para novas pessoas usando seu app via seu provedor de email.
  • Sincronizar seu CRM existente com o banco de dados do seu app.
  • Alertar sua equipe no Slack quando alguém envia um formulário.
  • Gerar conteúdo com ferramentas de IA usando suas próprias chaves de provedor.
  • Chamar APIs específicas de fornecedores que ainda não têm um conector ou integração OpenAPI personalizada.
Importante: Você precisa do plano Builder ou superior para usar funções de backend.
Quando você solicita uma integração no chat de IA, a Base44 te orienta passo a passo e pede credenciais ou autorização quando necessário. Em seguida, conecta a lógica de backend e frontend automaticamente para você começar rapidamente. Você armazena credenciais como Secrets no painel do app e as usa em funções TypeScript em Dashboard → Code → Functions.
Cada função de backend tem um arquivo de código que você pode editar, visualizar e testar. Você também pode verificar logs de cada função em Dashboard → Code → Functions.

​
Integrações no nível do workspace

As integrações no nível do workspace ficam em um workspace e podem ser reutilizadas em muitos apps sem repetir configuração ou credenciais.

​
Integrações OpenAPI personalizadas

Integrações OpenAPI personalizadas permitem registrar APIs externas compartilhadas no nível do workspace a partir de uma especificação OpenAPI. Você importa uma spec uma vez, seleciona as operações que deseja expor e qualquer app nesse workspace pode chamar essas operações através do SDK. O builder de IA e seu código frontend podem chamar integrações OpenAPI personalizadas diretamente através de base44.integrations.custom sem expor credenciais. As chamadas são feitas pelo proxy através do backend do Base44, então os segredos nunca chegam ao navegador. Isso é ideal para APIs internas e APIs de parceiros que sua equipe usa em muitos apps.
Importante:
  • Apenas proprietários e admins de workspace em um plano Builder ou superior podem criar ou editar integrações OpenAPI personalizadas.
  • Qualquer pessoa no workspace pode usar uma integração OpenAPI personalizada existente em seus apps, mesmo em um plano gratuito.
Saiba como configurar essas APIs em detalhes em Gerenciando integrações de API personalizadas.

​
Conexões no nível da conta

As conexões no nível da conta são configuradas uma vez para sua conta Base44 e estão disponíveis onde quer que você use o chat de IA do Base44.

​
Conexões MCP

As conexões MCP permitem conectar servidores MCP personalizados à sua conta Base44 para que o chat de IA possa usar ferramentas externas e dados como contexto enquanto você constrói. Isso te dá um chat de builder consciente de contexto sem alterar o tempo de execução implantado do seu app.
Importante:
  • As conexões MCP estão disponíveis no plano Builder ou superior.
  • Servidores MCP são configurados uma vez por conta em Configurações da conta → Conexões MCP.
  • O chat de IA só chama um servidor MCP quando seu prompt exige (por exemplo, quando você menciona esse servidor ou pede dados que ele fornece). Não contata cada servidor MCP a cada mensagem.
Exemplos do que você pode fazer com conexões MCP:
  • Pedir ao chat de IA para pesquisar um MCP de documentos interno e resumir as páginas mais relevantes para uma funcionalidade.
  • Conectar um servidor MCP do GitHub e pedir um resumo das issues abertas em um repo específico.
  • Conectar um MCP de analytics, como Amplitude ou um serviço de métricas personalizado, e pedir ao chat para extrair métricas recentes de produto enquanto você planeja alterações.
Saiba como adicionar e gerenciar servidores MCP em Configurando um MCP personalizado.

​
Obtendo suas chaves de API

Algumas integrações exigem uma chave de API, que atua como uma senha privada entre a Base44 e o serviço externo. Sua chave de API prova a propriedade e mantém sua conexão segura. A Base44 armazena sua chave com segurança para que seu app possa usá-la sem expô-la.
Nunca compartilhe sua chave de API publicamente. Trate-a como uma senha.
Para obter sua chave de API:
  1. Faça login no serviço externo (por exemplo, OpenAI, Resend, Notion).
  2. Encontre a seção Developer, API ou Integrations.
  3. Clique em Create API Key ou Generate Token e copie.
  4. Cole sua chave de API no Base44:
    • Usando o chat de IA: Digite sua chave de API no chat de IA quando solicitado.
      Adicionando sua chave de API no chat de IA no Base44
    • Configurando manualmente: Salve sua chave de API em Secrets.
      a. Clique em Dashboard no editor do seu app.
      b. Clique em Secrets.
      c. Clique em Add Secret.
    Adicionando segredos no dashboard do app no Base44
As integrações OpenAPI personalizadas também usam segredos, mas estes são configurados uma vez por um admin do workspace ao criar ou editar a integração e são armazenados como segredos criptografados do workspace, não como Secrets por app.

​
Perguntas frequentes

Clique em uma pergunta abaixo para saber mais sobre o uso de integrações.
Integrações OpenAPI personalizadas são configuradas uma vez em um workspace a partir de uma spec OpenAPI e estão disponíveis para todos os apps nesse workspace através de base44.integrations.custom.call(). As credenciais são armazenadas como segredos criptografados do workspace e nunca expostas ao código do app, e você não precisa de funções de backend para usá-las.APIs externas por app usam funções de backend e Secrets em um app específico. Elas são ideais para lógica específica do app ou quando você não quer compartilhar uma API entre todos os apps em um workspace.
Antes de publicar seu app, teste sua integração para detectar problemas cedo:
  1. Use o modo sandbox ou teste (por exemplo, chaves de teste do Stripe), se o provedor oferecer.
  2. Experimente fluxos reais e casos extremos, não apenas um único caminho feliz.
  3. Verifique se entradas e saídas correspondem às suas expectativas na interface e no painel do provedor.
  4. Monitore o uso de créditos de integração tanto no Base44 quanto no serviço externo.
  5. Pré-visualize seu app para detectar carregamento lento, chamadas de API falhadas ou dados ausentes antes de entrar no ar.
Se você tiver problemas, verifique o seguinte:
  • Seu workspace está em um plano Builder ou superior (para APIs externas por app que usam funções de backend).
  • Sua chave de API está correta e salva em Secrets ou na integração OpenAPI personalizada, se relevante.
  • Você tem créditos ativos suficientes no serviço externo.
  • Você está usando credenciais ao vivo, não de teste, ao testar fluxos de produção.
  • Sua requisição de API inclui o endpoint, payload e parâmetros corretos.
  • Você não atingiu os limites de taxa do serviço.
Funções de backend e APIs externas por app exigem um plano Builder ou superior no workspace onde o app foi criado. Se o workspace estiver no plano Free ou Starter, as funções de backend e integrações que dependem delas ficam indisponíveis.Proprietários e admins de workspace podem criar funções de backend em apps que possuem. Colaboradores com função Editor também podem editar e criar funções de backend em um app desde que o workspace tenha um plano Builder ou superior.
Se você ver um erro 403 ao usar funções de backend, pode significar que as funções de backend não estão disponíveis para seu app ou workspace, ou que a requisição não tem permissões.Causas comuns e correções:
  • Requisito de plano: Funções de backend só estão disponíveis no plano Builder ou superior. Se o workspace estiver no plano Free ou Starter, chamadas de backend e integrações por app que dependem delas podem falhar com 403.
  • Permissões na sua função: Sua função de backend pode estar rejeitando a requisição porque a pessoa não está logada ou não tem a função correta. Verifique quaisquer checagens de função ou acesso que você adicionou no código da função.
  • Permissões do serviço externo: Um 403 também pode vir da API externa que você está chamando. Verifique se a chave de API tem os escopos corretos e se a requisição usa o endpoint e método corretos.
  • Ainda com problemas: Veja o artigo Solução de problemas ou entre em contato com o suporte da Base44.
Existem 2 tipos de chaves de API que você pode precisar regenerar ou atualizar:
  • Chaves de serviços de terceiros: Regenere sua chave no portal de desenvolvedor desse serviço, por exemplo OpenAI, Resend, Notion, depois atualize em Dashboard → Secrets ou nas configurações da sua integração OpenAPI personalizada.
  • Sua chave de API da conta Base44:
    1. Clique no ícone do seu perfil no canto superior direito da sua conta.
    2. Clique em Account settings.
    3. Clique em Regenerate ao lado de API Key.
Uma vez regenerada, sua chave de API do Base44 atualiza em todos os seus apps Base44 automaticamente. Se você adicionou sua chave do Base44 em outro serviço, atualize lá também.
  • Integrações internas permanecem disponíveis.
  • Conectores, integrações OpenAPI personalizadas, conexões MCP e APIs externas por app que dependem de funções de backend podem parar de funcionar até você atualizar para um plano Builder ou superior.
Sim. Você pode misturar integrações internas, conectores, integrações OpenAPI personalizadas e APIs externas por app no mesmo app, desde que seu plano e configurações suportem.
Por razões de segurança, serviços externos como Stripe, OpenAI ou Notion não permitem que terceiros, incluindo a Base44, acessem suas credenciais automaticamente. Em vez disso, você precisa:
  1. Fazer login no serviço.
  2. Ir para a seção de API ou desenvolvedor.
  3. Gerar sua chave.
  4. Colá-la no Base44 como um Secret ou cabeçalho do workspace.
Uma vez adicionada, seu app ou integração OpenAPI personalizada pode usar essa chave nos bastidores com segurança e sem código.
Por que isso importa: Chaves de API atuam como senhas para serviços. Mantê-las privadas e sob seu controle mantém seus dados seguros e garante que apenas você autoriza o acesso.
Não. As conexões MCP são apenas para o chat de IA do Base44 enquanto você constrói. Elas são configuradas no nível da conta em Configurações → Conexões MCP e são usadas apenas quando seu prompt requer esse servidor MCP. Seu app implantado não chama servidores MCP através desta página de configurações.
Ainda precisa de ajuda? Junte-se ao nosso Discord e receba suporte em tempo real da equipe e comunidade do Base44.
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.