Skip to main content
Às vezes as coisas não saem como planejado, mas você pode corrigir rapidamente a maioria dos problemas e voltar aos trilhos. Use este guia para solucionar problemas comuns com publicação, login, chat e outras funcionalidades importantes.
Dicas rápidas de solução de problemas:
  • Se algo no seu app não está funcionando como esperado e você não vê um erro claro, digite ‘Something is wrong’ no chat da IA. A Base44 analisa o que está acontecendo no seu app, apresenta possíveis problemas e sugere correções diretamente no contexto para você resolver problemas mais rapidamente antes de tentar etapas manuais.
  • Verifique a página de status da Base44 para ver se há problemas em todo o sistema.

​
Editor e Dashboard

Você não consegue acessar a landing page do seu app devido à forma como a Base44 gerencia as configurações de privacidade para apps com áreas públicas e privadas.Por padrão, a Base44 exige que todo app defina um nível de privacidade para todas as suas páginas. Se a privacidade do seu app estiver definida como Private, todas as páginas, incluindo a landing page, exigem login. No momento, a Base44 não suporta tornar uma página pública (como uma landing page) enquanto o resto do app permanece privado.Para corrigir isso, você precisa tornar seu app público para que todos possam acessar a landing page.
  1. Vá até o dashboard do seu app.
  2. Clique em Overview.
  3. Em App Visibility, selecione Public.
Se seu app precisa de áreas públicas e privadas, siga esta solução alternativa:
  1. Crie um app separado para sua landing page pública.
  2. Publique ambos os apps.
  3. Vincule este app de landing ao seu app principal privado.
  4. Atribua seu domínio primário ao app da landing page e um subdomínio ao seu app privado.
Dica: Tente visualizar em uma janela anônima para verificar o acesso sem estar logado.
Solução alternativa:
Se você quer um único app com uma landing page pública e conteúdo privado, pode configurar row-level security (RLS) para bloquear todas as páginas exceto sua landing page.
  • Peça à IA para criar uma landing page pública, defina-a como padrão para todos os usuários.
  • Bloqueie todas as outras páginas atrás de RLS (para que apenas usuários logados possam vê-las).
  • Configure redirecionamentos: Qualquer pessoa deslogada é enviada para a landing, usuários logados são enviados para o dashboard.
  • Sugestão de prompt:
    “Please implement a landing page for our app that allows users to login/signup at /Login utilizing our existing theme. Make sure all pages except the landing page are secured behind RLS and that logged-in users can’t access the landing page but are redirected to the dashboard.”
Para mais sobre configurações de privacidade, consulte o guia Autenticação.
Se você vir uma tela branca no editor, isso geralmente aponta para um problema técnico que precisa de mais revisão.Aqui estão algumas etapas que você pode tentar:
  1. Clique no ícone Revert em uma mensagem de chat para restaurar seu app a uma versão anterior funcional.
  2. Abra o Version History (o ícone de relógio no chat da IA) e volte para uma versão mais antiga onde clicar em algo não causava tela branca.
  3. Tente descrever seu problema no chat da IA com detalhes mais específicos, como exatamente onde, quando e como o problema aparece.
Se essas etapas não resolverem o problema, isso pode ser um bug no código ou na configuração do seu app. Nesse caso, envie um ticket de suporte com informações detalhadas sobre o que dispara a tela branca, qual dispositivo/navegador você está usando, e quaisquer capturas de tela ou mensagens de erro que veja. Isso ajudará a equipe da Base44 a investigar e resolver o problema.
Esse erro pode acontecer se o nome do seu app contém um emoji ou caractere especial não suportado. Quando esse erro ocorre, você não conseguirá abrir o editor do app nem renomeá-lo.Se você encontrar esse problema, entre em contato com o suporte da Base44 para que a equipe possa ajudar a escalar seu caso.
Quando você tenta abrir o editor da Base44, pode ver uma tela em branco, ficar preso no ícone de carregamento ou notar que tudo está rodando lentamente ou não responde. Isso pode acontecer por várias razões relacionadas ao seu navegador, conexão com a internet ou problemas temporários da plataforma.Tente estas etapas:
  1. Verifique se está usando um navegador atualizado e suportado.
  2. Limpe o cache do navegador e os cookies da Base44.
  3. Desative extensões do navegador, especialmente bloqueadores de anúncios ou ferramentas de privacidade.
  4. Abra o editor em uma janela anônima ou tente um navegador diferente.
  5. Verifique a comunidade no Discord para quaisquer interrupções relatadas.
  6. Se o editor ainda não estiver funcionando, tire uma captura de tela de quaisquer erros (especialmente do console do navegador) e entre em contato com o suporte da Base44 com detalhes do seu navegador e sistema operacional.
Às vezes, após publicar seu app, atualizações como novo conteúdo, mudanças de design ou correções de bugs não aparecem no seu site ao vivo. Isso pode ser causado por cache, problemas de implantação ou etapas perdidas no processo de publicação.Tente estas etapas:
  1. Limpe o cache do navegador e do dispositivo, depois recarregue seu app.
  2. Verifique novamente seu app em um navegador ou dispositivo diferente.
  3. Certifique-se de que clicou em Publish e viu uma mensagem de “success”.
  4. Se você atualizou uma função de backend, faça o redeploy dela pelo dashboard.
  5. Procure quaisquer logs de erro no seu dashboard da Base44.
  6. Se nada funcionar, inclua o link do seu app e detalhes sobre o que está faltando quando entrar em contato com o suporte da Base44.
