Primeiros passos

FAQ

Perguntas frequentes sobre o Vibewax

Primeiros passos

Que tipos de projeto posso criar com o Vibewax?

O Vibewax foi pensado para criar sites institucionais, landing pages, portfólios, blogs, aplicativos web (formulários de contato, páginas de agendamento, sistemas de registro), apps e jogos 3D simples, materiais visuais e protótipos ou MVPs. Ele se destaca em sites com design profissional e carregamento rápido.

Para que tipos de projeto o Vibewax não é indicado?

O Vibewax não é a ferramenta certa para aplicações empresariais complexas, apps nativos para iOS ou Android, softwares de desktop ou projetos que exijam backends em PHP ou Python, WordPress ou Supabase. Ele trabalha exclusivamente com Next.js (React) e seu banco de dados integrado.

Posso criar meu projeto em outro idioma que não seja o inglês?

Sim, o Vibewax funciona totalmente em qualquer idioma. Basta dar as instruções ao agente no idioma que você preferir (português, tcheco, francês, alemão, espanhol etc.) e ele gera o conteúdo do projeto nesse idioma. Se você precisa de páginas multilíngues, descreva com clareza quais seções devem aparecer em cada idioma.

O Vibewax oferece autenticação e login de usuários?

Sim. O Vibewax pode configurar a autenticação com OTP (senha de uso único enviada por e-mail) ou com um login padrão por e-mail e senha. Basta descrever o que você precisa e o agente cuida da implementação.

Posso editar textos e fazer pequenos ajustes de design sem usar créditos?

Sim. As Edições visuais permitem clicar diretamente em textos, imagens e outros elementos na prévia e alterá-los sem enviar mensagem ao agente. Essas alterações são gravadas no projeto quando você salva e não usam créditos. A exceção é o recurso Perguntar à IA em um texto ou imagem, que usa créditos e mostra o preço antes de você executá-lo.

Posso usar o Vibewax no celular ou preciso baixar um app?

O Vibewax funciona muito bem no navegador do celular, então você pode criar e gerenciar seus projetos direto do telefone. A única exceção são as Edições visuais, disponíveis apenas em dispositivos com tela maior.

Publicação e deploy

Como publico meu projeto?

Clique no botão Publicar no canto superior direito do editor. Depois de publicado, seu site fica no ar em um subdomínio gratuito do Vibewax. Para conectar um domínio personalizado, acesse Configurações → Domínios.

A publicação está travada em construção há muito tempo. O que devo fazer?

Esse é um problema conhecido: a construção termina, mas a interface não atualiza. Entre em contato com o suporte com o link do seu projeto e a equipe redefine manualmente o estado da publicação. É muito provável que seu site já esteja no ar, mesmo que o painel ainda mostre que está em construção.

A prévia mostra as alterações, mas meu site publicado não. Por quê?

A URL da prévia e a URL publicada (seu subdomínio do Vibewax ou domínio personalizado) são ambientes separados. É preciso clicar em Publicar para enviar as alterações ao site publicado. Se o site publicado continuar sem atualizar depois da publicação, tente duplicar o chat e publicar de novo a partir da cópia. Isso costuma resolver problemas de deploy desatualizado.

Posso baixar o código-fonte do meu projeto?

Sim. Abra Configurações no seu projeto e use a opção de exportação para baixar um ZIP com o código-fonte.

Preciso avisar meus visitantes de que meu site foi feito com IA?

Todo site publicado traz uma tag ai-generated legível por máquina, mas ela não é um aviso visível para os seus leitores. Se você precisa informar algo mais sobre o seu conteúdo ou sobre os recursos de IA do seu próprio app, isso depende da legislação aplicável e do caso de uso. Uso responsável de IA explica os casos mais comuns.

Meu app tem um chatbot de IA próprio. O aviso de IA do Vibewax cobre isso?

Não. O aviso que você vê no Vibewax vale para o Vibewax. Se o seu projeto tem um chatbot ou qualquer outro recurso de IA, avisar os seus usuários finais faz parte da sua aplicação. Peça ao agente para adicionar um aviso acima do campo de entrada do chat ou no início da conversa.

Domínios e hospedagem

