> ## Documentation Index
> Fetch the complete documentation index at: https://vibewax.be/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Perguntas frequentes sobre o Vibewax

## Primeiros passos

<AccordionGroup>
  <Accordion title="Que tipo de projetos posso criar com o Vibewax?">
    O Vibewax é pensado para criar sites de marketing, landing pages, portfólios, blogs, aplicações web (formulários de contacto, páginas de reservas, sistemas de registo de dados), aplicações e jogos 3D simples, conteúdos visuais e protótipos ou MVPs. Destaca-se em sites com design profissional e carregamento rápido.
  </Accordion>

  <Accordion title="Para que tipo de projetos o Vibewax não é adequado?">
    O Vibewax não é a ferramenta certa para aplicações empresariais complexas, aplicações móveis nativas para iOS ou Android, software de ambiente de trabalho, ou projetos que exijam PHP, backends em Python, WordPress ou Supabase. Funciona exclusivamente com Next.js (React) e com a sua base de dados incorporada.
  </Accordion>

  <Accordion title="Posso criar o meu projeto numa língua diferente do inglês?">
    Sim, o Vibewax funciona plenamente em qualquer língua. Basta dares ao agente instruções na língua que preferires (checo, francês, alemão, espanhol, etc.) e ele gera o conteúdo do projeto nessa língua. Se precisares de páginas multilingues, descreve claramente que secções devem aparecer em que língua.
  </Accordion>

  <Accordion title="O Vibewax suporta autenticação e início de sessão de utilizadores?">
    Sim. O Vibewax pode configurar autenticação através de OTP (palavra-passe de utilização única enviada por email) ou de um sistema clássico de início de sessão com email e palavra-passe. Basta descreveres o que precisas e o agente implementa-o.
  </Accordion>

  <Accordion title="Posso editar textos e fazer pequenas alterações de design sem consumir créditos?">
    Sim. As [edições visuais](/docs/pt/features/visual-edits) permitem-te clicar diretamente em textos, imagens e outros elementos na pré-visualização e alterá-los sem enviar uma mensagem ao agente. Essas alterações são escritas no teu projeto quando guardas e não consomem créditos. A exceção é Perguntar à IA num texto ou numa imagem, que gasta créditos e mostra-te o preço antes de a executares.
  </Accordion>

  <Accordion title="Posso usar o Vibewax no telemóvel, ou preciso de transferir uma aplicação?">
    O Vibewax funciona muito bem num browser móvel, por isso podes criar e gerir os teus projetos diretamente do telemóvel. A única exceção são as Edições visuais, disponíveis apenas em dispositivos com ecrã maior.
  </Accordion>
</AccordionGroup>

## Publicação e implementação

<AccordionGroup>
  <Accordion title="Como publico o meu projeto?">
    Clica no botão **Publicar** no canto superior direito do editor. Depois de publicares, o teu site fica online num subdomínio Vibewax gratuito. Para ligar um domínio personalizado, vai a **Definições → Domínios**.
  </Accordion>

  <Accordion title="O processo de publicação está preso na compilação há muito tempo. O que devo fazer?">
    Este é um problema conhecido em que a compilação termina, mas a interface não é atualizada. Contacta o suporte com o link do teu projeto e eles repõem manualmente o estado de publicação. É muito provável que o teu site já esteja online, mesmo que o painel ainda mostre a compilação em curso.
  </Accordion>

  <Accordion title="A minha pré-visualização mostra alterações, mas o meu site online não as reflete. Porquê?">
    O URL da pré-visualização e o URL publicado (o teu subdomínio Vibewax ou domínio personalizado) são ambientes separados. Precisas de clicar em **Publicar** para levares as tuas alterações até ao site online. Se o site online continuar sem se atualizar depois de publicares, tenta duplicar o chat e publicar novamente a partir do duplicado. Isto costuma resolver problemas de implementação desatualizada.
  </Accordion>

  <Accordion title="Posso transferir o código-fonte do meu projeto?">
    Sim. Vai a **Definições** no teu projeto e usa a opção de exportação para transferir um ZIP com o teu código-fonte.
  </Accordion>

  <Accordion title="Tenho de dizer aos meus visitantes que o meu site foi feito com IA?">
    Todos os sites publicados têm uma etiqueta `ai-generated` legível por máquinas, mas isso não é um aviso visível para os teus leitores. Se precisas de divulgar algo mais sobre o teu conteúdo ou sobre as tuas próprias funcionalidades de IA depende da lei aplicável e do caso de uso específico. [Usar a IA de forma responsável](/docs/pt/security/using-ai-responsibly) percorre os casos mais comuns.
  </Accordion>

  <Accordion title="A minha aplicação tem o seu próprio chatbot de IA. O aviso de IA do Vibewax cobre isso?">
    Não. O aviso que vês no Vibewax aplica-se ao Vibewax. Se o teu projeto tiver um chatbot ou qualquer outra funcionalidade de IA, informar os teus utilizadores finais sobre isso faz parte da tua aplicação. Pede ao agente para adicionar um aviso acima do campo de chat ou no início da conversa.
  </Accordion>