Se você vir uma tela em branco após publicar seu app, ou obter um erro como “Uncaught Error: Error in json schema: properties is required for object type”, geralmente há uma incompatibilidade entre as definições dos seus campos e os dados sendo salvos.Por exemplo, se você usa um objeto flexível ou uma entrada personalizada (como meal_preferences), certifique-se de que o tipo de entrada e o tipo de valor correspondam ao seu schema. Qualquer incompatibilidade pode fazer com que seu app carregue incorretamente ou exiba uma tela em branco.Verifique seu schema JSON e certifique-se de que os tipos de campos e os dados sendo armazenados estejam alinhados. Se você precisar inserir um objeto flexível, use JsonSchemaForm somente se as propriedades estiverem claramente definidas com antecedência.
Dica: Se o código e as configurações do seu app parecem corretos no editor, mas seu app ao vivo ainda mostra telas em branco ou atualizações faltando, verifique novamente os schemas dos campos e os dados salvos. Incompatibilidades ocultas de schema são uma causa comum.

​
Chat da IA

Se você perceber que seus créditos estão sendo usados mais rapidamente do que o esperado, pode ser porque você está conversando com a IA no modo Build em vez do modo Discuss. Quando você trabalha com a IA no modo Build, cada interação gasta mais créditos. O modo Discuss ajuda a economizar créditos permitindo planejar e revisar etapas sem disparar ações custosas da IA.Para economizar créditos ao conversar com a IA:
  1. Abra o menu suspenso de modos no chat da IA e selecione Discuss antes de começar a conversar.
  2. Planeje, tire dúvidas e converse sobre suas ideias com a IA.
  3. Quando terminar de discutir e estiver pronto para a IA agir ou construir algo, abra o menu suspenso de modos e selecione Build. Depois você pode pedir à IA para implementar suas alterações.
Use o modo Discuss para planejamento e brainstorming, e mude para o modo Build quando quiser que a IA realize ações, gere saídas ou faça alterações. O modo Discuss usa ~0,3 créditos por solicitação.
Para mais informações sobre como os créditos funcionam e as melhores formas de gerenciá-los, saiba mais sobre seus créditos.
Isso pode acontecer quando você descreve um problema em termos gerais e a IA começa a adivinhar onde está o problema.Tente este fluxo de trabalho quando quiser explicar um bug específico, por exemplo, um botão que não faz nada, um formulário que não envia ou uma funcionalidade que se comporta inesperadamente.Aponte a IA para o elemento exato (modo Edit + Discuss):
  1. Abra o menu suspenso de modos no chat da IA e selecione Discuss.
  2. Clique no elemento na prévia do seu app com o qual quer trabalhar, por exemplo, um botão, formulário, campo ou linha de tabela.
  3. Clique em Discuss no elemento para abrir um chat focado vinculado a esse componente.
  4. No chat da IA, explique o que está acontecendo e o que deveria acontecer.
Inclua o resultado esperado. Isso ajuda a IA a entender a lógica atual e o que você quer que ela faça.Exemplos:
  • Este botão não reage quando clicado, verifique seu handler onClick.
  • Após clicar neste botão, um PDF deveria ser baixado, mas atualmente nada acontece.
  • Este botão deveria me levar para a página Pedidos, mas eu permaneço na mesma tela.
Às vezes o painel do chat da IA pode falhar ao carregar, ficar preso processando ou não responder de forma alguma. Isso pode acontecer se seu prompt for muito longo ou complexo, devido a problemas de navegador ou rede, ou temporariamente por atualizações do sistema.Tente estas etapas:
  1. Clique no ícone Revert em uma mensagem do chat, ou volte para a última versão do seu app que estava funcionando corretamente. Isso pode resetar o estado da IA e frequentemente resolve o problema.
  2. Clique no botão Stop no chat se ele estiver preso em um estado como ‘thinking’, ‘applying changes’ ou ‘undoing’.
  3. Se sua solicitação à IA for muito longa ou complexa, divida-a em partes menores e mais gerenciáveis. Isso ajuda a IA a processar suas instruções com precisão.
  4. Atualize seu navegador e verifique sua conexão com a internet.
  5. Limpe o cache do navegador e desative extensões que possam bloquear scripts.
  6. Abra seu app em uma janela privada ou anônima.
  7. Se ainda não estiver funcionando, verifique o Discord para problemas relatados.
    Se o estado de processamento do chat durar mais de 10 minutos ou não fornecer atualizações, clique no botão Stop e informe a equipe de suporte, incluindo os seguintes detalhes:
    • Onde a IA ficou presa (local ou função no app)
    • O prompt ou ação que você estava realizando
    • Quanto tempo o estado de processamento durou
Você pode ver o erro ‘dict’ object has no attribute ‘lower’ ao usar o prompt do chat ou tentar enviar uma mensagem. Isso geralmente acontece quando o chat espera texto mas recebe um objeto inesperado, muitas vezes devido a uma falha temporária.Para resolver esse erro:
  1. Reverta sua última mensagem, como sugerido pelo erro.
  2. Atualize a página completamente:
    • No Windows ou Linux, pressione Ctrl + Shift + R ou Ctrl + F5.
    • No Mac, pressione Cmd + Shift + R.
  3. Tente limpar a seção do chat e comece um novo prompt.
  4. Se o erro continuar, entre em contato com o suporte e inclua detalhes sobre seu prompt e o erro.