Como conecto meu próprio domínio personalizado?

No seu projeto, acesse Configurações → Domínios, digite o nome do seu domínio e clique em Conectar. Depois, siga o status exibido ali. Algumas configurações white-label configuram o DNS automaticamente ou ativam o domínio por meio de um proxy de parceiro. Se a plataforma mostrar registros DNS, adicione exatamente esses valores no seu registrador e volte para clicar em Atualizar.

Quais registros DNS preciso adicionar para o meu domínio personalizado?

Adicione registros somente quando Configurações → Domínios pedir. Nas configurações manuais, normalmente são necessários dois registros:

  • Um registro A para o domínio raiz, apontando para o endereço IP do Vibewax
  • Um registro CNAME para www, apontando para o hostname do Vibewax

Os valores exatos aparecem em Configurações → Domínios quando você adiciona o domínio.

Meu site funciona com www, mas mostra um erro de SSL no domínio sem www. Como corrijo?

Confira primeiro Configurações → Domínios. Se aparecer um registro apex ausente, adicione exatamente o registro A exibido ali e remova os registros A ou AAAA conflitantes do domínio raiz. Se o seu provedor white-label gerencia o DNS automaticamente ou usa um proxy de parceiro, atualize o status e fale com o suporte da sua marca, em vez de alterar registros às cegas.

Meu domínio ainda aparece como Pendente ou Não conectado. O que devo fazer?

Se a página disser que o DNS está sendo configurado automaticamente, aguarde alguns minutos e clique em Atualizar. Na configuração manual, confirme que os registros no seu registrador são exatamente iguais aos que a plataforma mostra e remova os registros conflitantes. A propagação do DNS pode levar até 24 horas. Nas configurações com proxy de parceiro, fale com o suporte da sua marca se o domínio não ativar.

Posso configurar e-mail para o meu domínio personalizado?

O Vibewax não oferece hospedagem de e-mail. Para ter e-mail no seu domínio personalizado (por exemplo, info@seusite.com), contrate um provedor terceirizado, como Google Workspace, Zoho ou Microsoft 365, e configure os registros MX deles no seu registrador. Com o endereço de e-mail pronto, o agente do Vibewax pode configurar formulários de contato para enviar notificações a ele.

E-mail e notificações

O Vibewax pode enviar e-mails a partir do meu projeto?

Sim. O Vibewax tem uma API de e-mail integrada, baseada no Resend. Para enviar a partir de um endereço do seu próprio domínio, você precisa ter uma conta e uma chave de API do Resend. Peça ao agente para configurar o envio de e-mails e informe o remetente e o destinatário que você quer.

Quais são os limites de envio de e-mails?

O limite padrão é de no máximo 10 e-mails por minuto por aplicação. O Vibewax só envia e-mails, não os recebe. Ele não é indicado para newsletters nem para e-mails de marketing em massa.

Os e-mails de login por OTP não estão chegando. O que devo fazer?

Primeiro, verifique a pasta de spam ou lixo eletrônico. Se os e-mails realmente não chegarem, entre em contato com o suporte com o link do seu projeto e o endereço de e-mail envolvido. A equipe pode investigar a entrega de e-mails no backend.

Trabalhando com o agente

O agente travou ou está demorando demais. O que posso fazer?

Se o agente não mostrar progresso por mais de 10 a 15 minutos, recarregue a página. Se a visualização estiver congelada, tente Rebuild Preview ou Restart App em sua barra de ferramentas. Se a última alteração interrompeu seu projeto, use Histórico de versões ou Restaurar esta versão. Se o problema persistir, entre em contato com o suporte com o link do chat e o horário aproximado. Os créditos consumidos durante uma sessão travada confirmada serão revisados.

O agente continua cometendo o mesmo erro. Como evito gastar créditos à toa?

Ao relatar um erro, seja o mais específico possível. Descreva o que você estava fazendo antes do erro, o que vê agora, o que não está funcionando e qual deveria ser o comportamento correto. Quanto mais detalhes você der, maiores as chances de o agente corrigir na primeira tentativa.

Quantos passos o agente pode dar por pedido?