</AccordionGroup>

## Domínios e Hosting

<AccordionGroup>
  <Accordion title="Como ligo o meu próprio domínio personalizado?">
    No teu projeto, vai a **Definições → Domínios**, escreve o nome do teu domínio e clica em **Ligar**. Depois segue o estado apresentado aí. Algumas configurações white-label configuram o DNS automaticamente ou ativam o domínio através de um proxy de parceiro. Se a plataforma mostrar registos DNS, adiciona esses valores exatos no teu registrador e volta para clicar em **Atualizar**.
  </Accordion>

  <Accordion title="Que registos DNS preciso de adicionar para o meu domínio personalizado?">
    Adiciona registos apenas quando **Definições → Domínios** to pedir. As configurações manuais normalmente precisam de dois registos:
    - Um **registo A** para o domínio raiz, apontando para o endereço IP do Vibewax
    - Um **registo CNAME** para `www`, apontando para o hostname do Vibewax

    Os valores exatos são mostrados em **Definições → Domínios** quando adicionas o teu domínio.
  </Accordion>

  <Accordion title="O meu site funciona em www mas mostra um erro de SSL no domínio simples. Como resolvo?">
    Verifica primeiro **Definições → Domínios**. Se mostrar um registo apex em falta, adiciona o registo A exato apresentado aí e remove os registos A ou AAAA em conflito para o domínio raiz. Se o teu fornecedor white-label gere o DNS automaticamente ou usa um proxy de parceiro, atualiza o estado e contacta a equipa de suporte da tua marca em vez de alterares registos às cegas.
  </Accordion>

  <Accordion title="O meu domínio continua a mostrar Pendente ou Não ligado. O que devo fazer?">
    Se a página indicar que o DNS está a ser configurado automaticamente, aguarda alguns minutos e clica em **Atualizar**. Numa configuração manual, confirma que os registos DNS no teu registrador correspondem exatamente ao que a plataforma mostra e remove os registos em conflito. A propagação DNS pode demorar até 24 horas. Nas configurações com proxy de parceiro, contacta a equipa de suporte da tua marca se o domínio não ficar ativo.
  </Accordion>

  <Accordion title="Posso configurar email para o meu domínio personalizado?">
    O Vibewax não fornece alojamento de email. Para email no teu domínio personalizado (por exemplo, info@oteusite.com), regista-te num fornecedor terceiro como o Google Workspace, Zoho ou Microsoft 365, e configura os respetivos registos MX junto do teu registrador. Assim que tiveres um endereço de email, o agente Vibewax pode configurar formulários de contacto para lhe enviar notificações.
  </Accordion>
</AccordionGroup>

## Email e notificações

<AccordionGroup>
  <Accordion title="O Vibewax pode enviar emails a partir do meu projeto?">
    Sim. O Vibewax tem uma API de email incorporada, com tecnologia Resend. Para enviar a partir de um endereço no teu próprio domínio, precisas da tua própria conta Resend e chave API. Pede ao agente para configurar a funcionalidade de email e indica o endereço de remetente e destinatário que pretendes.
  </Accordion>

  <Accordion title="Quais são os limites de envio de emails?">
    O limite predefinido é de no máximo 10 emails por minuto por aplicação. O Vibewax só pode enviar emails, não recebê-los. Não é adequado para newsletters ou emails de marketing em massa.
  </Accordion>

  <Accordion title="Os meus emails de início de sessão com OTP não estão a chegar. O que devo fazer?">
    Primeiro, verifica a tua pasta de spam ou de lixo eletrónico. Se os emails mesmo assim não estão a chegar, contacta o suporte com o link do teu projeto e o endereço de email envolvido. A equipa pode investigar a entrega de emails no backend.
  </Accordion>
