> ## 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 tipos de projeto posso criar com o Macaly?">
    O Macaly 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.
  </Accordion>

  <Accordion title="Para que tipos de projeto o Macaly não é indicado?">
    O Macaly 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 Convex como banco de dados.
  </Accordion>

  <Accordion title="Posso criar meu projeto em outro idioma que não seja o inglês?">
    Sim, o Macaly 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.
  </Accordion>

  <Accordion title="O Macaly oferece autenticação e login de usuários?">
    Sim. O Macaly 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.
  </Accordion>

  <Accordion title="Posso editar textos e fazer pequenos ajustes de design sem usar créditos?">
    Sim. As [Edições visuais](/docs/pt-BR/features/visual-edits) 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 são **Reescrever com IA** e **Gerar com IA**, que usam créditos e mostram o preço antes de você executá-los.
  </Accordion>

  <Accordion title="Posso usar o Macaly no celular ou preciso baixar um app?">
    O Macaly 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.
  </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?">
    Em 8 de outubro de 2026, o Macaly lançou o plano **Starter** (\$10/mês) e definiu limites claros para o plano Gratuito: apps publicados, armazenamento de arquivos, uma franquia de tráfego do site e 100 Cloud actions por mês. O plano **Hospedagem** deixou de ser oferecido a novos clientes. O plano Pro continua igual. Veja [Planos e créditos](/docs/pt-BR/welcome/pricing) para saber o que cada plano inclui.
  </Accordion>

  <Accordion title="O que é o plano Starter e para quem ele serve?">
    O Starter custa \$10/mês (€8,80 ou 210 Kč, dependendo da moeda de cobrança) e tem cobrança somente mensal. Ele serve para publicar um app no seu próprio domínio personalizado, sem o selo do Macaly. Ele inclui:

    * 1M de créditos por mês
    * 1 app publicado no seu próprio domínio personalizado (a compra do domínio é cobrada à parte)
    * 5 GiB de armazenamento de arquivos
    * 5 GiB de uso do banco de dados
    * Uma franquia de 5 GB de tráfego do site
    * Sem limite mensal de Cloud actions
    * Suporte por e-mail e 3 meses de retenção de analytics

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

  <Accordion title="Estou no plano Hospedagem. O que acontece comigo?">
    Nada muda. Você continua com o plano Hospedagem, o mesmo preço e os mesmos recursos. Você ainda pode gerenciá-lo ou cancelá-lo em **Cobrança**.
  </Accordion>

  <Accordion title="Ainda posso contratar o plano Hospedagem?">
    Não. O plano Hospedagem deixou de ser oferecido a novos clientes. Para manter um site no ar no seu próprio domínio, escolha o Starter.
  </Accordion>

  <Accordion title="Estou no plano Gratuito com vários apps publicados. O que acontece com eles?">
    O plano Gratuito inclui 1 app publicado. Se você tiver mais, enviamos primeiro um e-mail aos proprietários e administradores do workspace e damos tempo para você escolher qual continua no ar (o e-mail informa a data exata). Você também pode mudar para um plano que inclua mais apps publicados. Depois do prazo, os demais apps são despublicados. Seus projetos e dados permanecem, e você pode publicá-los de novo depois de fazer upgrade ou quando estiver dentro do limite do seu plano. Os apps despublicados também são removidos da galeria da comunidade.

    Até lá, publicar um novo app exige uma vaga livre. Para liberar uma vaga, cancele a publicação de um app. A vaga volta a ficar disponível em alguns minutos. Rascunhos e prévias não contam para o limite. Veja [Apps publicados acima do limite](/docs/pt-BR/account/workspaces/usage#apps-publicados-acima-do-limite).
  </Accordion>

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

    * Criar ou duplicar um app
    * Escrever, editar ou excluir arquivos
    * Executar comandos
    * Enviar arquivos
    * Publicar
    * Conectar um domínio

    Ler arquivos, listar e gerar prévias não custa nada. Conversar com o Macaly dentro do app não usa Cloud actions.
  </Accordion>

  <Accordion title="Quem tem limite de Cloud actions e quando ele é renovado?">
    O plano Gratuito inclui 100 Cloud actions por mês. Os planos pagos não têm limite mensal de Cloud actions. A franquia do plano Gratuito é compartilhada por todo o workspace e é zerada no dia 1º de cada mês (UTC). As Cloud actions não usadas não acumulam.
  </Accordion>

  <Accordion title="O que acontece quando eu uso todas as minhas Cloud actions?">
    As demais ações contabilizadas são recusadas. A mensagem mostra a data em que a franquia é renovada e um link para **Cobrança**. Ler arquivos, os apps que já estão no ar e as conversas com o Macaly dentro do app continuam funcionando.
  </Accordion>

  <Accordion title="Posso passar do Pro para o Starter? E se eu estiver acima dos limites do Starter?">
    Sim. Os downgrades têm efeito no fim do período de cobrança atual. Em **Cobrança**, agende a mudança para o Starter ou escolha o Starter ao cancelar o Pro. O Pro e os créditos dele continuam até a data de renovação.

    Na renovação, o Macaly verifica o workspace. Se ele tiver mais de 1 app publicado ou mais de 5 GiB de arquivos, a mudança é cancelada e o Pro é renovado. Essa verificação nunca despublica nem exclui nada. Você pode desfazer uma mudança agendada com **Manter o Pro**.
  </Accordion>

  <Accordion title="Como passo do plano Gratuito para o Starter ou o Pro?">
    Abra **Cobrança** e escolha o plano. Os upgrades têm efeito imediato: você paga o preço integral do novo plano, recebe todos os créditos dele e seu período de cobrança é reiniciado.
  </Accordion>

  <Accordion title="O que acontece quando o armazenamento de arquivos fica cheio?">
    Novos envios, e a cópia de um banco de dados, são recusados até você liberar espaço. Os arquivos existentes continuam legíveis e os apps publicados continuam online.
  </Accordion>

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

  <Accordion title="Onde vejo meu uso?">
    **Cobrança** e **Configurações → Uso e limites** (veja [Uso e limites](/docs/pt-BR/account/workspaces/usage)) mostram suas Cloud actions (plano Gratuito), apps publicados, armazenamento de arquivos e a franquia de tráfego.
  </Accordion>

  <Accordion title="O que é a barra no topo do Macaly?">
    Nos planos Gratuito e Starter, uma barra no topo da tela inicial e dos chats avisa quando seu workspace está perto de um limite do plano ou já o ultrapassou. Ela fica âmbar aos 80% e vermelha quando um limite é atingido ou excedido (os apps publicados só ficam vermelhos quando você tem mais apps no ar do que seu plano inclui). Ela só informa: não pode ser dispensada e, por si só, não despublica nada. Veja [Avisos de limites do plano](/docs/pt-BR/account/workspaces/usage#avisos-de-limites-do-plano).
  </Accordion>

  <Accordion title="Os créditos mudaram?">
    Os novos workspaces Gratuitos recebem 1 milhão de créditos por mês. Fora isso, os créditos e as recargas funcionam como antes.
  </Accordion>

  <Accordion title="Como funcionam os blocos de excedente do banco de dados no Starter, no Pro e no Agência?">
    O Starter inclui 5 GiB de uso do banco de dados por mês e o Pro inclui 10 GiB. No Starter, no Pro e no Agência, cada 1 GiB adicional iniciado e usado em um mês do calendário custa 200K de créditos. Se você fizer upgrade do plano Gratuito ou Hospedagem no meio do mês, a franquia do plano pago começa no upgrade e o uso anterior a ele nunca é cobrado. Veja a tabela completa em [Planos e créditos](/docs/pt-BR/welcome/pricing).
  </Accordion>
</AccordionGroup>

## Planos e créditos

<AccordionGroup>
  <Accordion title="Como funciona o sistema de créditos?">
    Os créditos são consumidos toda vez que você envia um prompt ao agente do Macaly. A quantidade depende da complexidade da tarefa. Usuários do plano Gratuito recebem 1 milhão de créditos por mês. Os créditos dos planos pagos são válidos por 30 dias. Usuários de um plano pago (Starter ou Pro) também podem comprar recargas avulsas 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 cobrança começa com um novo conjunto de créditos, e os créditos não usados expiram no fim do período. Você pode comprar recargas avulsas de créditos, válidas por 60 dias a partir da data da compra.
  </Accordion>

  <Accordion title="Posso comprar créditos extras sem fazer upgrade do meu plano?">
    Sim. Se você está em um plano pago (Starter ou Pro), pode comprar uma recarga avulsa de créditos em macaly.com/billing. Os créditos de recarga são válidos por 60 dias, mais do que o período de cobrança padrão de 30 dias. Se você está no plano Gratuito e precisa de mais créditos, precisa fazer upgrade para um plano pago primeiro.
  </Accordion>

  <Accordion title="Posso fazer upgrade ou downgrade do meu plano a qualquer momento?">
    Sim. Os upgrades têm efeito imediato: você é cobrado pelo valor integral, recebe todos os créditos e seu ciclo de cobrança é reiniciado. Pode haver um pequeno atraso de processamento até o saldo de créditos ser atualizado, e uma atualização da página costuma resolver. Os créditos não usados do nível anterior continuam disponíveis até o fim do período atual. Os downgrades, incluindo a mudança do Pro para o Starter ou para o plano Gratuito, têm efeito no fim do seu período de cobrança atual.
  </Accordion>

  <Accordion title="O que acontece se meus créditos acabarem?">
    Se você está no Starter, pode comprar uma recarga avulsa de créditos ou fazer upgrade para o Pro. Se está no Pro, pode comprar uma recarga avulsa de créditos ou fazer upgrade para um plano maior. Se está no plano Gratuito, precisa fazer upgrade para continuar usando o agente. Todos os seus projetos continuam ativos e seu trabalho não é afetado.
  </Accordion>

  <Accordion title="Por que estou com 0 créditos se não usei nenhum?">
    Usuários do plano Gratuito recebem 1 milhão de créditos por ciclo de cobrança mensal. Se o seu saldo mostra 0 e você não usou nenhum crédito, [entre em contato com o suporte](mailto:support@macaly.com). A equipe pode investigar a sua conta. Os créditos dos planos pagos são adicionados no início de cada ciclo de cobrança de 30 dias.
  </Accordion>

  <Accordion title="O Macaly teve um problema e consumiu meus créditos. Posso receber um reembolso?">
    Depende da situação. Se ocorreu um problema confirmado na plataforma (como o agente travar, uma queda do sandbox ou uma interrupção do serviço), [entre em contato com o suporte](mailto:support@macaly.com) com o link do chat afetado e a equipe analisará o caso e devolverá os créditos conforme apropriado.

    Se o agente estava respondendo normalmente, mas precisou de várias tentativas para corrigir algo, isso é um comportamento esperado de agentes de IA. Para obter os melhores resultados e evitar gasto desnecessário de créditos, dê ao agente o máximo de contexto possível, incluindo capturas de tela e descrições claras, em vez de enviar comandos de correção repetidos. Se o agente não conseguir resolver um problema mesmo com todo o contexto fornecido, [entre em contato com o suporte](mailto:support@macaly.com) e a equipe investigará caso a caso.
  </Accordion>

  <Accordion title="Como aplico um código promocional ou de desconto?">
    Se você está fazendo a primeira compra, pode inserir um código promocional durante o checkout, na página de cobrança. Se você já tem um plano pago ativo, não é possível inserir códigos promocionais diretamente. [Entre em contato com o suporte](mailto:support@macaly.com) com o seu código e a equipe aplicará o desconto à sua conta manualmente.
  </Accordion>

  <Accordion title="O que acontece se eu estiver em um plano antigo Pro, Plus ou Ultra?">
    Com a atualização de preços, todos os planos antigos Pro, Plus e Ultra passaram a incluir os mesmos recursos do plano Pro atual. Suas mensagens restantes foram convertidas na proporção de 1 mensagem = 100.000 créditos. Você pode continuar usando seu plano atual até o fim dele, mas daqui em diante só poderá mudar para um dos novos planos.
  </Accordion>
</AccordionGroup>

## Cobrança e assinaturas

<AccordionGroup>
  <Accordion title="Como cancelo minha assinatura?">
    Acesse macaly.com/billing, clique em **Gerenciar** no seu plano atual e selecione **Cancelar assinatura**. Depois do cancelamento, seu acesso continua até o fim do período de cobrança atual. O plano Gratuito inclui 1 app publicado. Se você tiver mais, enviamos primeiro um e-mail e damos tempo para você escolher qual continua. Os demais são despublicados; seus projetos e dados permanecem e você pode publicá-los de novo depois de fazer upgrade ou quando estiver dentro do limite do seu plano.
  </Accordion>

  <Accordion title="Em quais moedas posso ser cobrado?">
    O Macaly oferece cobrança em USD, EUR e CZK. Use o seletor de moeda no canto superior direito da página de Cobrança para escolher. A sua escolha define a moeda em que você é realmente cobrado, e não apenas como os preços são exibidos.
  </Accordion>

  <Accordion title="Posso mudar a moeda de cobrança depois de assinar?">
    Você pode mudar a moeda de cobrança livremente antes de iniciar uma assinatura. Se você já tem uma assinatura ativa, [entre em contato com o suporte](mailto:support@macaly.com) e a equipe fará a alteração para você.
  </Accordion>

  <Accordion title="Onde encontro minhas faturas e recibos?">
    Acesse macaly.com/billing e clique na aba **Faturas**. Todas as faturas anteriores estão listadas ali e podem ser baixadas individualmente.
  </Accordion>

  <Accordion title="Por que fui cobrado mais do que o esperado?">
    Ao fazer upgrade do plano, você é cobrado imediatamente pelo valor integral do novo nível, não apenas pela diferença. Por exemplo, ao passar de \$25/mês para \$50/mês, são cobrados \$50 na hora. Se você acha que uma cobrança foi feita por engano, [entre em contato com o suporte](mailto:support@macaly.com). A equipe pode processar um reembolso se os créditos do nível novo ainda não tiverem sido usados.
  </Accordion>

  <Accordion title="Posso pedir reembolso de uma renovação de assinatura que esqueci de cancelar?">
    [Entre em contato com o suporte](mailto:support@macaly.com) o quanto antes. Os reembolsos de renovações acidentais são tratados caso a caso. Se você ainda não usou os créditos renovados, o reembolso costuma ser possível. A política de reembolso do Macaly está descrita na Seçã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 (\$10/mês, com cobrança mensal) inclui 1 app publicado no seu próprio domínio personalizado, sem o selo do Macaly, e 1M de créditos por mês. A compra do domínio é cobrada à parte. O Starter não inclui a integração com o GitHub.

    **Para passar do Pro para o Starter**, agende a mudança em **Cobrança** ou escolha o Starter ao cancelar o Pro. O Pro e os créditos dele continuam até a data de renovação. Na renovação, o Macaly verifica o workspace. Se ele tiver mais de 1 app publicado ou mais de 5 GiB de arquivos, a mudança é cancelada e o Pro é renovado. Essa verificação nunca despublica nem exclui nada. Você pode desfazer uma mudança agendada com **Manter o Pro**.
  </Accordion>

  <Accordion title="Ainda posso mudar para o plano Hospedagem?">
    Não. O plano Hospedagem deixou de ser oferecido a novos clientes. Se você já está no Hospedagem, continua com o mesmo plano, preço e recursos, e ainda pode gerenciá-lo ou cancelá-lo em **Cobrança**.
  </Accordion>

  <Accordion title="O que acontece com meu domínio personalizado se eu cancelar o plano Pro?">
    Se você cancelar o Pro e voltar ao plano Gratuito, seu domínio personalizado volta para a URL padrão do Macaly e o selo Feito com Macaly reaparece. Para manter os dois, mude para o plano Starter (\$10/mês): agende a mudança em Cobrança ou escolha o Starter ao cancelar o plano Pro.
  </Accordion>
</AccordionGroup>

## Publicação e deploy

<AccordionGroup>
  <Accordion title="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 Macaly (por exemplo, `myproject.macaly.app`). Para conectar um domínio personalizado, acesse **Configurações → Domínios**. Um domínio personalizado exige o plano Starter, Pro ou Agência, ou um plano Hospedagem já existente.
  </Accordion>

  <Accordion title="A publicação está travada em construção há muito tempo. O que devo fazer?">
    Abra a janela de publicação. Se aparecer **Não foi possível verificar o estado da publicação**, clique em **Tentar novamente**. O Macaly verifica de novo sem iniciar uma nova construção. Se continuar travado, [entre em contato com o suporte](mailto:support@macaly.com) com o link do seu projeto.
  </Accordion>

  <Accordion title="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 Macaly 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, abra a janela de publicação de novo. Se aparecer **Falha na publicação**, clique em **Corrigir agora** para o agente corrigir o erro, ou publique de novo. Se isso não resolver, [entre em contato com o suporte](mailto:support@macaly.com) com o link do seu projeto.
  </Accordion>

  <Accordion title="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. Esse recurso exige, no mínimo, o plano Pro de nível mais baixo e não está disponível no plano Gratuito.
  </Accordion>

  <Accordion title="O que é o selo &#x22;Feito com IA no Macaly&#x22; no meu site publicado?">
    É o aviso visível de que seu site foi criado com IA. Ele não pode ser desativado no plano Gratuito; os planos Starter, Pro, Agência e Hospedagem já existentes podem ocultá-lo em **Configurações → Geral**. Os sites publicados também trazem uma tag `ai-generated` legível por máquina. Veja [Uso responsável de IA](/docs/pt-BR/security/using-ai-responsibly).
  </Accordion>

  <Accordion title="Preciso avisar meus visitantes de que meu site foi feito com IA?">
    O Macaly informa que a plataforma usa IA, e o selo no seu site publicado mostra como ele foi criado. 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](/docs/pt-BR/security/using-ai-responsibly) explica os casos mais comuns.
  </Accordion>

  <Accordion title="Meu app tem um chatbot de IA próprio. O aviso de IA do Macaly cobre isso?">
    Não. O aviso que você vê no Macaly vale para o Macaly. 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.
  </Accordion>
</AccordionGroup>

## Domínios e hospedagem

<AccordionGroup>
  <Accordion title="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**. O Macaly mostra os registros DNS que você precisa adicionar. Acesse o registrador do seu domínio e adicione o registro A e o registro CNAME como indicado. Depois de salvar os registros, volte ao Macaly e clique em **Atualizar**. Conectar um domínio personalizado exige o plano Starter, Pro ou Agência, ou um plano Hospedagem já existente.
  </Accordion>

  <Accordion title="Quais registros DNS preciso adicionar para o meu domínio personalizado?">
    Normalmente você precisa de dois registros:

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

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

  <Accordion title="Meu site funciona com www, mas mostra um erro de SSL no domínio sem www. Como corrijo?">
    Adicione um registro A para o domínio raiz (apex) apontando para o endereço IP do Macaly (`216.150.1.1`). Remova quaisquer registros A ou AAAA conflitantes do domínio raiz. Se o domínio raiz mostrar **Certificado SSL ausente** em **Configurações → Domínios** mesmo com os registros corretos, clique em **Tentar emitir o certificado SSL novamente**. Você pode tentar uma vez por hora. [Entre em contato com o suporte](mailto:support@macaly.com) se não tiver certeza de quais registros remover.
  </Accordion>

  <Accordion title="Meu domínio ainda aparece como Pendente ou Não conectado. O que devo fazer?">
    Confira se os registros DNS no seu registrador são exatamente iguais aos que o Macaly mostra. Remova quaisquer registros conflitantes. Clique em **Atualizar** no painel de Domínios do Macaly. A propagação do DNS pode levar até 24 horas.
  </Accordion>

  <Accordion title="Ainda posso contratar o plano Hospedagem para usar um domínio personalizado?">
    Não. O plano Hospedagem deixou de ser oferecido a novos clientes. Para usar um domínio personalizado, escolha o plano Starter (\$10/mês) ou o Pro. Se você já está no Hospedagem, continua com o mesmo plano, preço e recursos, e ainda pode gerenciá-lo ou cancelá-lo em **Cobrança**.
  </Accordion>

  <Accordion title="Posso configurar e-mail para o meu domínio personalizado?">
    O Macaly não oferece hospedagem de e-mail. Para ter e-mail no seu domínio personalizado (por exemplo, [info@seusite.com](mailto: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 Macaly pode configurar formulários de contato para enviar notificações a ele.
  </Accordion>
</AccordionGroup>

## E-mail e notificações

<AccordionGroup>
  <Accordion title="O Macaly pode enviar e-mails a partir do meu projeto?">
    Sim. O Macaly tem uma API de e-mail integrada, baseada no Resend. Por padrão, os e-mails enviados saem de `noreply@email.macaly-app.com`. 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.
  </Accordion>

  <Accordion title="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 Macaly só envia e-mails, não os recebe. Ele não é indicado para newsletters nem para e-mails de marketing em massa.
  </Accordion>

  <Accordion title="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](mailto:support@macaly.com) 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.
  </Accordion>
</AccordionGroup>

## Trabalhando com o agente

<AccordionGroup>
  <Accordion title="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](mailto:support@macaly.com) com o link do chat e o horário aproximado. Os créditos consumidos durante uma sessão travada confirmada serão revisados.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Quantos passos o agente pode dar por pedido?">
    O Macaly 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.
  </Accordion>

  <Accordion title="Como faço um backup do meu projeto?">
    Macaly salva versões do projeto para que você possa restaurar o código anterior. Para suas próprias cópias, use [GitHub](/docs/pt-BR/integrations/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.
  </Accordion>

  <Accordion title="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](/docs/pt-BR/chat/overview#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.
  </Accordion>
</AccordionGroup>

## Modelos de IA

<AccordionGroup>
  <Accordion title="Posso escolher qual modelo de IA o Macaly usa?">
    Sim. O Macaly 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](/docs/pt-BR/agent/models) para a lista completa e para saber para que serve cada um.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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](/docs/pt-BR/agent/models) para as opções atuais.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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. Veja [Planos e créditos](/docs/pt-BR/welcome/pricing) para entender como os créditos funcionam e o que cada plano inclui.
  </Accordion>

  <Accordion title="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**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Problemas técnicos e erros

<AccordionGroup>
  <Accordion title="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](mailto:support@macaly.com) com o link do seu chat. Você pode verificar incidentes em andamento em status.macaly.com.
  </Accordion>

  <Accordion title="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](mailto:support@macaly.com) com o link do seu chat. A equipe pode reiniciar o sandbox e devolver os créditos consumidos durante a instabilidade.
  </Accordion>

  <Accordion title="Aparece &#x22;Application error: a client-side exception has occurred&#x22;. O que está errado?">
    Se aparecer no editor do Macaly, recarregue a página. Se continuar acontecendo, [entre em contato com o suporte](mailto:support@macaly.com) com o link do seu chat. Se o erro aparecer no seu site publicado, relate ao agente com uma descrição clara ou [entre em contato com o suporte](mailto:support@macaly.com).
  </Accordion>

  <Accordion title="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](mailto:support@macaly.com).
  </Accordion>
</AccordionGroup>

## Duplicando projetos

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="As cópias compartilham o mesmo banco de dados?">
    Não. Cada cópia recebe o próprio banco de dados, separado.
  </Accordion>

  <Accordion title="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 Macaly.
  </Accordion>

  <Accordion title="Crio sites para clientes. Eles podem assumir o site na própria conta do Macaly?">
    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 Macaly, de forma independente de você.
  </Accordion>
</AccordionGroup>

## Bancos de dados

<AccordionGroup>
  <Accordion title="Preciso configurar um banco de dados?">
    Não. Todo projeto do Macaly 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.
  </Accordion>

  <Accordion title="Qual banco de dados o Macaly usa?">
    O Macaly usa o Convex. 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](/docs/pt-BR/features/databases).
  </Accordion>

  <Accordion title="O banco de dados tem custo extra?">
    O banco de dados está incluído em todos os planos, e ficar dentro da franquia mensal de uso não consome créditos. Nos planos Starter, Pro e Agência, o uso acima da franquia é cobrado em créditos. No Starter, no Pro e no Agência, cada 1 GiB adicional iniciado custa 200K de créditos. No Starter, no Pro e no Agência, cada 100.000 chamadas de API de backend adicionais custam 200K de créditos. A franquia é contada no workspace inteiro e é zerada no início de cada mês do calendário. Se você fizer upgrade do plano Gratuito ou Hospedagem no meio do mês, a franquia do plano pago começa no upgrade e o uso anterior nunca é cobrado. Os detalhes estão em [Planos e créditos](/docs/pt-BR/welcome/pricing#uso-do-banco-de-dados).
  </Accordion>

  <Accordion title="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."
  </Accordion>

  <Accordion title="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 Macaly 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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## SEO

<AccordionGroup>
  <Accordion title="Como o Macaly lida com SEO?">
    O Macaly cria sites otimizados para mecanismos de busca. Renderização no servidor, HTML limpo e meta tags ficam por conta do Macaly. 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**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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 Macaly renderiza suas páginas no servidor automaticamente.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Posso incorporar um site do Macaly em outro site usando um iframe?">
    Tecnicamente sim, usando a URL publicada do seu site no Macaly 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 Macaly como um site independente, com domínio personalizado próprio.
  </Accordion>
</AccordionGroup>

## Contas

<AccordionGroup>
  <Accordion title="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, créditos, membros e cobrança próprios. Uma mesma conta pode participar de vários workspaces, o que ajuda a separar projetos pessoais de trabalhos para clientes ou a colaborar com equipes diferentes.
  </Accordion>

  <Accordion title="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 membros, domínios, chaves de API e conexões são diferentes em cada um.
  </Accordion>

  <Accordion title="Como altero meu endereço de e-mail?">
    [Entre em contato com o suporte](mailto:support@macaly.com) 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 Macaly.
  </Accordion>

  <Accordion title="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](mailto:support@macaly.com). A equipe pode verificar o status da sua conta e ajudar com a autenticação.
  </Accordion>

  <Accordion title="Como saio da minha conta em outros dispositivos?">
    Abra Configurações → Segurança. Você verá todos os dispositivos conectados à sua conta no momento, com a opção de encerrar a sessão remotamente. Isso é útil se você usou o Macaly em um computador compartilhado ou perdeu um dispositivo.
  </Accordion>

  <Accordion title="Como excluo minha conta permanentemente?">
    [Entre em contato com o suporte](mailto:support@macaly.com) 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.
  </Accordion>
</AccordionGroup>

## Workspaces

<AccordionGroup>
  <Accordion title="Os workspaces compartilham créditos?">
    Não. Cada workspace tem o próprio plano e os próprios créditos. Se você participa de vários workspaces, cada um controla créditos e cobrança de forma independente. Ao trocar de workspace, você passa a ver o saldo de créditos dele.
  </Accordion>

  <Accordion title="Recebo créditos gratuitos em todo workspace que crio?">
    Não. O milhão de créditos gratuitos mensais vale apenas para o seu workspace padrão, o que foi criado quando você se cadastrou. Os demais workspaces que você criar começam no plano Gratuito, mas sem créditos, então será preciso fazer upgrade para um plano pago para usar o agente.
  </Accordion>

  <Accordion title="O que acontece com meus projetos se eu excluir um workspace?">
    Tudo o que está nesse workspace é excluído permanentemente: projetos, chats, bancos de dados e quaisquer domínios personalizados conectados. Isso não pode ser desfeito, então faça backup ou duplique o que quiser manter antes de excluir.
  </Accordion>

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

  <Accordion title="Posso transferir a propriedade de um workspace para outra pessoa?">
    No momento, a propriedade de um workspace não pode ser transferida pela interface. Se você precisa mudar o Proprietário de um workspace, [entre em contato com o suporte](mailto:support@macaly.com) e a equipe pode ajudar.
  </Accordion>

  <Accordion title="Quantos workspaces posso ter?">
    Não há um limite fixo. Muitos usuários criam workspaces separados para projetos pessoais, clientes ou equipes diferentes.
  </Accordion>

  <Accordion title="Posso mover um chat de um workspace para outro?">
    Não existe uma opção integrada para mover um chat entre workspaces. [Entre em contato com o suporte](mailto:support@macaly.com) com o link do chat e o workspace para o qual você quer movê-lo, e a equipe pode ajudar.
  </Accordion>

  <Accordion title="O que acontece se eu cancelar o plano pago de um dos meus workspaces?">
    O workspace continua existindo, mas volta aos limites do plano Gratuito no fim do período de cobrança. Seu app publicado continua acessível no subdomínio padrão do Macaly, mas os domínios personalizados e os recursos do Pro deixam de funcionar, a menos que você mude para o plano Starter, que mantém um app no seu próprio domínio personalizado. O plano Gratuito inclui 1 app publicado. Se o workspace tiver mais apps no ar, os proprietários e administradores recebem um e-mail e tempo para escolher qual continua no ar. Os demais apps são despublicados depois, mas seus projetos e dados permanecem.
  </Accordion>
</AccordionGroup>

## Suporte

<AccordionGroup>
  <Accordion title="Em quanto tempo o suporte do Macaly responde?">
    A equipe procura responder em até um dia útil. O suporte fica na Europa (fuso CET) e não funciona nos fins de semana. Em períodos de feriado, as respostas podem demorar um pouco mais.
  </Accordion>

  <Accordion title="Como relato um bug que consumiu meus créditos à toa?">
    [Entre em contato com o suporte](mailto:support@macaly.com). Inclua o link do chat afetado, uma descrição do que aconteceu e, aproximadamente, quando. Antes de falar com o suporte, use o botão **Share feedback** na resposta do agente que apresentou o problema. Ele anexa um contexto útil para a equipe de engenharia.
  </Accordion>

  <Accordion title="Existe uma página de status para verificar instabilidades?">
    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.