O Vibewax tem cerca de 20 passos por pedido do usuário. Se o seu prompt for muito complexo, o agente pode não conseguir concluir tudo. Divida pedidos grandes em etapas menores e sequenciais: envie uma alteração específica por mensagem, confira se funcionou e só então siga para a próxima.

Como faço um backup do meu projeto?

Vibewax salva versões do projeto para que você possa restaurar o código anterior. Para suas próprias cópias, use GitHub para código, se seu plano suportar, e Exportar na aba Banco de dados para dados de tabela. O ZIP não inclui arquivos enviados para seu aplicativo. Uma duplicata copia o projeto atual, não um estado anterior do banco de dados.

Posso restaurar uma versão anterior do meu projeto?

Sim. Clique no ícone de relógio na barra superior para abrir o Histórico de versões, escolha uma versão para ver a prévia e clique em Restaurar. Você também pode usar o botão Restaurar esta versão abaixo de qualquer resposta do agente. Nos dois casos, o código do projeto volta ao estado em que estava naquele momento. Veja Histórico de versões. Isso restaura apenas o código, não os dados do banco de dados ou arquivos carregados no seu aplicativo. Publique novamente para atualizar seu site ativo.

Modelos de IA

Posso escolher qual modelo de IA o Vibewax usa?

Sim. O Vibewax roda em vários modelos de empresas diferentes, e você escolhe qual deles o agente usa. O GLM 5.3 Flash é o padrão. Ele é rápido, gasta poucos créditos e funciona bem na maioria das alterações do dia a dia. Veja Modelos de IA para a lista completa e para saber para que serve cada um.

Onde altero o modelo?

Você pode alterar o modelo em dois lugares. Para mudar em todos os seus chats, abra Configurações, vá para a aba Preferências e escolha um modelo em IA. Para escolher o modelo de um projeto específico, abra o chat, vá para a aba Configurações e escolha um modelo em Modelo de IA. A configuração do projeto sempre tem prioridade sobre a configuração da sua conta.

Qual modelo devo usar?

Fique no padrão, a menos que tenha um motivo para mudar. Passe para um modelo feito para trabalhos complexos quando for adicionar algo como contas de usuário, pagamentos ou uma lógica mais complexa. Use um modelo mais rápido e barato para edições de texto e pequenos ajustes. Veja Modelos de IA para as opções atuais.

Dois modelos parecem semelhantes. Como escolho entre eles?

Cada empresa constrói seus modelos de um jeito, e as diferenças aparecem mais no estilo do que na capacidade do modelo. Qual deles combina com você costuma depender do projeto e da preferência pessoal, então vale testar alguns.

O modelo que escolho muda quantos créditos eu uso?

Sim. O uso de créditos depende das tarifas do modelo selecionado e dos tokens que ele processa e gera. O tamanho da alteração e a duração da conversa também influenciam.

Onde os modelos são executados?

Cada modelo é marcado como EU, US ou Global. O roteamento Global pode processar as requisições em diferentes regiões, inclusive fora da UE. Se o seu projeto trata dados pessoais e você precisa que eles permaneçam na UE, escolha um modelo marcado como EU.

Posso trocar de modelo no meio de um projeto?

Sim. A sua escolha vale a partir da próxima mensagem. Tudo o que o agente já construiu continua como está, e ele mantém o histórico completo do seu projeto, então você pode trocar de modelo a qualquer momento sem perder nada.

Meu projeto usa um modelo que não está na lista. O que aconteceu?

Projetos criados há algum tempo podem ainda estar configurados com um modelo que foi desativado. Esses projetos continuam funcionando. Eles agora rodam na versão mais nova do mesmo modelo, então você recebe as melhorias sem fazer nada. Novos chats sempre usam a linha atual.

Problemas técnicos e erros

O que significa o código de erro 524 ou um timeout do Cloudflare?

O erro 524 é um timeout, ou seja, o servidor não respondeu a tempo. Atualize a página depois de um ou dois minutos. Se o problema continuar, entre em contato com o suporte com o link do seu chat.

A prévia mostra Falha ao iniciar a prévia ou o servidor de desenvolvimento caiu. O que devo fazer?