Se o chat da IA permanecer em “Thinking…” após seu primeiro prompt e o app não progredir, tente estas etapas.Frequentemente, o app foi parcialmente criado. Tente clonar o app:
  1. Vá até o Dashboard do seu app.
  2. Vá até Settings e depois App settings.
  3. Clique em Clone app.
  4. Abra o app clonado.
Se clonar não ajudar, crie um novo app:
  1. Copie o texto do seu prompt original.
  2. Crie um novo app.
  3. Cole o mesmo prompt no chat da IA e execute-o novamente.
Dicas para evitar isso:
  • Para prompts complexos, divida sua solicitação em prompts menores e sequenciais.
  • Prompts iniciais muito longos com muitos detalhes podem fazer o chat travar.
  • Prompts iniciais complexos podem às vezes levar de 10 a 15 minutos para completar. Se nada mudar após esse tempo, tente uma das etapas acima.

​
Dados e Segurança

As regras de row-level security (RLS) controlam quais usuários podem acessar dados específicos no seu app. Se usuários não autorizados podem ver ou editar dados, ou as regras de RLS não estão funcionando como esperado, use a verificação de segurança integrada para encontrar e corrigir problemas.Para solucionar problemas de RLS:
  1. Vá até o dashboard do seu app.
  2. Clique em Security.
  3. Clique em Start security check para escanear regras de RLS ausentes ou mal configuradas.
  4. Revise os problemas encontrados e clique em Apply Fixes para usar os padrões seguros recomendados, ou ajuste as regras para cada entidade de dados manualmente.
  5. Faça login com diferentes funções de usuário para confirmar que apenas pessoas autorizadas podem acessar cada tipo de dados.
Para mais detalhes sobre configuração e gerenciamento de regras de segurança, consulte o guia para gerenciar configurações de segurança.

​
Desempenho e Velocidade

Você pode ver uma mensagem “500 Internal Server Error” ao carregar seu app, salvar dados, acessar páginas ou usar funcionalidades da plataforma como formulários ou dashboards. Isso pode levar a telas em branco, dados faltando, progresso perdido ou funcionalidades que não funcionam.Esse problema geralmente é causado por um problema no backend da Base44 ou na configuração da plataforma, como um App ID inválido, interrupções do servidor, problemas de implantação, problemas de API ou recursos sobrecarregados. Pode afetar tanto versões publicadas quanto de desenvolvimento do seu app.Um erro 500 significa que algo deu errado no lado do servidor, e geralmente você não pode corrigi-lo sozinho.O que você deve fazer:
  1. Atualize a página ou tente novamente mais tarde, pois alguns erros 500 são temporários.
  2. Verifique a página de status ou os canais do Discord para ver se há um incidente conhecido na plataforma.
Se o problema continuar, entre em contato com o suporte da Base44. Inclua os seguintes detalhes:
  • Nome do seu app
  • Onde e quando o erro acontece
  • Quaisquer mensagens de erro do console (capturas de tela se possível)
  • Quais etapas levaram ao problema
Às vezes, um app falha ao carregar e exibe apenas uma tela em branco, um spinner de carregamento ou um cabeçalho básico. Você pode ver isso após fazer edições, tentar visualizar seu app ou após publicar. O problema pode ocorrer em dispositivos web e mobile e pode incluir problemas como:
  • O app carrega brevemente e depois desaparece.
  • Clicar no link do app não mostra nada além de uma página branca ou uma roda de carregamento.
  • Algumas páginas, abas ou funcionalidades permanecem congeladas e sem resposta.
  • O app trava ao clicar em botões ou fazer seleções.
  • Nada aparece ao tentar acessar o dashboard, prévia ou páginas principais.
A maioria dos problemas de carregamento é causada por um problema no código do seu app ou um problema temporário da plataforma.Tente as seguintes etapas:
  1. Atualize a página ou abra o app em uma nova janela do navegador.
  2. Limpe o cache e cookies do navegador, depois tente carregar novamente.
  3. Certifique-se de que sua conexão com a internet esteja estável.
  4. Alterne navegadores ou dispositivos para ver se o problema persiste em outro lugar.
  5. Se você fez edições recentes antes do problema começar, tente reverter suas alterações mais recentes se possível.
  6. Aguarde alguns minutos. Às vezes, a plataforma está atualizando ou passando por uma indisponibilidade temporária.
Se seu app ainda não carrega, entre em contato com o suporte da Base44 e forneça:
  • Uma descrição do que você vê (por exemplo, página em branco/spinner)
  • Quando o problema começou e quaisquer edições recentes feitas
  • Nome ou link do app
  • Quaisquer mensagens de erro mostradas no console do seu navegador (se possível)
A equipe de suporte investigará e trabalhará com você para restaurar seu app.
Se você está preso em um estado de carregamento infinito após usar todos os seus créditos ou após uma grande edição, mencione isso na sua mensagem.
Se seu prompt continua rodando e o botão de parar não faz nada, tente estas etapas:
  1. Use o Version History para reverter rapidamente seu app para antes do prompt travado. Esta é a maneira mais rápida de voltar a um estado anterior.
  2. Altere o LLM nas configurações do seu app, alterne para o modo Discuss e envie qualquer prompt (por exemplo, “hi”) para quebrar o estado travado.
  3. Use o modo Edit para fazer uma pequena alteração, como adicionar um espaço extra ou atualizar um texto, para forçar uma mudança de estado.
  4. Se possível, abra seu app em um dispositivo mobile, mude para o modo Discuss e envie um prompt.
