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

# FAQ

> Perguntas frequentes sobre o Macaly

## Primeiros passos

<AccordionGroup>
  <Accordion title="Que tipo de projetos posso criar com o Macaly?">
    O Macaly é 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 Macaly não é adequado?">
    O Macaly 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 o Convex como base de dados.
  </Accordion>

  <Accordion title="Posso criar o meu projeto numa língua diferente do inglês?">
    Sim, o Macaly 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 Macaly suporta autenticação e início de sessão de utilizadores?">
    Sim. O Macaly 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 são **Reescrever com IA** e **Gerar com IA**, que gastam créditos e mostram-te o preço antes de os executares.
  </Accordion>

  <Accordion title="Posso usar o Macaly no telemóvel, ou preciso de transferir uma aplicação?">
    O Macaly 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>

## Atualização de preços: outubro de 2026

<AccordionGroup>
  <Accordion title="O que mudou na atualização de preços de outubro de 2026?">
    A 8 de outubro de 2026, o Macaly lançou o plano **Starter** (8,80 €/mês) e definiu limites claros para o plano Grátis: apps publicadas, armazenamento de ficheiros, um limite indicativo de tráfego do site e 100 ações Cloud por mês. O plano **Hosting** deixou de ser oferecido a novos clientes. O plano Pro não mudou. Vê [Planos e créditos](/docs/pt/welcome/pricing) para saberes o que cada plano inclui.
  </Accordion>

  <Accordion title="O que é o plano Starter e para quem é?">
    O Starter custa 8,80 € por mês (ou 210 Kč, consoante a tua moeda de faturação) e é faturado apenas mensalmente. Foi pensado para publicar uma app no teu próprio domínio personalizado, sem o selo do Macaly. Inclui:

    * 1M créditos por mês
    * 1 app publicada no teu próprio domínio personalizado (a compra do domínio é cobrada à parte)
    * 5 GiB de armazenamento de ficheiros
    * 5 GiB de uso da base de dados
    * Um limite indicativo de 5 GB de tráfego do site
    * Sem limite mensal de ações Cloud
    * Suporte por email e 3 meses de retenção de análises

    O Starter não inclui a integração com o GitHub. Se precisares de mais créditos ou de mais espaço, escolhe o [Pro](/docs/pt/welcome/pricing).
  </Accordion>

  <Accordion title="Estou no plano Hosting. O que acontece comigo?">
    Nada muda. Manténs o teu plano Hosting, o preço e as funcionalidades. Podes continuar a geri-lo ou cancelá-lo na **Faturação**.
  </Accordion>

  <Accordion title="Ainda posso comprar o plano Hosting?">
    Não. O Hosting deixou de ser oferecido a novos clientes. Para manteres um site online no teu próprio domínio, escolhe o Starter.
  </Accordion>

  <Accordion title="Estou no plano Grátis com várias apps publicadas. O que acontece com elas?">
    O plano Grátis inclui 1 app publicada. Se tiveres mais, enviamos primeiro um e-mail aos proprietários e administradores do espaço de trabalho e damos-te tempo para escolher qual fica online (o e-mail indica a data exata). Também podes mudar para um plano que inclua mais apps publicadas. Depois do prazo, as restantes apps são despublicadas. Os teus projetos e dados mantêm-se, e podes voltar a publicá-las depois de fazeres upgrade ou quando estiveres dentro do limite do teu plano. As apps despublicadas também são removidas da galeria da comunidade.

    Até lá, publicar uma nova app exige uma vaga livre. Para libertar uma vaga, despublica uma app. A vaga volta a ficar disponível em poucos minutos. Os rascunhos e as pré-visualizações não contam para o limite. Vê [Apps publicadas acima do limite](/docs/pt/account/workspaces/usage#apps-publicadas-acima-do-limite).
  </Accordion>

  <Accordion title="O que são ações Cloud e o que conta?">
    As ações Cloud são o que os agentes de IA externos, como o ChatGPT, o Claude ou outros clientes MCP, fazem através do [Macaly Cloud](/docs/pt/integrations/macaly-cloud). Estas contam:

    * Criar ou duplicar uma app
    * Escrever, editar ou eliminar ficheiros
    * Executar comandos
    * Carregar ficheiros
    * Publicar
    * Ligar um domínio

    Ler ficheiros, listar e as pré-visualizações são gratuitos. Conversar com o Macaly dentro da app não usa ações Cloud.
  </Accordion>

  <Accordion title="Quem tem um limite de ações Cloud e quando é reposto?">
    O plano Grátis inclui 100 ações Cloud por mês. Os planos pagos não têm limite mensal de ações Cloud. O limite do plano Grátis é partilhado por todo o espaço de trabalho e é reposto no dia 1 de cada mês (UTC). As ações Cloud não usadas não transitam.
  </Accordion>

  <Accordion title="O que acontece quando uso todas as minhas ações Cloud?">
    As ações contabilizadas seguintes são recusadas. A mensagem mostra a data em que o limite é reposto e um link para a **Faturação**. A leitura de ficheiros, as apps que já estão online e a conversa com o Macaly dentro da app continuam a funcionar.
  </Accordion>

  <Accordion title="Posso passar do Pro para o Starter? E se ultrapassar os limites do Starter?">
    Sim. Os downgrades têm efeito no fim do período de faturação atual. Na **Faturação**, agenda a mudança para o Starter ou escolhe o Starter ao cancelares o Pro. O Pro e os seus créditos mantêm-se até à data de renovação.

    Na renovação, o Macaly verifica o espaço de trabalho. Se tiver mais de 1 app publicada ou mais de 5 GiB de ficheiros, a mudança é cancelada e o Pro é renovado. Esta verificação nunca despublica nem elimina nada. Podes anular uma mudança agendada com **Manter o Pro**.
  </Accordion>

  <Accordion title="Como passo do plano Grátis para o Starter ou o Pro?">
    Abre a **Faturação** e escolhe o plano. Os upgrades têm efeito imediato: pagas o preço total do novo plano, recebes todos os seus créditos e o teu período de faturação recomeça.
  </Accordion>

  <Accordion title="O que acontece quando o meu armazenamento de ficheiros está cheio?">
    Os novos carregamentos, e a cópia de uma base de dados, são recusados até libertares espaço. Os ficheiros existentes continuam legíveis e as apps publicadas continuam online.
  </Accordion>

  <Accordion title="O tráfego do site é limitado?">
    Hoje não. O valor de tráfego de cada plano é apenas um limite indicativo. Não é medido, aplicado nem cobrado.
  </Accordion>

  <Accordion title="Onde posso ver o meu uso?">
    A **Faturação** e **Definições → Uso e limites** (vê [Uso e limites](/docs/pt/account/workspaces/usage)) mostram as tuas ações Cloud (plano Grátis), as apps publicadas, o armazenamento de ficheiros e o limite indicativo de tráfego.
  </Accordion>

  <Accordion title="O que é a barra no topo do Macaly?">
    Nos planos Grátis e Starter, uma barra no topo do ecrã principal e dos chats avisa-te quando o teu espaço de trabalho está perto de um limite do plano ou o ultrapassou. Fica âmbar aos 80 % e vermelha quando um limite é atingido ou ultrapassado (as apps publicadas só ficam a vermelho quando tens mais apps online do que o teu plano inclui). Apenas informa: não pode ser fechada e, por si só, não despublica nada. Vê [Avisos de limites do plano](/docs/pt/account/workspaces/usage#avisos-de-limites-do-plano).
  </Accordion>

  <Accordion title="Os créditos mudaram?">
    Os novos espaços de trabalho Grátis recebem 1 milhão de créditos por mês. Quanto ao resto, os créditos e as recargas funcionam como antes.
  </Accordion>

  <Accordion title="Como funcionam os blocos de excedente da base de dados no Starter, no Pro e nas Agências?">
    O Starter inclui 5 GiB de uso da base de dados por mês e o Pro inclui 10 GiB. No Starter, no Pro e nas Agências, cada 1 GiB adicional iniciado num mês do calendário custa 200K créditos. Se fizeres upgrade do plano Grátis ou do Hosting a meio do mês, o limite do teu plano pago começa no momento do upgrade e o uso anterior nunca é cobrado. Vê [Planos e créditos](/docs/pt/welcome/pricing) para a tabela completa.
  </Accordion>
</AccordionGroup>

## Planos e créditos

<AccordionGroup>
  <Accordion title="Como funciona o sistema de créditos?">
    Os créditos são consumidos sempre que envias um prompt ao agente Macaly. A quantidade depende da complexidade da tarefa. Os utilizadores do plano Grátis recebem 1 milhão de créditos por mês. Os créditos dos planos pagos são válidos por 30 dias. Os utilizadores de um plano pago (Starter ou Pro) também podem comprar recargas pontuais de créditos, válidas por 60 dias.
  </Accordion>

  <Accordion title="Os créditos acumulam para o mês seguinte?">
    Não. Cada período de faturação começa com um novo conjunto de créditos e quaisquer créditos não usados expiram no fim do período. Podes comprar recargas pontuais de créditos, válidas por 60 dias a partir da data da compra.
  </Accordion>

  <Accordion title="Posso comprar créditos extra sem atualizar o meu plano?">
    Sim. Se estiveres num plano pago (Starter ou Pro), podes comprar uma recarga pontual de créditos em macaly.com/billing. Os créditos de recarga são válidos por 60 dias, mais tempo do que o período de faturação normal de 30 dias. Se estiveres no plano Grátis e precisares de mais créditos, terás primeiro de atualizar para um plano pago.
  </Accordion>

  <Accordion title="Posso atualizar ou fazer downgrade do meu plano a qualquer momento?">
    Sim. As atualizações têm efeito imediato: és cobrado pelo valor total, recebes todos os créditos e o teu ciclo de faturação é reiniciado. Pode haver um pequeno atraso no processamento antes de o teu saldo de créditos ser atualizado; normalmente basta atualizar a página. Os créditos não usados do nível anterior continuam disponíveis até ao fim do período atual. Os downgrades, incluindo a mudança de Pro para Starter ou para o plano Grátis, têm efeito no fim do teu período de faturação atual.
  </Accordion>

  <Accordion title="O que acontece se eu ficar sem créditos?">
    Se estiveres no Starter, podes comprar uma recarga pontual de créditos ou atualizar para o Pro. Se estiveres no Pro, podes comprar uma recarga pontual de créditos ou atualizar para um plano superior. Se estiveres no plano Grátis, terás de atualizar para continuar a usar o agente. Todos os teus projetos permanecem ativos e o teu trabalho não é afetado.
  </Accordion>

  <Accordion title="Porque tenho 0 créditos se não usei nenhum?">
    Os utilizadores do plano Grátis recebem 1 milhão de créditos por ciclo de faturação mensal. Se o teu saldo mostrar 0 e não tiveres usado créditos, [contacta o suporte](mailto:support@macaly.com). Eles podem investigar a tua conta. Os créditos dos planos pagos são adicionados no início de cada ciclo de faturação de 30 dias.
  </Accordion>

  <Accordion title="O Macaly teve um problema e consumiu os meus créditos. Posso obter um reembolso?">
    Depende da situação. Se ocorreu um problema confirmado ao nível da plataforma (como o agente ficar preso, um crash do sandbox ou uma interrupção do serviço), [contacta o suporte](mailto:support@macaly.com) com o link para o chat afetado e a equipa analisa o caso e devolve os créditos conforme apropriado.

    Se o agente estava a responder normalmente mas precisou de várias tentativas para corrigir algo, este é o comportamento esperado de agentes de IA. Para obter os melhores resultados e evitar o uso desnecessário de créditos, dá ao agente o máximo de contexto possível, incluindo capturas de ecrã e descrições claras, em vez de enviares repetidamente comandos de correção. Se o agente não conseguir resolver um problema mesmo tendo todo o contexto, [contacta o suporte](mailto:support@macaly.com) e a equipa investiga caso a caso.
  </Accordion>

  <Accordion title="Como aplico um código promocional ou de desconto?">
    Se estiveres a fazer a tua primeira compra, podes introduzir um código promocional durante o checkout na página de faturação. Se já tens um plano pago ativo, os códigos promocionais não podem ser introduzidos diretamente. [Contacta o suporte](mailto:support@macaly.com) com o teu código e a equipa aplica o desconto manualmente na tua conta.
  </Accordion>

  <Accordion title="O que acontece se eu estiver num plano antigo Pro, Plus ou Ultra?">
    Com a atualização de preços, todos os planos antigos Pro, Plus e Ultra passam a incluir as mesmas funcionalidades do plano Pro atual. As tuas mensagens restantes foram convertidas a uma taxa de 1 mensagem = 100 000 créditos. Podes continuar a usar o teu plano atual até este terminar, mas só podes mudar para um dos novos planos daqui em diante.
  </Accordion>
</AccordionGroup>

## Faturação e subscrições

<AccordionGroup>
  <Accordion title="Como cancelo a minha subscrição?">
    Vai a macaly.com/billing, clica em **Gerir** no teu plano atual e depois seleciona **Cancelar subscrição**. Após o cancelamento, o teu acesso continua até ao fim do período de faturação atual. O plano Grátis inclui 1 app publicada. Se tiveres mais, enviamos-te primeiro um e-mail e damos-te tempo para escolher qual fica. As restantes são despublicadas; os teus projetos e dados mantêm-se e podes voltar a publicá-las depois de fazeres upgrade ou quando estiveres dentro do limite do teu plano.
  </Accordion>

  <Accordion title="Em que moedas posso ser faturado?">
    O Macaly aceita faturação em USD, EUR e CZK. Usa o seletor de moeda no canto superior direito da página de Faturação para escolher. A tua seleção define a moeda em que és efetivamente cobrado, não apenas a forma como os preços são apresentados.
  </Accordion>

  <Accordion title="Posso mudar a moeda de faturação depois de subscrever?">
    Podes mudar a moeda de faturação livremente antes de iniciares uma subscrição. Se já tens uma subscrição ativa, [contacta o suporte](mailto:support@macaly.com) e a equipa muda-a por ti.
  </Accordion>

  <Accordion title="Como encontro as minhas faturas e recibos?">
    Vai a macaly.com/billing e clica no separador **Faturas**. Todas as faturas anteriores estão listadas aí e podem ser transferidas individualmente.
  </Accordion>

  <Accordion title="Porque é que fui cobrado mais do que esperava?">
    Quando atualizas o teu plano, és cobrado imediatamente pelo valor total do novo nível, não apenas pela diferença. Por exemplo, atualizar de 22 €/mês para 44 €/mês cobra 44 € de imediato. Se achas que uma cobrança foi feita por engano, [contacta o suporte](mailto:support@macaly.com). Eles podem processar um reembolso se os créditos do nível atualizado ainda não tiverem sido usados.
  </Accordion>

  <Accordion title="Posso obter um reembolso de uma renovação de subscrição que me esqueci de cancelar?">
    [Contacta o suporte](mailto:support@macaly.com) assim que possível. Os reembolsos de renovações acidentais são tratados caso a caso. Se ainda não usaste os créditos renovados, os reembolsos costumam ser possíveis. A política de reembolso do Macaly está descrita na Secção 7 dos Termos de Serviço em macaly.com/terms-of-service.
  </Accordion>

  <Accordion title="Existe um plano mais barato para um site no meu próprio domínio?">
    Sim. O plano Starter (8,80 €/mês, faturado mensalmente) inclui 1 app publicada no teu próprio domínio personalizado, sem o distintivo Made with Macaly, e 1M créditos por mês. A compra do domínio é cobrada à parte. O Starter não inclui a integração com o GitHub.

    **Para mudar de Pro para Starter**, agenda a mudança na **Faturação** ou escolhe o Starter ao cancelares o Pro. O Pro e os seus créditos mantêm-se até à data de renovação. Na renovação, o Macaly verifica o espaço de trabalho. Se tiver mais de 1 app publicada ou mais de 5 GiB de ficheiros, a mudança é cancelada e o Pro é renovado. Esta verificação nunca despublica nem elimina nada. Podes anular uma mudança agendada com **Manter o Pro**.
  </Accordion>

  <Accordion title="Ainda posso mudar para o plano Hosting?">
    Não. O Hosting deixou de ser oferecido a novos clientes. Se já estás no Hosting, manténs o teu plano, o preço e as funcionalidades, e podes continuar a geri-lo ou cancelá-lo na **Faturação**.
  </Accordion>

  <Accordion title="O que acontece ao meu domínio personalizado se eu cancelar o meu plano Pro?">
    Se cancelares o Pro e voltares ao plano Grátis, o teu domínio personalizado volta ao URL predefinido do Macaly e o distintivo Made with Macaly volta a aparecer. Para manter ambos, muda antes para o plano Starter (8,80 €/mês): agenda a mudança na Faturação ou escolhe o Starter ao cancelares o teu plano Pro.
  </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 Macaly gratuito (por exemplo, `oteuprojeto.macaly.app`). Para ligar um domínio personalizado, vai a **Definições → Domínios**. Um domínio personalizado requer um plano Starter, Pro ou Agências, ou um plano Hosting existente.
  </Accordion>

  <Accordion title="O processo de publicação está preso na compilação há muito tempo. O que devo fazer?">
    Abre a janela de publicação. Se mostrar **Não é possível verificar o estado**, clica em **Tentar de novo**. O Macaly volta a verificar sem iniciar uma nova compilação. Se continuar preso, [contacta o suporte](mailto:support@macaly.com) com o link do teu projeto.
  </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 Macaly 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, abre novamente a janela de publicação. Se mostrar **Falha na publicação**, clica em **Corrigir agora** para o agente reparar o erro, ou publica novamente. Se isso não ajudar, [contacta o suporte](mailto:support@macaly.com) com o link do teu projeto.
  </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. Esta funcionalidade requer, no mínimo, o nível mais básico do plano Pro e não está disponível no plano Grátis.
  </Accordion>

  <Accordion title="O que é o distintivo &#x22;Made with AI in Macaly&#x22; no meu site publicado?">
    É o aviso visível de que o teu site foi criado com IA. Não pode ser desativado no plano Grátis; os planos Starter, Pro, Agências e os planos Hosting existentes podem ocultá-lo em **Definições → Geral**. Os sites publicados também têm uma etiqueta `ai-generated` legível por máquinas. Consulta [Usar a IA de forma responsável](/docs/pt/security/using-ai-responsibly).
  </Accordion>

  <Accordion title="Tenho de dizer aos meus visitantes que o meu site foi feito com IA?">
    O Macaly divulga que a plataforma é potenciada por IA, e o distintivo no teu site publicado mostra como foi criado. 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 Macaly cobre isso?">
    Não. O aviso que vês no Macaly aplica-se ao Macaly. 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**. O Macaly mostra os registos DNS que precisas de adicionar. Vai ao teu registrador de domínios e adiciona o registo A e o registo CNAME como indicado. Depois de guardares os registos, volta ao Macaly e clica em **Atualizar**. Ligar um domínio personalizado requer um plano Starter, Pro ou Agências, ou um plano Hosting existente.
  </Accordion>

  <Accordion title="Que registos DNS preciso de adicionar para o meu domínio personalizado?">
    Normalmente precisas de dois registos:

    * Um **registo A** para o domínio raiz, apontando para o endereço IP do Macaly
    * Um **registo CNAME** para `www`, apontando para o hostname do Macaly

    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?">
    Adiciona um registo A para o domínio simples/raiz, apontando para o endereço IP do Macaly (`216.150.1.1`). Remove quaisquer registos A ou AAAA existentes que estejam em conflito para o domínio raiz. Se o domínio raiz mostrar **Certificado SSL em falta** em **Definições → Domínios**, apesar de os registos estarem corretos, clica em **Tentar novamente o certificado SSL**. Podes tentar uma vez por hora. [Contacta o suporte](mailto:support@macaly.com) se não tiveres a certeza de quais registos remover.
  </Accordion>

  <Accordion title="O meu domínio continua a mostrar Pendente ou Não ligado. O que devo fazer?">
    Confirma que os registos DNS no teu registrador correspondem exatamente ao que o Macaly mostra. Remove quaisquer registos em conflito. Clica em **Atualizar** no painel de Domínios do Macaly. A propagação DNS pode demorar até 24 horas.
  </Accordion>

  <Accordion title="Ainda posso comprar o plano Hosting para usar um domínio personalizado?">
    Não. O plano Hosting deixou de ser oferecido a novos clientes. Para usar um domínio personalizado, escolhe o plano Starter (8,80 €/mês) ou o Pro. Se já estás no Hosting, manténs o teu plano, o preço e as funcionalidades, e podes continuar a geri-lo ou cancelá-lo na **Faturação**.
  </Accordion>

  <Accordion title="Posso configurar email para o meu domínio personalizado?">
    O Macaly não fornece alojamento de email. Para email no teu domínio personalizado (por exemplo, [info@oteusite.com](mailto: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 Macaly pode configurar formulários de contacto para lhe enviar notificações.
  </Accordion>
</AccordionGroup>

## Email e notificações

<AccordionGroup>
  <Accordion title="O Macaly pode enviar emails a partir do meu projeto?">
    Sim. O Macaly tem uma API de email incorporada, com tecnologia Resend. Por predefinição, os emails de saída são enviados a partir de `noreply@email.macaly-app.com`. 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 Macaly 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](mailto:support@macaly.com) 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](mailto:support@macaly.com) 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 Macaly 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 Macaly 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 Macaly usa?">
    Sim. O Macaly 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. Consulta [Planos e créditos](/docs/pt/welcome/pricing) para saber como funcionam os créditos e o que cada plano inclui.
  </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](mailto:support@macaly.com) com o link do teu chat. Podes verificar incidentes em curso em status.macaly.com.
  </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](mailto:support@macaly.com) 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 &#x22;Application error: a client-side exception has occurred&#x22;. O que se passa?">
    Se o vires no editor do Macaly, recarrega a página. Se continuar a acontecer, [contacta o suporte](mailto:support@macaly.com) com o link do teu chat. Se o erro aparecer no teu site publicado, reporta-o ao agente com uma descrição clara ou [contacta o suporte](mailto:support@macaly.com).
  </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](mailto:support@macaly.com).
  </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 Macaly.
  </Accordion>

  <Accordion title="Crio sites para clientes. Eles podem assumir o site na sua própria conta Macaly?">
    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 Macaly, 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 Macaly 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 Macaly?">
    O Macaly usa o Convex. 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="A base de dados tem custo adicional?">
    A base de dados está incluída em todos os planos e, enquanto te mantiveres dentro do teu limite mensal de utilização, não consome créditos. Nos planos Starter, Pro e Agências, o uso acima do limite é cobrado em créditos. No Starter, no Pro e nas Agências, cada 1 GiB adicional iniciado custa 200K créditos. No Starter, no Pro e nas Agências, cada 100 000 chamadas à API de backend adicionais custam 200K créditos. O limite é contabilizado em todo o teu espaço de trabalho e é renovado no início de cada mês do calendário. Se fizeres upgrade do plano Grátis ou do Hosting a meio do mês, o limite pago começa no momento do upgrade e o uso anterior nunca é cobrado. Encontras os detalhes em [Planos e créditos](/docs/pt/welcome/pricing#uso-da-base-de-dados).
  </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 Macaly 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 Macaly trata o SEO?">
    O Macaly 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 Macaly 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 Macaly 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 Macaly noutro site usando um iframe?">
    Tecnicamente sim, usando o teu URL Macaly 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 Macaly 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, créditos, membros e faturação. Uma conta pode estar em vários espaços de trabalho, o que é útil para separar projetos pessoais do trabalho para clientes ou para colaborar com equipas diferentes.
  </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 membros, 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](mailto:support@macaly.com) 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 Macaly.
  </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](mailto:support@macaly.com). Eles podem verificar o estado da tua conta e ajudar com a autenticação.
  </Accordion>

  <Accordion title="Como termino a sessão noutros dispositivos?">
    Abre Definições → Segurança. Vais ver todos os dispositivos com sessão iniciada na tua conta, com a opção de terminar sessão remotamente. Isto é útil se usaste o Macaly num computador partilhado ou perdeste um dispositivo.
  </Accordion>

  <Accordion title="Como elimino permanentemente a minha conta?">
    [Contacta o suporte](mailto:support@macaly.com) 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>