O servidor do sandbox caiu. Ele deve reiniciar automaticamente em um ou dois minutos. Se isso não acontecer, entre em contato com o suporte com o link do seu chat. A equipe pode reiniciar o sandbox e devolver os créditos consumidos durante a instabilidade.

Aparece "Application error: a client-side exception has occurred". O que está errado?

Isso costuma ser causado pela tradução automática de páginas do navegador, que interfere no editor do Vibewax. Desative a tradução do navegador para o domínio da plataforma e tente de novo. Se o erro aparecer no seu site publicado, relate ao agente com uma descrição clara ou entre em contato com o suporte.

O envio de imagens está falhando. Quais são os limites de tamanho?

Cada imagem não pode passar de 8000×8000 pixels. Se você enviar mais de 20 imagens em um único pedido, cada uma deve ter menos de 2000×2000 pixels. Os arquivos devem ter menos de 5 MB. Se aparecer um erro no envio de SVG, entre em contato com o suporte.

Duplicando projetos

Como duplico um projeto?

Abra o menu do chat e selecione Duplicar. Uma duplicata normal copia o projeto atual sem seu histórico de conversas e obtém um banco de dados separado. Os dados da tabela atual são copiados onde houver suporte; projetos mais antigos com uma configuração antiga de App Files podem começar com um banco de dados vazio e nenhum arquivo carregado. Publique a cópia e reconecte seu domínio personalizado, se necessário. Use Histórico de versões para recuperar uma versão de código anterior.

As cópias compartilham o mesmo banco de dados?

Não. Cada cópia recebe o próprio banco de dados, separado.

Posso compartilhar meu projeto para que outra pessoa o duplique na conta dela?

Sim. Clique em Compartilhar, ao lado do botão Publicar, e defina a visibilidade como Qualquer pessoa com o link. Compartilhe o link. Quem abri-lo poderá ver o projeto e duplicá-lo na própria conta do Vibewax.

Crio sites para clientes. Eles podem assumir o site na própria conta do Vibewax?

Sim. Qualquer projeto pode ser duplicado e compartilhado com o seu cliente. Ele pode então continuar desenvolvendo e gerenciando o site na própria conta do Vibewax, de forma independente de você.

Bancos de dados

Preciso configurar um banco de dados?

Não. Todo projeto do Vibewax recebe um automaticamente. Você não precisa configurar nada com um provedor, informar credenciais nem conectar coisa alguma. Descreva o que você quer armazenar, como envios de formulários de contato ou posts de blog, e o agente cria as tabelas e as integra ao seu projeto.

Qual banco de dados o Vibewax usa?

Cada projeto tem o próprio banco de dados isolado, com atualizações em tempo real e escalonamento automático, hospedado na UE. Veja Bancos de dados.

Como vejo e edito meus dados?

A aba Banco de dados lista suas tabelas e mostra as linhas de cada uma. Você pode filtrar e ordenar, editar valores ali mesmo, adicionar linhas ou excluí-las. A criação de tabelas e a mudança dos campos delas acontecem no código do seu projeto, então peça isso ao agente, por exemplo: “Adicione um campo de telefone à tabela Leads.”

Posso trabalhar com dados de teste em vez dos dados reais?

Sim. Na aba Banco de dados, clique em Adicionar modo de teste e o Vibewax cria um banco de dados de Teste, uma cópia separada dos seus dados em que você pode trabalhar sem alterar o que seus usuários veem. Você pode alternar entre os bancos de Produção e de Teste quando quiser e publicar a partir de qualquer um deles. Ao publicar a partir do Teste, uma verificação de compatibilidade roda primeiro para que seu app publicado continue funcionando com os dados existentes.

Como baixo uma cópia dos meus dados?

Exportar, na aba Banco de dados, baixa um ZIP com um instantâneo dos dados das suas tabelas, e Importar restaura um deles. Os arquivos que seu projeto armazena, como imagens enviadas, não fazem parte desse arquivo. Guarde um instantâneo antes de mudanças maiores, já que excluir linhas e importar um instantâneo substituem os dados de forma permanente.

SEO

Como o Vibewax lida com SEO?