Se seu app está quebrado, mas pedir à IA para reverter no chat não funciona:
  1. Cada prompt no seu histórico de chat tem um botão Revert. Clique nele para reverter seu app para antes daquela alteração.
  2. Reverter seu app “pedindo” à IA no chat nunca desfaz mudanças de prompt de fato — apenas o botão Revert ou Version History corrigirá.
  3. Se o botão Revert não funcionar, use Version History (geralmente encontrado próximo ao dashboard ou prévia). Isso permite restaurar para uma versão anterior do app.
  4. Se tanto Revert quanto Version History não funcionarem, entre em contato com o suporte da Base44 para mais ajuda.
Se você vir avisos no seu navegador ou nas ferramentas de desenvolvimento sobre o script do Tailwind CDN (como “cdn.tailwindcss.com should not be used in production”), não precisa se preocupar. O script do Tailwind CDN é adicionado automaticamente pela plataforma Base44 e é necessário para o estilo do seu app. Este script não pode ser removido ou desativado no momento.O aviso não afeta a funcionalidade ou segurança do seu app. O script garante estilo consistente e uma experiência estável em todos os apps Base44.A Base44 está trabalhando em uma solução para isso no futuro próximo. Por enquanto, mantenha o script como parte da configuração do seu app.

​
Apps e Integrações

Funções de backend suportam requisições GET e POST. Um 404 não é causado pelo método que você usou. Abrir uma URL de função diretamente no seu navegador ainda pode retornar um erro. A função pode esperar dados que o navegador não envia. Consulte a pergunta ‘Erro ao abrir URL de função de backend no navegador’ abaixo.Se todas as suas funções de backend retornam erros 404 Not Found, especialmente ao usar a ferramenta de teste do dashboard ou nas suas integrações externas, este é um problema crítico. Geralmente aponta para um problema com o roteamento ou implantação do seu app, não com seu código ou configuração.Siga as etapas abaixo para testar sua função de backend usando o dashboard e depois prossiga para as etapas de solução de problemas.
  1. Clique em Dashboard no editor do seu app.
  2. Clique em Code.
  3. Clique em Functions.
  4. Selecione a função relevante.
  5. Clique em Test Function no canto inferior direito.
  6. (Opcional) Copie a URL da função da barra lateral superior direita para usar em integrações.
  • Se o teste passar: Sua função de backend está funcionando. Um erro ao abrir a URL diretamente no navegador não significa que a função esteja quebrada.
  • Se o teste retornar um erro 404 ou nenhuma das suas integrações estiver funcionando: Continue com as etapas de solução de problemas abaixo.
  1. Confirme se seu plano suporta funções de backend: Certifique-se de estar no plano Builder ou superior.
  2. Verifique locais e nomes de arquivos:
    • Certifique-se de que seus arquivos de função (por exemplo, ebayAuth) estejam no diretório correto.
    • Verifique se há erros de digitação em nomes de arquivos e funções.
    • Cada arquivo deve exportar a função usando Deno.serve().
  3. Faça o redeploy do seu app: Faça o redeploy pelo dashboard para disparar uma nova implantação e atualizar o roteamento do app.
  4. Revise o build e implantação recentes: Se seu app foi atualizado recentemente, verifique se todas as etapas de build e implantação foram concluídas com sucesso.
Se o problema continuar após essas verificações, isso provavelmente é um problema de roteamento ou implantação no nível da plataforma, não algo errado com a configuração do seu app. Entre em contato com o suporte da Base44 e inclua:
  • O link para seu app
  • Uma lista de nomes de funções de backend afetadas (por exemplo, ebayAuth)
  • Capturas de tela mostrando os erros 404 em cada endpoint
  • Quando o problema começou, como após um deploy, migração ou atualização da plataforma
Dica: Mencionar quando o problema começou ajuda a equipe de suporte a solucionar o problema mais rapidamente.
Por razões de segurança, serviços externos como Stripe, OpenAI ou Notion não permitem que terceiros (mesmo a Base44) acessem suas credenciais automaticamente. Chaves de API são como senhas para serviços. Mantê-las privadas e controladas pelo usuário mantém seus dados seguros e garante que apenas você autorize o acesso.Em vez disso, você precisa:
  1. Fazer login no serviço.
  2. Ir até a seção de API ou desenvolvedor.
  3. Gerar sua chave.
  4. Colá-la na Base44 como um Secret.
Uma vez adicionada, seu app pode usar essa chave nos bastidores com segurança e sem código.
Funções de backend na Base44 suportam requisições GET e POST. Você pode usar qualquer método para chamar suas funções de backend, dependendo do seu caso de uso.
  • Requisições GET permitem passar dados na query string da URL.
  • Requisições POST permitem enviar dados com segurança no corpo da requisição.
