Ajuda
Resolva problemas
O que fazer quando uma criação falha, a prévia fica em branco, uma página some, a IA muda a coisa errada, os créditos acabam, ou a publicação, os domínios, os e-mails ou os pagamentos não funcionam.
A maioria dos problemas na Buildliy tem uma solução rápida que você mesmo pode fazer. Esta página está organizada pelo que você vê na tela. Encontre o seu caso, veja o que ele significa e siga os passos.
Antes de tudo, lembre-se de duas redes de segurança:
- Toda criação salva uma versão. Você sempre pode voltar para uma que funcionava, e restaurar é grátis (a sua prévia ao vivo gasta um pouquinho de crédito enquanto está funcionando). Veja Histórico de versões.
- A Buildliy verifica as suas criações e conserta muitos problemas automaticamente antes de você ver. Veja Como as criações são verificadas.
A criação falhou
O que significa: a criação parou antes de terminar. O chat mostra uma mensagem curta, em linguagem simples, dizendo o que deu errado e o que tentar.
O que fazer: encontre a sua mensagem na tabela abaixo. Para tentar de novo, envie a sua mensagem outra vez. Não existe um botão separado para tentar novamente.
| A mensagem começa com | O que fazer |
|---|---|
| "A IA está um pouco ocupada agora." ou "A IA está temporariamente sobrecarregada." | Espere um minuto e envie a sua mensagem de novo. |
| "A IA teve um pequeno problema de conexão." | Ela já tentou de novo sozinha. Se nada aconteceu, envie a sua mensagem outra vez. |
| "Tivemos um probleminha ao preparar o ambiente da sua criação." ou "O ambiente da sua criação demorou demais para acordar." | Envie a sua mensagem de novo. Normalmente funciona na segunda tentativa. |
| "Sua criação demorou mais do que o esperado." | Peça menos coisas de uma vez. Divida o pedido em passos menores. |
| "Não consegui criar nada utilizável com esse pedido." | Seja mais específico sobre o que você quer. |
| "Há um pequeno problema no código que não consegui corrigir." | Tente um pedido mais simples, ou outra forma de pedir a mesma coisa. |
| "A IA não conseguiu entender isso." | A conversa pode estar longa demais, ou algum anexo pode estar grande demais. Simplifique a sua última mensagem ou comece um novo projeto. |
| "Nosso serviço de IA está temporariamente indisponível." ou "Nosso serviço de IA atingiu um limite temporário." | Isso é um problema do lado da Buildliy, não da sua conta nem dos seus créditos. Tente de novo mais tarde e fale com a gente se continuar acontecendo. |
| "Algo interrompeu essa criação." | Envie a sua mensagem de novo. Se continuar acontecendo, fale com a gente. |
| "Você atingiu o limite de 1.000 mensagens em 30 dias." | É um limite de segurança para uso muito intenso. Ele libera sozinho, e a mensagem diz quando. Se você precisar antes, escreva para support@buildliy.com. |
Se uma criação parou no meio (por exemplo, porque demorou demais), o trabalho que a IA terminou antes de parar é mantido. Olhe a prévia e envie um pedido de continuação bem direto.
Os créditos que uma criação já usou não são devolvidos quando ela falha ou para. Pedidos menores e mais claros são a melhor forma de evitar pagar por uma criação que não termina.
Um pedido grande demais é a causa mais comum. Em vez de pedir tudo de uma vez, vá passo a passo:
Vamos fazer por partes. Primeiro, cria só a página inicial, com uma seção de destaque e um botão de contato. Não coloca o sistema de reservas ainda.
O seu app mostra um erro
O que significa: o código foi escrito, mas uma página quebra quando carrega.
O que fazer:
- Se a prévia disser A prévia encontrou um erro, clique em Corrigir. A IA recebe o erro e faz a menor mudança possível para a página voltar a carregar. É uma criação normal, então usa créditos.
- Se a resposta da IA disser que uma página deu erro depois de ela verificar o seu app, responda "corrige" ou descreva o que você quer mudar.
- Se Corrigir não resolver, descreva o que você estava fazendo quando deu problema. Isso dá mais pistas para a IA:
A página /checkout está dando erro desde que eu pedi um campo de cupom de desconto. Descobre o que está causando isso e corrige mexendo o mínimo possível. Deixa todo o resto exatamente como está.
Se ainda assim não carregar, restaure a última versão que funcionava e peça a mudança de novo, em passos menores.
Depois que o seu app é publicado, a Buildliy verifica o seu site no ar a cada hora. Se duas verificações seguidas falharem, ela avisa você no chat (com um botão Corrigir) e por e-mail. Veja Como as criações são verificadas.
A prévia está em branco ou "acordando"
O que significa: a sua prévia roda em um servidorzinho próprio, que dorme quando você fica um tempo sem usar. Acordá-lo leva um instante.
| O que você vê | O que fazer |
|---|---|
| Reconectando sua prévia… "Seu ambiente de testes entrou em modo de descanso…" | Espere. Ela está trazendo o seu app de volta automaticamente, normalmente em 30 a 60 segundos. |
| "Ainda trabalhando — essa restauração está demorando mais que o normal." | Clique em Atualizar prévia. |
| Acordando sua prévia… em uma aba separada do navegador | Essa página recarrega sozinha quando a prévia estiver pronta. Se ela disser que a prévia adormeceu, clique em Abrir na Buildliy para acordá-la e depois volte para essa aba. |
| "Criando seu app — a prévia aparece aqui quando a primeira página estiver pronta." | A sua primeira criação ainda está em andamento. Espere ela terminar. |
| Uma página toda branca, sem nenhuma mensagem | Clique em Atualizar prévia (as setas circulares acima da prévia). Se continuar em branco, a página pode estar mesmo vazia: pergunte à IA. |
A página inicial está aparecendo toda em branco na prévia. Descobre por que não aparece nada e corrige, por favor.
Uma página está faltando
O que significa: você foi para um endereço que não é uma página do seu app. A prévia mostra Esta página ainda não existe.
O que fazer:
- Clique no endereço da página acima da prévia (como
/) para ver as Páginas encontradas no seu app e escolha uma. Você também pode digitar um endereço em Ir para o endereço e apertar Enter. - Para ver todas as páginas e como elas se ligam, abra Visão geral → Mapa do app.
- Se a página deveria existir, peça para a IA criá-la. Se um botão ou link leva para o lugar errado, diga qual:
Cria uma página Sobre em /about com a nossa história e fotos da equipe, e coloca um link "Sobre" no menu de todas as páginas.
O botão "Reservar agora" da página inicial leva pra uma página que não existe. Faz ele abrir a página de reservas.
A IA mudou algo que você não queria
O que significa: às vezes a IA muda mais do que você pediu, ou entende o pedido de um jeito diferente do que você quis dizer.
O que fazer: volte atrás e depois proteja o que você quer manter.
Restaure a versão de que você gostava
Passe o mouse sobre uma resposta da IA que mudou o seu app e clique na seta circular (Restaurar esta versão), ou abra o Histórico de versões (o ícone de relógio no topo do chat) e clique em Restaurar em qualquer versão. Restaurar é grátis (tirando o tempo de funcionamento da prévia), e as duas versões continuam no histórico do seu chat, para você poder avançar de novo. Para desfazer só a criação mais recente, clique no nome do seu projeto e escolha Desfazer última criação.
Peça de novo, com mais precisão
Diga exatamente o que deve mudar e o que precisa continuar igual.
Proteja as partes que você quer manter
Escolha qualquer uma destas opções:
- Trave um arquivo. Na aba Código, passe o mouse sobre um arquivo e clique no ícone de cadeado. As mudanças da IA em arquivos travados são bloqueadas e, se um pedido precisar de um deles, ela é instruída a pedir que você o destrave.
- Mantenha um elemento como está. Clique no ícone de seta acima da prévia para escolher um elemento e depois clique em Manter como está no cartão que aparece acima da caixa do chat. A IA é instruída a deixá-lo em paz nas próximas criações. Para desfazer, apague a linha dele em Visão geral → Conhecimento.
- Escreva uma regra permanente em Visão geral → Conhecimento, como "Nunca mude o logotipo nem o rodapé." Veja Conhecimento do projeto.
Restaurar desfaz as mudanças no código e no design do seu app. Os dados salvos do seu app (como cadastros ou pedidos) continuam como estão, a menos que você escolha voltar os dados também pelo Histórico de versões (disponível para o proprietário do projeto quando os dados do app estão na hospedagem da Buildliy). Veja Histórico de versões.
Muda só a cor do botão "Cadastre-se" para verde. Não mexe em mais nada na página.
A IA travou ou está andando em círculos
O que significa: mudanças grandes podem levar vários minutos, então uma criação demorada nem sempre está travada. Mas às vezes a IA fica presa tentando a mesma correção várias vezes.
O que fazer:
- Dê um tempinho. O status embaixo da criação diz o que a IA está fazendo, e mudanças maiores podem levar alguns minutos. Em uma primeira criação, se a IA ficar quieta por vários minutos, a área da prévia avisa. Quando uma correção precisa de mais de uma tentativa, o acompanhamento ao vivo avisa ("tentativa 2 de 3"), e se a criação estiver claramente travada, a Buildliy para e pede que você escolha entre dois caminhos. Veja Quando uma criação trava.
- Dê uma orientação. Enquanto uma criação está em andamento, digite uma observação na caixa do chat e deixe Adicionar a esta criação selecionado. A sua observação entra na criação no próximo passo, sem começar do zero.
- Pare. Clique no botão de parar na caixa do chat (Parar a criação atual). O trabalho já escrito é mantido, e você paga pelo trabalho já feito (toda criação usa pelo menos 1 crédito). O proprietário do projeto e os Admins da equipe podem parar qualquer criação; os Membros podem parar as criações que eles começaram. Parar também pausa a fila A seguir até você clicar em Retomar tudo.
- Mude de abordagem. Restaure a última versão boa e peça de novo em passos menores, ou mude para Conversar para falar sobre o problema antes de criar.
As criações também têm um tempo máximo de execução. Se uma criação chegar a esse limite, ela é encerrada automaticamente, as mudanças que a IA tinha terminado são salvas, e o chat diz "Esta criação ficou sem tempo antes de eu conseguir terminar." Envie um pedido de continuação bem direto para seguir em frente.
Quando pedir de novo, dê à IA as informações que faltavam:
O formulário de contato continua sem enviar. Quando eu clico em Enviar, não acontece nada e o formulário fica preenchido. Eu esperava aparecer um "Obrigado!" e a mensagem ficar salva no banco de dados. Descobre a causa antes de mexer em qualquer coisa e depois corrige só isso.
Os créditos acabaram durante uma criação
O que significa: as criações usam créditos aos poucos, conforme andam. Uma criação que já está em andamento ainda termina, mesmo se os seus créditos acabarem no meio. O que passar de zero aparece como saldo devedor no cartão Créditos, e os próximos créditos que você adicionar pagam isso primeiro. Novas criações precisam de pelo menos 1 crédito.
| O que você vê | O que significa | O que fazer |
|---|---|---|
| Sem créditos acima da caixa do chat | Você não tem mais créditos para novas criações. | Clique em Adicionar créditos ou em Fazer upgrade no plano Free. Em uma equipe, peça ao proprietário do projeto para adicionar créditos. |
Enquanto o seu saldo estiver em zero ou abaixo, as criações param, e os recursos de IA e os bancos de dados dos seus apps podem pausar até você adicionar créditos. Se a sua conta ainda estiver devendo créditos depois disso, as suas páginas publicadas também podem ser pausadas. Nada é apagado. Veja Créditos e uso.
A publicação falhou
O que significa: não foi possível colocar o seu app no ar, ou uma atualização nova não foi publicada. Se o seu app já estava no ar, a versão anterior continua funcionando ("Seu site no ar continua funcionando — a última atualização não foi publicada.").
Quando o servidor de publicação não consegue montar o seu app por causa de um problema no código, a Buildliy normalmente corrige e publica de novo sozinha, e um cartão acima da caixa do chat mostra como está indo. Veja Se a publicação falhar.
O que fazer:
| O que você vê | O que fazer |
|---|---|
| "… problemas para corrigir antes de publicar" ao passar o mouse sobre Publicar, ou um item Grave em Verificação de segurança antes de publicar | Abra Publicar e clique em Corrigir em cada item grave, ou em Corrigir e publicar para corrigir tudo e publicar de uma vez. As correções usam créditos. Você também pode ver a lista em Visão geral → Lançamento. Veja Checklist de lançamento. |
| "A criação publicada não compilou." | Peça à IA para corrigir o erro (ou use Corrigir se a prévia mostrar um) e depois publique de novo. |
| "A última publicação falhou" ou o status Falhou | Clique em Publicar para tentar de novo. Se falhar outra vez, peça à IA para corrigir a criação primeiro. |
| "Você acabou de publicar (ou tentou publicar) este projeto." | Espere um minuto e tente de novo. |
| "Você publicou 5 vezes na última hora neste projeto." | Espere um pouco antes de publicar de novo. |
| "O seu plano Free inclui 1 app no ar, e você já tem um publicado." | Tire o seu outro app do ar ou faça upgrade para o Pro. Veja Planos. |
A publicação falhou com "A criação publicada não compilou." Encontra e corrige o erro para o app compilar sem problemas, sem mudar a aparência dele.
O seu domínio personalizado não está funcionando
O que significa: os registros DNS do seu domínio ainda não apontam para o seu app, ou foram alterados. Domínios personalizados fazem parte do Pro.
Cada domínio mostra um status:
| Status | O que significa |
|---|---|
| Precisa de DNS | Adicione os registros que a Buildliy mostra na empresa onde você comprou o domínio. Esse status continua até os registros funcionarem. |
| Verificando o DNS… | A Buildliy adicionou os registros para você (na Cloudflare) e está esperando eles começarem a valer. |
| Problema no DNS | O domínio estava no ar, mas os registros dele mudaram e ele não aponta mais para o seu app. |
| No ar | O seu app está sendo exibido neste domínio por HTTPS. |
O que fazer:
- Abra Publicar → Conectar (ou Visão geral → Lançamento) e encontre o seu domínio. O painel de configuração dele lista os registros que você precisa adicionar. Compare cada registro com o que está no seu provedor de domínio. O tipo, o host e o valor precisam ser exatamente iguais.
- Apague os registros antigos que a Buildliy listar em "Depois, apague estes registros antigos".
- Se o seu provedor de DNS puder passar o tráfego pelo próprio proxy (alguns mostram isso como um ícone de nuvem laranja), desligue o proxy nesses registros para que fiquem como "somente DNS". Do contrário, o certificado de segurança não pode ser emitido.
- Clique em Verificar agora. A Buildliy também verifica automaticamente enquanto a página está aberta. A maioria dos provedores entra no ar em 5 a 30 minutos, mas alguns levam até 48 horas. Se um domínio continuar travado depois de 30 minutos, a Buildliy segue verificando em segundo plano e mostra no chat do seu projeto exatamente quais registros corrigir.
Veja Domínios personalizados para a configuração passo a passo.
Os e-mails de login não estão chegando
E-mails da Buildliy para você
Para a sua própria conta da Buildliy (confirmar o seu e-mail ou redefinir a sua senha):
- Olhe a sua pasta de spam ou lixo eletrônico.
- Na tela Confira seu e-mail, clique em Reenviar e-mail.
- Para redefinir a senha, use Esqueceu a senha? na página de login e abra o link no mesmo navegador.
- Se um link disser que expirou ou que já foi usado, peça um novo.
E-mails do seu app para os seus usuários
O login integrado na hospedagem da Buildliy deixa as pessoas se cadastrarem com e-mail e senha e entrarem logo em seguida. Ele envia por e-mail um lembrete de confirmação e links de redefinição de senha enquanto o e-mail do seu app estiver ligado. Se alguém não consegue entrar:
- Abra Gerenciar → Usuários para ver se a pessoa se cadastrou.
- Confira se o e-mail está ligado em Gerenciar → E-mail e depois olhe a pasta de spam dela.
- Envie uma redefinição de senha em Gerenciar → Usuários (o botão ... ao lado do nome da pessoa). Quando o e-mail do seu app estiver desligado, copie o link de uso único e envie você mesmo para ela.
- Se Exigir confirmação de e-mail estiver ligado, a pessoa precisa clicar no link de confirmação antes de conseguir entrar.
- Apps criados antes de 16 de outubro de 2026 mantêm o login original, que não envia e-mails. Para receber e-mails de redefinição de senha nesses apps, ligue Login social e redefinição de senha em Gerenciar → Usuários. Veja Login de usuários.
- Se o seu app usa o seu próprio projeto no Supabase, os e-mails de login dele são enviados pelo Supabase. Confira as configurações de e-mail e se a pessoa confirmou o e-mail dela no painel do seu Supabase.
Veja Envie e-mails e Login de usuários.
Os e-mails do meu app não estão chegando
O que significa: o seu app tentou enviar um e-mail, como uma confirmação de reserva, mas ele não foi enviado ou foi parar num lugar inesperado. O seu app continua funcionando de qualquer jeito.
O que fazer:
- Abra Gerenciar → E-mail e confira se E-mail neste app está ligado. Se a Buildliy tiver pausado o e-mail integrado, esta seção avisa.
- Confira se você ainda tem créditos. Cada e-mail usa uma quantidade bem pequena, e nenhum é enviado enquanto você estiver sem créditos. Veja Créditos e uso.
- Confira os limites diários. A seção mostra a contagem de hoje, como "12 de 1.000 e-mails hoje". A sua conta também tem um limite diário somando todos os seus apps. Quando um limite é atingido, os e-mails param até o dia seguinte.
- Olhe a pasta de spam ou lixo eletrônico. Os e-mails do seu app saem com o nome do seu app "via Buildliy", de
noreply@buildliymail.com. - Confira o endereço. Um endereço que devolveu o e-mail, marcou um e-mail como spam ou cancelou a inscrição deixa de receber os e-mails daquele app. Endereços de teste inventados, como
name@example.com, nunca recebem e-mail. Tente outro endereço. - Se você conectou o seu próprio serviço de e-mail, o seu app envia por ele. Confira o painel desse serviço e se o seu domínio de envio está verificado lá.
Veja Envie e-mails pelo seu app.
Os pagamentos não estão funcionando
O que significa: na maioria das vezes, o seu app ainda está no modo de teste, ou a sua conta do Stripe não está totalmente configurada.
O que fazer: abra Pagamentos na barra lateral esquerda do seu painel e leia o status no topo.
| O que você vê | O que fazer |
|---|---|
| Modo de teste | Os seus apps só recebem pagamentos de teste, sem risco, e nenhum dinheiro de verdade é movimentado. Teste com o número de cartão 4242 4242 4242 4242. Conecte o Stripe para receber pagamentos de verdade. |
| "O Stripe está verificando os seus dados" | Espere. O Stripe costuma terminar em poucos minutos, às vezes em até um dia. |
| "Quase lá — o Stripe precisa de mais dados" | Clique em Concluir configuração e complete os passos que o Stripe pedir. |
| "O Stripe não conseguiu aprovar esta conta" | Siga as instruções do Stripe ou fale com o Stripe. |
| "O Stripe está desconectado" ou "O checkout está pausado" | Reconecte o Stripe. Até você fazer isso, os compradores veem que os pagamentos estão pausados. |
Se os pagamentos estão configurados, mas um botão ainda não funciona, conte para a IA exatamente o que acontece:
Na página de preços, quando eu clico em "Comprar" no plano Pro, não acontece nada. Era pra abrir o checkout de US$ 29. Descobre a causa e corrige, por favor.
Veja Receba pagamentos.
Peça correções que funcionam
A IA corrige melhor os problemas quando sabe exatamente o que está errado. Um bom pedido de correção diz:
- Onde: a página ou a parte da página. Use o ícone de seta acima da prévia para apontar o elemento exato.
- O que você fez: o botão em que clicou ou o texto que digitou.
- O que você esperava e o que aconteceu em vez disso.
- O texto exato do erro, se houver.
- O que não pode mudar, para a correção ficar pequena.
Se a IA já tentou duas vezes e o problema continua, pare e mude de abordagem: restaure uma versão que funcionava e peça a mudança em passos menores.
Ainda está travado?
Procure nas perguntas frequentes ou fale com a equipe enviando o link do seu projeto e o que você já tentou.
Veja também
Ainda com dúvida? Leia as Perguntas frequentes ou fale com a gente.