O Vibewax cria sites otimizados para mecanismos de busca. Renderização no servidor, HTML limpo e meta tags ficam por conta do Vibewax. Depois que você publica o projeto, a auditoria de SEO avalia seu site e mostra o que melhorar. Você também pode editar meta tags, títulos de página e descrições em Configurações → SEO.

Por que não consigo executar a auditoria de SEO?

A auditoria na aba SEO verifica o seu site publicado, por isso ela fica bloqueada até você publicar. Se quiser uma pontuação antes disso, peça ao agente no chat para fazer uma auditoria de SEO e ele verifica uma prévia das suas edições atuais.

Minha auditoria de SEO parece desatualizada. Por quê?

A auditoria reflete a sua última versão publicada. Se você mudou algo desde então, publique o projeto de novo e os resultados da auditoria serão atualizados. Você também pode pedir ao agente que audite suas alterações não publicadas em uma prévia.

O que é a prontidão para IA?

A prontidão para IA mede o quanto os crawlers de IA, como os do ChatGPT, do Claude ou do Perplexity, conseguem acessar e entender o seu site. Ela verifica se o seu conteúdo está na própria página, e não carregado por JavaScript, se os crawlers de IA não estão bloqueados e se há um arquivo llms.txt para orientá-los. O Vibewax renderiza suas páginas no servidor automaticamente.

Como melhoro minha pontuação de SEO?

Percorra a lista de problemas, primeiro os erros e depois os avisos. Use o botão Corrigir tudo com IA e entregue todos os problemas de uma vez ao agente, ou resolva um por um. Depois, publique as alterações e a pontuação será atualizada na próxima auditoria.

Meu site não aparece na busca do Google. O que posso fazer?

A indexação do Google leva um tempo, geralmente de dias a semanas. Para acelerar, envie a URL do seu site ao Google Search Console em search.google.com/search-console. Você também pode compartilhar a URL nas redes sociais, já que o Google rastreia links que encontra em outros lugares da web.

Posso incorporar um site do Vibewax em outro site usando um iframe?

Tecnicamente sim, usando a URL publicada do seu site no Vibewax em um iframe. No entanto, o conteúdo dentro de iframes é mal indexado pelos mecanismos de busca, o que prejudica o seu SEO. Uma abordagem melhor é usar o Vibewax como um site independente, com domínio personalizado próprio.

Contas

Qual é a diferença entre minha conta e um workspace?

Sua conta é a sua identidade pessoal: seu e-mail, seu login e preferências pessoais, como tema e idioma. Um workspace é onde o trabalho acontece de verdade, com projetos e créditos próprios.

Por que algumas configurações mudam quando troco de workspace?

As configurações pessoais acompanham sua conta em qualquer lugar. Seu tema, idioma, modelo de IA preferido e notificações são os mesmos em todos os workspaces. As configurações do workspace são vinculadas a cada workspace, então domínios, chaves de API e conexões são diferentes em cada um.

Como altero meu endereço de e-mail?

Entre em contato com o suporte e informe o novo endereço de e-mail. A equipe faz a atualização no backend. Observação: não é possível usar um endereço de e-mail que já esteja cadastrado em outra conta do Vibewax.

Não consigo fazer login e não recebo os e-mails com OTP.

Verifique primeiro a pasta de spam ou lixo eletrônico. Se o e-mail não chegar de jeito nenhum, entre em contato com o suporte. A equipe pode verificar o status da sua conta e ajudar com a autenticação.

Como excluo minha conta permanentemente?

Entre em contato com o suporte e peça a exclusão da conta. A equipe exclui sua conta e todos os dados associados. Observação: essa ação é irreversível. Todos os projetos, créditos e dados serão removidos permanentemente.

Suporte

Como entro em contato com o suporte?

Entre em contato com o suporte da Vibewax e inclua o link do seu projeto e uma descrição do problema.

Como peço a revisão dos créditos usados por uma resposta que falhou?

Na resposta do agente afetada, escolha Relatar problema e, se a opção estiver disponível para o seu workspace, selecione Solicitar revisão de créditos. A revisão automática costuma levar cerca de um minuto e pode restaurar créditos em falhas claras do agente ou da plataforma. Se a opção não estiver disponível ou o resultado precisar de outra análise, entre em contato com o suporte com o link do chat e os detalhes do relatório.