Se você vir um erro ao abrir uma URL de função de backend no navegador, verifique se sua requisição está formatada corretamente para GET ou POST. Certifique-se de passar quaisquer dados necessários usando o método apropriado para que sua função de backend os receba como esperado.
Um erro 500 geralmente significa que a URL da sua requisição POST de webhook está incorreta. Certifique-se de estar usando o link padrão do app Base44 como URL base no endpoint da sua função.Por exemplo: https://app--your-app-name.base44.app/api/apps/your-app-id/functions/yourFunctionNameSe você tem um domínio personalizado conectado, ainda é recomendado usar o link padrão do app para requisições POST para garantir roteamento adequado e menos erros. Verifique novamente a estrutura da sua URL e atualize sua integração conforme necessário.
Você pode ver o erro ISOLATE_INTERNAL_FAILURE ao tentar salvar ou implantar uma função de backend. Isso geralmente significa que um dos arquivos na sua pasta /functions não segue os requisitos da plataforma e não pode iniciar no ambiente Deno da Base44.Causas comuns:
  1. Entrypoint Deno.serve ausente: Cada arquivo de função na pasta /functions deve usar Deno.serve() como entrypoint. Por exemplo: Deno.serve((request) => { ... })
  2. Arquivos utilitários ou arquivos vazios em /functions: Módulos utilitários ou arquivos completamente vazios dentro da pasta /functions podem disparar esse erro, mesmo que não sejam destinados a ser endpoints reais. Arquivos auxiliares devem ser movidos para fora de /functions ou excluídos da implantação.
  3. Imports inválidos: Funções de backend devem ser autocontidas. Mantenha apenas imports de pacotes npm suportados. Não importe:
    • Componentes de frontend
    • Utilitários compartilhados do projeto de outras pastas
    • Outras funções de backend diretamente
  4. APIs não suportadas: O runtime Deno não suporta alguns built-ins do Node.js ou APIs exclusivas de navegador. Remova ou substitua coisas como:
    • Módulos Node.js como fs, path, process, crypto
    • APIs de DOM ou baseadas em window de navegador
Como corrigir erros ISOLATE_INTERNAL_FAILURE:
  1. Verifique o entrypoint: Certifique-se de que cada arquivo em /functions que é implantado como função de backend define um bloco Deno.serve() como seu entrypoint.
  2. Limpe a pasta /functions
    • Remova ou mova quaisquer arquivos vazios ou módulos utilitários puros que não devem ser implantados como funções.
    • Certifique-se de que apenas arquivos de função reais estejam em /functions.
  3. Corrija imports e APIs
    • Remova imports locais de componentes de frontend, utilitários compartilhados ou outras funções de backend.
    • Substitua APIs específicas de Node.js ou navegador não suportadas por alternativas suportadas.
    • Mantenha apenas imports de pacotes npm suportados.
  4. Salve e publique: Salve suas alterações e publique seu app para que as funções de backend possam ser reconstruídas e implantadas.
  5. Peça à IA da Base44 para refatorar a função: Se ainda vir o erro, copie o código da função no chat da IA da Base44 e diga algo como: “This backend function returns ISOLATE_INTERNAL_FAILURE. Make it self contained and compatible with Deno.serve without changing what it does.” A IA pode ajudar a reescrever a função para que siga os padrões Deno corretos, mantendo sua lógica igual.
Essa mensagem significa que a organização do repositório não está aprovada para imports no seu workspace. Peça a um dono ou admin do workspace para adicioná-la em Settings > Governance > GitHub organizations, depois cole a URL do repositório novamente.Se você tem apenas acesso de leitura, a Base44 precisaria criar uma cópia na sua conta pessoal do GitHub. Workspaces restritos bloqueiam essa cópia mesmo quando o repositório original pertence a uma organização aprovada. Peça acesso de push ao repositório original.

​
Domínios

A maioria das etapas abaixo se aplica a qualquer domínio. Para um domínio comprado pela Wix, as entradas específicas do domínio estão em Resolvendo problemas de domínio. Para verificar qual tipo você tem, consulte Verificando onde seu domínio está registrado.
Atualize sua página Domains primeiro. Um domínio que concluiu a configuração ainda pode mostrar Pending verification até que o status seja verificado novamente, e a mensagem de configuração pode permanecer na tela após seu domínio estar ao vivo. Abra seu domínio em um navegador, e se seu app carregar, seu domínio está conectado.Se ainda mostrar Pending verification, a correção mais rápida é deixar a Base44 adicionar os registros para você. Passe o mouse sobre o badge e clique em Set up DNS for me, depois faça login no seu provedor de domínio e aprove as alterações. Consulte Conectando um domínio externo.Se você adicionou seus registros manualmente, isso geralmente significa que há um problema com sua configuração de DNS ou propagação. Verifique se seus nameservers estão configurados corretamente usando nosso guia sobre domínios, depois siga as etapas abaixo.Etapas de solução de problemas:
  1. Remova quaisquer registros AAAA (IPv6) do seu domínio, pois eles podem interferir na configuração adequada.
  2. Aguarde 48-72 horas para que as alterações se propaguem totalmente pela internet.
  3. Use uma ferramenta como whatsmydns.net para confirmar que seus registros atualizados estão visíveis globalmente.
  4. Verifique novamente se você inseriu os valores exatos dos registros.
  5. Se o status ainda estiver pendente após cerca de 30 minutos, tente desvincular o domínio na Base44 e depois adicioná-lo novamente.