</AccordionGroup>

## Trabalhar com o agente

<AccordionGroup>
  <Accordion title="O agente ficou preso ou está a demorar muito tempo. O que posso fazer?">
    Se o agente não mostrar progressos durante mais de 10 a 15 minutos, recarrega a página. Se a pré-visualização estiver bloqueada, tenta **Rebuild Preview** ou **Restart App** na barra de ferramentas. Se a última alteração estragou o projeto, usa o **Histórico de versões** ou **Restaurar esta versão**. Se o problema continuar, contacta o suporte com o link do chat e a hora aproximada. Os créditos gastos durante uma sessão bloqueada confirmada serão analisados.
  </Accordion>

  <Accordion title="O agente continua a cometer o mesmo erro. Como evito desperdiçar créditos?">
    Ao reportar um erro, sê o mais específico possível. Descreve o que estavas a fazer antes do erro, o que vês agora, o que não está a funcionar e qual deveria ser o comportamento correto. Quanto mais detalhe deres, melhor o agente consegue corrigi-lo à primeira.
  </Accordion>

  <Accordion title="Quantos passos pode o agente dar por pedido?">
    O Vibewax tem aproximadamente 20 passos por pedido do utilizador. Se o teu prompt for demasiado complexo, o agente pode não conseguir completar tudo. Divide pedidos grandes em passos sequenciais mais pequenos: envia uma alteração específica por mensagem, verifica que funciona e só depois avança.
  </Accordion>

  <Accordion title="Como crio uma cópia de segurança do meu projeto?">
    O Vibewax guarda versões do projeto para poderes restaurar código anterior. Para guardares as tuas próprias cópias, usa o [GitHub](/docs/pt/integrations/github) para o código, se o teu plano o permitir, e **Exportar** no separador **Base de dados** para os dados das tabelas. O ZIP não inclui ficheiros enviados para a tua app. Uma duplicação copia o estado atual do projeto, não um estado anterior da base de dados.
  </Accordion>

  <Accordion title="Posso restaurar uma versão anterior do meu projeto?">
    Sim. Clica no ícone do relógio na barra superior para abrir o **Histórico de versões**, escolhe uma versão para a veres e clica em **Restaurar**. Também podes usar o botão **Restaurar esta versão** por baixo de qualquer resposta do agente. Em ambos os casos, o código do projeto volta ao estado em que estava nesse momento. Vê [Histórico de versões](/docs/pt/chat/overview#histórico-de-versões). Isto restaura apenas o código, não os dados da base de dados nem os ficheiros enviados para a tua app. Publica novamente para atualizares o site.
  </Accordion>
</AccordionGroup>

## Modelos de IA

<AccordionGroup>
  <Accordion title="Posso escolher qual modelo de IA o Vibewax usa?">
    Sim. O Vibewax funciona com vários modelos de empresas diferentes, e podes escolher qual o agente usa. O GLM 5.3 Flash é o predefinido. É rápido, gasta poucos créditos e chega para a maioria das alterações do dia a dia. Consulta [Modelos de IA](/docs/pt/agent/models) para a lista completa e para que serve cada um.
  </Accordion>

  <Accordion title="Onde altero o modelo?">
    Podes alterar o modelo em dois sítios. Para o alterar em todos os teus chats, abre **Definições**, vai ao separador **Preferências** e escolhe um modelo em **IA**. Para escolher um modelo apenas para um projeto específico, abre esse chat, vai ao separador **Definições** e escolhe um modelo em **Modelo de IA**. A definição de um projeto tem sempre prioridade sobre a definição da tua conta.
  </Accordion>

  <Accordion title="Que modelo devo usar?">
    Mantém-te no predefinido a menos que tenhas um motivo para mudar. Passa para um modelo pensado para trabalho complexo quando estiveres a adicionar algo como contas de utilizador, pagamentos ou lógica mais complexa. Passa para um mais rápido e mais barato para edições de texto e pequenos ajustes. Consulta [Modelos de IA](/docs/pt/agent/models) para as opções atuais.
  </Accordion>

  <Accordion title="Dois modelos parecem semelhantes. Como escolho entre eles?">
    Cada empresa constrói os seus modelos de forma diferente, e as diferenças notam-se mais no estilo do que naquilo que o modelo consegue fazer. Qual te serve melhor depende muitas vezes do projeto e da preferência pessoal, por isso vale a pena experimentar alguns.
  </Accordion>

  <Accordion title="O modelo que escolho altera quantos créditos uso?">
    Sim. O consumo de créditos depende das tarifas do modelo escolhido e dos tokens que processa e gera. O tamanho da alteração e a duração da conversa também influenciam.
  </Accordion>

  <Accordion title="Onde é que os modelos são executados?">
    Cada modelo está marcado como **UE**, **EUA** ou **Global**. O encaminhamento global pode processar pedidos em diferentes regiões, incluindo fora da UE. Se o teu projeto lida com dados pessoais e precisas que esses dados fiquem na UE, escolhe um modelo marcado como **UE**.
  </Accordion>

  <Accordion title="Posso alterar o modelo a meio de um projeto?">
    Sim. A tua escolha aplica-se à tua próxima mensagem. Tudo o que o agente já construiu mantém-se como está, e ele conserva o histórico completo do teu projeto, por isso podes mudar de modelo a qualquer momento sem perder nada.
  </Accordion>

  <Accordion title="O meu projeto usa um modelo que não está na lista. O que aconteceu?">
    Projetos que começaste há algum tempo podem continuar definidos para um modelo entretanto descontinuado. Esses projetos continuam a funcionar. Passam a correr na versão mais recente do mesmo modelo, por isso recebes as melhorias sem fazeres nada. Os chats novos usam sempre a linha atual de modelos.
  </Accordion>
</AccordionGroup>

## Problemas técnicos e erros

<AccordionGroup>
  <Accordion title="O que significa o código de erro 524 ou um timeout da Cloudflare?">
    O erro 524 é um timeout, o que significa que o servidor não respondeu a tempo. Tenta atualizar a página passado um minuto ou dois. Se persistir, contacta o suporte com o link do teu chat.
  </Accordion>

  <Accordion title="A pré-visualização mostra Failed to Start ou o servidor de desenvolvimento falhou. O que devo fazer?">
    O servidor do sandbox falhou. Deve reiniciar automaticamente dentro de um a dois minutos. Se não o fizer, contacta o suporte com o link do teu chat. A equipa pode reiniciar o sandbox e reembolsar quaisquer créditos consumidos durante a interrupção.
  </Accordion>

  <Accordion title="Recebo o erro &quot;Application error: a client-side exception has occurred&quot;. O que se passa?">
    Muitas vezes isto é causado pela tradução automática de páginas do teu browser, que interfere com o editor do Vibewax. Desativa a tradução do browser para o domínio da plataforma e tenta novamente. Se o erro aparecer no teu site publicado, reporta-o ao agente com uma descrição clara ou contacta o suporte.
  </Accordion>

  <Accordion title="O carregamento de imagens está a falhar. Quais são os limites de tamanho?">
    As imagens individuais não podem exceder 8000×8000 pixels. Se carregares mais de 20 imagens num único pedido, cada uma tem de ficar abaixo dos 2000×2000 pixels. Os ficheiros devem ficar abaixo dos 5 MB. Se encontrares um erro ao carregar um SVG, contacta o suporte.
  </Accordion>
</AccordionGroup>

## Duplicar projetos

<AccordionGroup>
  <Accordion title="Como duplico um projeto?">
    Abre o menu do chat e seleciona **Duplicar**. Uma duplicação normal copia o projeto atual sem o histórico do chat e recebe uma base de dados separada. Os dados atuais das tabelas são copiados quando possível; projetos mais antigos que usam App Files podem começar com uma base de dados vazia e sem ficheiros enviados. Publica a cópia e volta a ligar o domínio personalizado, se necessário. Usa o **Histórico de versões** para recuperares uma versão anterior do código.
  </Accordion>

  <Accordion title="Os duplicados partilham a mesma base de dados?">
    Não. Cada duplicado recebe a sua própria base de dados separada.
  </Accordion>

  <Accordion title="Posso partilhar o meu projeto para que outra pessoa o duplique na sua própria conta?">
    Sim. Clica em **Partilhar**, junto ao botão **Publicar**, e define a visibilidade como **Qualquer pessoa com a ligação**. Depois partilha a ligação. Quem a abrir pode ver o projeto e duplicá-lo na sua própria conta Vibewax.
  </Accordion>

  <Accordion title="Crio sites para clientes. Eles podem assumir o site na sua própria conta Vibewax?">
    Sim. Qualquer projeto pode ser duplicado e partilhado com o teu cliente. Ele pode depois continuar a desenvolver e a gerir o site na sua própria conta Vibewax, de forma independente de ti.
  </Accordion>
</AccordionGroup>

## Bases de dados

<AccordionGroup>
  <Accordion title="Preciso de configurar uma base de dados?">
    Não. Todos os projetos Vibewax recebem uma automaticamente. Não precisas de configurar nada com um fornecedor, introduzir credenciais nem ligar seja o que for. Descreve o que queres guardar, como submissões de formulários de contacto ou artigos de blog, e o agente cria as tabelas e integra-as no teu projeto.
  </Accordion>

  <Accordion title="Que base de dados usa o Vibewax?">
    Cada projeto tem a sua própria base de dados isolada com atualizações em tempo real e escalabilidade automática, alojada na UE. Consulta [Bases de dados](/docs/pt/features/databases).
  </Accordion>

  <Accordion title="Como visualizo e edito os meus dados?">
    O separador **Base de dados** lista as tuas tabelas e mostra as linhas de cada uma. Podes filtrá-las e ordená-las, editar valores diretamente aí, adicionar linhas ou eliminá-las. Criar tabelas e alterar os campos que têm acontece no código do teu projeto, por isso pede isso ao agente, por exemplo: "Adiciona um campo de telefone à tabela Leads."
  </Accordion>

  <Accordion title="Posso trabalhar com dados de teste em vez dos meus dados reais?">
    Sim. No separador **Base de dados**, clica em **Adicionar modo de teste** e o Vibewax cria uma base de dados **Teste**, uma cópia separada dos teus dados na qual podes trabalhar sem alterar o que os teus utilizadores veem. Podes alternar entre as tuas bases de dados Em direto e Teste sempre que quiseres, e publicar a partir de qualquer uma delas. Publicar a partir da base de dados Teste começa com uma verificação de compatibilidade, para que a tua app publicada continue a funcionar com os dados que já tem.
  </Accordion>

  <Accordion title="Como transfiro uma cópia dos meus dados?">
    **Exportar** no separador **Base de dados** transfere um instantâneo em ZIP dos dados das tuas tabelas, e **Importar** restaura um. Os ficheiros que o teu projeto guarda, como imagens carregadas, não fazem parte desse ficheiro. Guarda um instantâneo antes de alterações maiores, já que eliminar linhas e importar um instantâneo substituem os dados de forma permanente.
  </Accordion>
</AccordionGroup>

## SEO

<AccordionGroup>
  <Accordion title="Como é que o Vibewax trata o SEO?">
    O Vibewax constrói sites otimizados para motores de busca. A renderização no servidor, o HTML limpo e as meta tags são todos tratados pelo Vibewax por ti. Assim que publicas o teu projeto, a auditoria de SEO avalia o teu site e diz-te o que melhorar. Também podes editar meta tags, títulos de página e descrições em **Definições → SEO**.
  </Accordion>

  <Accordion title="Porque não consigo executar a auditoria de SEO?">
    A auditoria no separador SEO verifica o teu site publicado, por isso fica bloqueada até publicares. Se quiseres saber a pontuação antes disso, pede ao agente no chat uma auditoria de SEO e ele verifica uma pré-visualização das tuas alterações atuais.
  </Accordion>

  <Accordion title="A minha auditoria de SEO parece desatualizada. Porquê?">
    A auditoria reflete a tua última versão publicada. Se alteraste algo desde então, publica o teu projeto novamente e os resultados da auditoria são atualizados. Também podes pedir ao agente para auditar as tuas alterações não publicadas numa pré-visualização.
  </Accordion>

  <Accordion title="O que é a preparação para IA (AI readiness)?">
    A preparação para IA mede até que ponto os crawlers de IA, como os do ChatGPT, Claude ou Perplexity, conseguem aceder ao teu site e compreendê-lo. Verifica se o teu conteúdo está na própria página em vez de ser carregado com JavaScript, se os crawlers de IA não estão bloqueados e se existe um ficheiro llms.txt disponível para os orientar. O Vibewax renderiza as tuas páginas no servidor automaticamente.
  </Accordion>

  <Accordion title="Como melhoro a minha pontuação de SEO?">
    Percorre a lista de problemas, primeiro os erros e depois os avisos. Podes usar o botão Corrigir tudo com IA e entregar todos os problemas ao agente de uma vez, ou resolvê-los um a um. Depois publica as tuas alterações e a pontuação atualiza-se na auditoria seguinte.
  </Accordion>

  <Accordion title="O meu site não aparece na pesquisa do Google. O que posso fazer?">
    A indexação do Google demora algum tempo, muitas vezes dias a semanas. Para acelerar o processo, submete o URL do teu site na Google Search Console em search.google.com/search-console. Também podes partilhar o teu URL nas redes sociais, já que o Google rastreia links que encontra noutros pontos da web.
  </Accordion>

  <Accordion title="Posso incorporar um site Vibewax noutro site usando um iframe?">
    Tecnicamente sim, usando o teu URL Vibewax publicado num iframe. No entanto, o conteúdo dentro de iframes é mal indexado pelos motores de busca, o que tem um impacto negativo no teu SEO. Uma abordagem melhor é usar o Vibewax como um site independente com o seu próprio domínio personalizado.
  </Accordion>
</AccordionGroup>

## Contas

<AccordionGroup>
  <Accordion title="Qual é a diferença entre a minha conta e um espaço de trabalho?">
    A tua conta é a tua identidade pessoal: o teu email, o início de sessão e preferências pessoais como o tema e o idioma. Um espaço de trabalho é onde o trabalho de facto acontece, com os seus próprios projetos e créditos.
  </Accordion>

  <Accordion title="Porque é que algumas definições mudam quando troco de espaço de trabalho?">
    As definições em Pessoal acompanham a tua conta em todo o lado. O teu tema, idioma, preferência de modelo de IA e notificações mantêm-se iguais em todos os espaços de trabalho. As definições em Espaço de trabalho estão associadas a cada espaço de trabalho, por isso os domínios, chaves API e ligações são diferentes em cada um.
  </Accordion>

  <Accordion title="Como altero o meu endereço de email?">
    Contacta o suporte e indica o novo endereço de email. Eles atualizam-no no backend. Nota: não podes usar um endereço de email que já esteja registado noutra conta Vibewax.
  </Accordion>

  <Accordion title="Não consigo iniciar sessão e não estou a receber os emails de OTP.">
    Verifica primeiro a pasta de spam ou de lixo eletrónico. Se o email mesmo assim não chega, contacta o suporte. Eles podem verificar o estado da tua conta e ajudar com a autenticação.
  </Accordion>

  <Accordion title="Como elimino permanentemente a minha conta?">
    Contacta o suporte e pede a eliminação da conta. Eles eliminam a tua conta e todos os dados associados. Nota: esta ação é irreversível. Todos os projetos, créditos e dados serão removidos permanentemente.
  </Accordion>
</AccordionGroup>

## Suporte

<AccordionGroup>
  <Accordion title="Como contacto o suporte?">
    Contacta o [suporte da Vibewax](https://www.mediawax.be/helpdesk/) com o link do teu projeto e uma descrição do problema.
  </Accordion>

  <Accordion title="Como peço uma revisão dos créditos usados por uma resposta falhada?">
    Na resposta do agente em causa, escolhe **Reportar problema** e, se a opção estiver disponível para o teu espaço de trabalho, seleciona **Solicitar revisão de créditos**. A revisão automática costuma demorar cerca de um minuto e pode repor créditos em falhas claras do agente ou da plataforma. Se a opção não estiver disponível ou o resultado precisar de nova análise, contacta o suporte com o link do chat e os detalhes do reporte.
  </Accordion>

</AccordionGroup>


This page is part of the [Vibewax documentation](https://vibewax.be/docs/pt/welcome/overview).