## Espaços de trabalho

<AccordionGroup>
  <Accordion title="Os espaços de trabalho partilham créditos?">
    Não. Cada espaço de trabalho tem o seu próprio plano e os seus próprios créditos. Se estiveres em vários espaços de trabalho, cada um controla os créditos e a faturação de forma independente. Mudar para outro espaço de trabalho muda para o respetivo saldo de créditos.
  </Accordion>

  <Accordion title="Recebo créditos grátis em todos os espaços de trabalho que crio?">
    Não. O milhão de créditos grátis mensais aplica-se apenas ao teu espaço de trabalho predefinido, o que foi criado quando te registaste pela primeira vez. Quaisquer espaços de trabalho adicionais que crias começam no plano Grátis, mas sem créditos, por isso terás de os atualizar para um plano pago para usar o agente.
  </Accordion>

  <Accordion title="O que acontece aos meus projetos se eu eliminar um espaço de trabalho?">
    Tudo nesse espaço de trabalho é eliminado permanentemente: projetos, chats, bases de dados e quaisquer domínios personalizados ligados. Isto não pode ser desfeito, por isso faz uma cópia de segurança ou duplica tudo o que queiras manter antes de eliminar.
  </Accordion>

  <Accordion title="Um espaço de trabalho pode ter mais do que um proprietário?">
    Não. Cada espaço de trabalho tem exatamente um proprietário, que gere a faturação, a administração e os membros. Todos os outros são membros com acesso total aos chats e créditos, mas sem direitos de administração.
  </Accordion>

  <Accordion title="Posso transferir a propriedade de um espaço de trabalho para outra pessoa?">
    Atualmente não é possível transferir a propriedade de um espaço de trabalho através da interface. Se precisares de alterar o proprietário de um espaço de trabalho, [contacta o suporte](mailto:support@macaly.com) e eles podem ajudar.
  </Accordion>

  <Accordion title="Quantos espaços de trabalho posso ter?">
    Não há um limite fixo. Muitos utilizadores criam espaços de trabalho separados para projetos pessoais, clientes ou equipas diferentes.
  </Accordion>

  <Accordion title="Posso mover um chat de um espaço de trabalho para outro?">
    Não existe uma opção incorporada para mover um chat entre espaços de trabalho. [Contacta o suporte](mailto:support@macaly.com) com o link do chat e o espaço de trabalho para onde o queres mover, e a equipa pode ajudar.
  </Accordion>

  <Accordion title="O que acontece se eu cancelar o plano pago de um dos meus espaços de trabalho?">
    O espaço de trabalho continua a existir, mas volta aos limites do plano Grátis no fim do período de faturação. A tua app publicada continua acessível no subdomínio Macaly predefinido, mas os domínios personalizados e as funcionalidades Pro deixam de funcionar, a menos que mudes para o plano Starter, que mantém uma app no teu próprio domínio personalizado. O plano Grátis inclui 1 app publicada. Se o espaço de trabalho tiver mais apps online, os proprietários e administradores recebem um e-mail e tempo para escolher qual fica online. As restantes apps são depois despublicadas, mas os teus projetos e dados mantêm-se.
  </Accordion>
</AccordionGroup>

## Suporte

<AccordionGroup>
  <Accordion title="Com que rapidez o suporte do Macaly responde?">
    A equipa tem como objetivo responder no prazo de um dia útil. O suporte está sediado na Europa (fuso horário CET) e está fechado aos fins de semana. Em períodos de festas, as respostas podem demorar um pouco mais.
  </Accordion>

  <Accordion title="Como reporto um bug que desperdiçou os meus créditos?">
    [Contacta o suporte](mailto:support@macaly.com). Inclui o link para o chat afetado, uma descrição do que aconteceu e aproximadamente quando. Antes de contactares o suporte, usa o botão **Reportar problema** na resposta do agente que causou o problema. Isso anexa contexto útil para a equipa de engenharia.
  </Accordion>

  <Accordion title="Existe uma página de estado onde posso verificar interrupções?">
    Sim. [status.macaly.com](https://status.macaly.com) mostra informações sobre incidentes ativos e interrupções recentes.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.