Se seu domínio ainda não se conectar, entre em contato com o suporte com:
  • Uma captura de tela dos seus registros DNS
  • Seu nome de domínio
  • O link do seu app Base44
Se você comprou seu domínio na Base44, precisa verificá-lo primeiro. Se pular essa etapa, seu domínio não se conectará. Isso se aplica a um domínio registrado com GoDaddy ou IONOS. Para um domínio comprado pela Wix, consulte Verificando seu domínio.Seu registrador envia um e-mail pedindo para você confirmar os detalhes de contato do seu domínio, e você precisa clicar no link de confirmação dentro de 15 dias. Essa etapa é exigida pela ICANN para manter seu domínio ativo e garantir que seus detalhes de contato sejam válidos.A GoDaddy é o parceiro registrador atual, então domínios comprados em ou após 14 de agosto de 2026 recebem o e-mail da GoDaddy. A IONOS era o parceiro anterior, então domínios comprados antes dessa data o recebem de support@ionos.com com o assunto “Please Confirm the Contact Details for Your Domain.” Se não tiver certeza de quando comprou seu domínio, pesquise sua caixa de entrada e a pasta de spam por “GoDaddy” e “IONOS”.Se você não confirmar seu endereço de e-mail dentro de 15 dias, seu domínio pode ser desativado de acordo com os requisitos da ICANN.
Se você não encontrar o e-mail, ou o link expirou, peça à GoDaddy ou IONOS para enviar um novo. Para a GoDaddy, consulte Verifying contact information for ICANN Validation. Se não conseguir acessar sua conta com eles, entre em contato com o suporte da Base44.
Aqui está o que você precisa fazer:
  1. Abra o e-mail de confirmação da GoDaddy ou IONOS e clique no link para confirmar seu endereço de e-mail.
  2. Na Base44, vá até o Dashboard do seu app e clique em Domains, selecione o domínio e clique em Unlink domain.
  3. Conecte o domínio novamente.
  4. Aguarde alguns minutos para que a conexão seja concluída.
Se seu domínio estiver preso no status ‘Connecting’ por mais de 30 minutos, vá até o dashboard do seu app e clique em Domains, depois desvincule e vincule o domínio novamente.
Percorra esta lista de verificação para garantir que esteja configurado corretamente:
  • Certifique-se de que os registros DNS correspondam exatamente ao que é mostrado neste guia para seu tipo de configuração.
  • Remova quaisquer registros AAAA (IPv6), pois eles podem bloquear conexões.
  • Verifique novamente se há erros de digitação. Copie e cole valores exatamente deste guia.
  • Garanta que www e o domínio raiz estejam configurados corretamente.
  • Confirme se seu domínio está renovado e ativo.
  • Aguarde até 72 horas para que as alterações tenham efeito.
Solução de problemas avançada:
  • Verifique novamente os requisitos de registros CNAME e ANAME/ALIAS:
  • Remova quaisquer registros AAAA. A Base44 suporta apenas IPv4 e registros AAAA podem quebrar a resolução do domínio.
  • Para domínios comprados da Base44 via GoDaddy ou IONOS, tente desvincular e revincular o domínio para resolver a maioria dos problemas.
  • Se você tentou essas etapas e ainda vê problemas após a propagação completa do DNS, entre em contato com o suporte.
Dica: Se seu domínio usa um gerenciador de DNS como Cloudflare, atualize os registros lá em vez de no registrador. Defina os registros relacionados à Base44 como DNS only (nuvem cinza) para que o Cloudflare apenas responda ao DNS e não faça proxy do tráfego. Mantenha-os assim em vez de apenas durante a solução de problemas, porque o proxy também faz páginas recém-adicionadas retornarem 404 no seu domínio personalizado e impede que Cloudflare Workers rodem na frente dele. Isso não desativa o SSL na Base44.
Se você encontrar erros de SSL ou um ERR_SSL_PROTOCOL_ERROR após conectar seu domínio personalizado à Base44, siga estas etapas para resolver o problema:
  • Verifique se os registros DNS do seu domínio correspondem exatamente ao que é mostrado no seu dashboard da Base44.
  • Remova quaisquer registros AAAA (IPv6) das suas configurações de DNS, pois eles podem bloquear conexões seguras.
  • Verifique cuidadosamente se há erros de digitação ou valores ausentes nas suas entradas de DNS.
  • Certifique-se de que www e o domínio raiz apontem para os endereços IP ou CNAME corretos da Base44.
  • Verifique se o registro do seu domínio está ativo e foi confirmado.
  • Permita até 72 horas para que as alterações de DNS e SSL se propaguem totalmente pelo mundo.
  • Se você usa um serviço de DNS como Cloudflare, atualize seus registros diretamente nesse serviço e defina os registros relacionados à Base44 como DNS only (nuvem cinza), sem proxy. Deixá-los com proxy também pode fazer páginas recém-adicionadas retornarem 404 no seu domínio personalizado enquanto funcionam no seu endereço .base44.app, e Cloudflare Workers não rodam na frente de um domínio da Base44.
Se você ainda vir erros de SSL após concluir essas etapas, envie um ticket de suporte e inclua:
  • Uma captura de tela dos seus registros DNS atuais
  • Seu nome de domínio
  • Um link para seu app Base44
Se você excluiu um app e está tentando conectar o domínio a um novo app, pode ver um erro dizendo que o domínio já existe. Isso pode acontecer se o domínio ainda estiver registrado no nosso sistema, mesmo após o app antigo ser removido.Você não conseguirá corrigir isso sozinho no momento. Entre em contato com nossa equipe de suporte para obter ajuda.
Após comprar um domínio de nós, você precisa verificar suas informações de contato para ativá-lo. Se você não recebeu um e-mail de verificação do seu registrador, seu domínio pode não se conectar ou funcionar como esperado. Isso pode impedir que seu site fique ao vivo.A GoDaddy é o parceiro registrador atual, então domínios comprados em ou após 14 de agosto de 2026 são registrados com a GoDaddy. A IONOS era o parceiro anterior, então domínios comprados antes dessa data são registrados com a IONOS. Para um domínio comprado pela Wix, o e-mail vem da Wix, e sua página Domains mostra um botão Resend Verification Email.Para resolver esse problema:
  1. Pesquise sua caixa de entrada, spam e lixo eletrônico por “GoDaddy” e “IONOS”, para capturar o e-mail de qualquer registrador que mantenha seu domínio.
  2. Se não encontrar, peça a esse registrador um novo e-mail de verificação. Dê a ele seu nome de domínio e explique que não recebeu o e-mail de verificação após comprar seu domínio.
  3. Se não conseguir acessar sua conta com o registrador, entre em contato com o suporte da Base44 e peça para eles solicitarem para você.
  4. Abra o novo e-mail e siga as etapas nele para concluir a verificação do seu domínio.
Um erro 429 geralmente aparece devido a um limite temporário no lado da Base44. Esse problema se resolve automaticamente.

Aguarde alguns minutos antes de tentar reconectar seu domínio. Se o problema continuar após aguardar, tente novamente mais tarde.
Ao pesquisar seu domínio em ferramentas de DNS público (como Google Dig ou Whatsmydns), você pode ver um registro A extra apontando para um endereço IP que não reconhece. No entanto, quando você verifica a zona DNS do seu registrador, esse registro A não está listado. Isso geralmente acontece porque o encaminhamento de domínio, redirecionamento de URL ou estacionamento está habilitado no registrador, o que silenciosamente cria um registro A em segundo plano e pode interferir na conexão do seu domínio ou geração de SSL.Para corrigir esse problema:
  1. Abra uma ferramenta de consulta de DNS público e pesquise os registros A do seu domínio.
  2. Compare os IPs que vê lá com os registros A na zona DNS do seu registrador e confirme que um IP aparece apenas na ferramenta pública.
  3. Faça login na sua conta do registrador de domínio e abra a página de gerenciamento do seu domínio.
  4. Procure por seções chamadas Domain forwarding, URL redirect, Web forwarding ou Parking.
  5. Se qualquer opção de encaminhamento, redirecionamento ou estacionamento estiver ativada para seu domínio, desative-a ou exclua-a, depois salve as alterações.
  6. Se não tiver certeza de onde vem o IP extra, copie o endereço IP da ferramenta de DNS e execute uma consulta WHOIS nele.
  7. Se o IP pertence à empresa onde você registrou o domínio, é quase certamente uma página padrão de estacionamento ou encaminhamento. Certifique-se de que todos os recursos de encaminhamento e estacionamento estejam totalmente desabilitados para este domínio.
  8. Aguarde a propagação das alterações de DNS e verifique a conexão do seu domínio ou o status de SSL novamente.
Se você ainda estiver tendo problemas com seu domínio, entre em contato com o suporte da Base44 e inclua:
  • Uma captura de tela dos seus registros DNS
  • Seu nome de domínio
  • Um link para seu app Base44

​
Conteúdo e Mídia

Você pode fazer upload de vídeos para o chat da IA se eles usarem um formato suportado e estiverem dentro do limite de tamanho de arquivo.Para corrigir o problema:
  1. Verifique se seu vídeo está em um dos formatos suportados: MP4, WEBM, MOV, AVI, MKV, M4V, WMV, OGV, 3GP ou 3G2.
  2. Certifique-se de que seu vídeo tem 100MB ou menos por vídeo.
  3. Tente fazer upload do vídeo novamente.
  4. Se o upload ainda não funcionar, atualize o editor e tente novamente.
Para mais detalhes sobre arquivos suportados, consulte o guia de Mídia.
Esse erro aparece quando você tenta fazer upload de um formato de arquivo não suportado pelo chat da IA, ou quando o tipo de arquivo não corresponde ao que a Base44 espera.Para corrigir o problema:
  1. Verifique se seu arquivo está em um dos formatos suportados.
  2. Certifique-se de que seu arquivo não excede o limite de tamanho para esse tipo de arquivo.
  3. Se você fez upload do arquivo errado acidentalmente, clique em Revert na mensagem para desfazer o último prompt.
  4. Tente fazer upload do seu arquivo novamente usando um formato suportado.
Para mais detalhes sobre arquivos suportados, consulte o guia de Mídia.
Esse erro aparece se você faz upload de uma imagem em que o formato real do arquivo não corresponde à sua extensão de arquivo ou ao que a Base44 esperava. Isso frequentemente acontece se você renomear um arquivo de outro formato, por exemplo de .webp para .png, sem convertê-lo adequadamente, ou se a imagem foi salva em um formato diferente do indicado por sua extensão.Para resolver esse erro:
  1. Reverta sua última mensagem, especialmente se o upload de imagem foi seu passo anterior.
  2. Abra o arquivo em um editor de imagens e salve novamente ou exporte em um formato suportado, como PNG, JPG ou JPEG, em vez de apenas renomear a extensão do arquivo.
  3. Verifique se seu arquivo atende aos limites para o chat da IA.
  4. Tente fazer upload da imagem recém-exportada novamente usando um formato suportado.
Sempre use imagens exportadas ou salvas como PNG, JPG ou JPEG de um editor de imagens. Renomear a extensão de um arquivo não o converte em um formato adequado e pode causar erros de upload.

​
Códigos de Erro

A ação que você tentou foi concluída com sucesso. Geralmente você não verá esse código na interface da Base44, mas pode encontrá-lo em respostas de API, logs ou ferramentas de integração.O que você deve fazer? Nenhuma ação é necessária. Isso significa que tudo está funcionando corretamente.
Um erro 400 significa que o servidor da Base44 não pôde processar sua requisição, muitas vezes porque algumas informações estão faltando ou no formato errado.Exemplos:
  • Enviar um formulário sem campos obrigatórios.
  • Chamar uma API com o formato de dados errado.
O que você deve fazer? Verifique as informações inseridas e tente novamente. Se estiver usando uma API, certifique-se de que sua requisição corresponde ao formato esperado.
Você não está logado, ou sua sessão de login expirou. A ação solicitada exige autenticação.Exemplos:
  • Tentar visualizar uma página de dashboard sem fazer login.
  • Chamar uma funcionalidade de API ou integração com credenciais inválidas ou um token expirado.
O que você deve fazer? Faça login na Base44 e tente novamente. Se estiver usando integrações, atualize suas chaves de API ou credenciais de login.
Você está logado, mas não tem permissão para realizar essa ação ou acessar o recurso. Isso pode acontecer se sua função ou permissões forem limitadas, ou se as configurações de Row-Level Security (RLS) para determinadas entidades de dados não estiverem devidamente configuradas.Exemplos:
  • Tentar alterar configurações em um app ao qual você não tem acesso.
  • Tentar acessar dados ou páginas restritos pela sua função ou regras de RLS no seu app.
O que você deve fazer? Verifique com o admin do seu workspace se suas permissões precisam ser atualizadas. Se você é admin ou desenvolvedor, revise as regras de RLS para quaisquer entidades de dados relevantes e certifique-se de que o acesso correto esteja configurado para as ações que quer realizar.Observe que funções de backend só estão disponíveis no plano Builder e superior.Se você vir erros 403 ao conectar webhooks de serviços externos (como Telegram ou WhatsApp):Alguns serviços externos, como Telegram ou WhatsApp, enviam requisições de webhook dos seus servidores, mas não suportam a inclusão de credenciais de autenticação (como uma api_key ou cabeçalhos personalizados). Se seu webhook ou função de backend exige autenticação, esses serviços retornam um erro 403.
  • Certifique-se de que seu endpoint de webhook não exija nenhuma autenticação para serviços que não podem enviar credenciais. O endpoint deve ser público para funcionar com esses tipos de integrações.
  • Se quiser manter a autenticação para outras integrações, configure uma função ou endpoint separado somente público e use-o apenas para ações que não são sensíveis.
Após tornar seu endpoint público, o serviço externo deve se conectar sem um erro 403.
A página, link ou recurso que você tentou acessar não existe.Exemplos:
  • Inserir uma URL incorreta para seu app ou dashboard.
  • Acessar um arquivo excluído ou movido.
O que você deve fazer? Verifique se há erros de digitação e confirme que tem o link correto. Se o recurso deveria existir, verifique com o admin do seu workspace ou colegas se ele não foi movido ou excluído. Se ainda não conseguir acessá-lo, entre em contato com o suporte da Base44.
Você tentou realizar uma ação muitas vezes em um curto período. Isso dispara um limite de taxa temporário que protege o desempenho e a estabilidade.Exemplos:
  • Clicar rapidamente para reconectar um domínio ou repetir a mesma ação no seu dashboard.
  • Enviar muitas requisições repetidas em um curto período via API, funções de backend ou automações.
O que você deve fazer? Aguarde um curto período antes de tentar novamente. Ao tentar novamente, evite repetir a mesma ação rapidamente para não atingir o limite novamente.Informações adicionais:
  • Limites de taxa se aplicam por pessoa, então a capacidade escala com o número de pessoas usando seu app.
  • Distribua requisições ao longo do tempo em vez de enviá-las todas de uma vez.
  • Use requisições em lote onde sua integração as suporta.
  • Adicione cache para não chamar o mesmo endpoint para os mesmos dados repetidamente.
  • Adicione lógica de retry que aguarda um curto período antes de enviar uma nova requisição após uma resposta 429.
  • Se erros 429 aparecerem durante atividade normal, entre em contato com o suporte da Base44 com o horário do erro e o que você estava tentando fazer.
Houve um problema com o servidor da Base44 ao processar sua requisição.Exemplos:
  • Ver uma página “500 Internal Server Error”.
  • Falha de funcionalidades ao salvar ou carregar dados.
O que você deve fazer? Atualize e tente novamente. Se o problema continuar acontecendo, verifique o Discord da Base44 para problemas conhecidos ou entre em contato com o suporte com detalhes sobre o erro.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.