---
title: Perguntas frequentes
description: "Perguntas comuns sobre preços, builds, domínios personalizados, colaboração em equipe, chat com IA, integração com GitHub e recursos de sites de documentação."
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Perguntas comuns sobre preços, builds, domínios e recursos.

As capturas de tela mostram a interface em inglês.

## Primeiros passos

<AccordionGroup>
  <Accordion title="O que é o Jamdesk?">
    O Jamdesk é uma plataforma de documentação que cria sites de documentação a partir dos seus arquivos Markdown. Escreva em MDX, envie para o GitHub e seu site será implantado automaticamente com pesquisa, análises e `llms.txt` pronto para IA.
  </Accordion>

  <Accordion title="Preciso saber programar?">
    Não é necessário saber programar. Escrever em MDX é como usar um editor de texto: você escreve texto simples com formatação básica. Os componentes estão disponíveis se você quiser usá-los, mas são totalmente opcionais.
  </Accordion>

  <Accordion title="Posso testar o Jamdesk gratuitamente?">
    Sim! Oferecemos um teste gratuito de 14 dias com acesso completo a todos os recursos.  
  </Accordion>

  <Accordion title="Qual é a diferença entre o Jamdesk e outras plataformas de documentação?">
    O Jamdesk é baseado em MDX e GitHub: sua documentação consiste em arquivos de texto simples em um repositório, sem ficar presa a um editor proprietário. Envie para o GitHub e seu site será implantado em menos de 60 segundos, sem configuração de build ou pipeline de CI/CD. Todo site recebe automaticamente um `llms.txt` e um servidor MCP, para que ferramentas de IA como Claude e ChatGPT possam acessar diretamente sua documentação atual. Os visitantes também contam com um [assistente de chat com IA](/pt/ai/chat) integrado que responde a perguntas com base na sua documentação.
  </Accordion>
</AccordionGroup>

## Builds e implantação

<AccordionGroup>
  <Accordion title="Quanto tempo os builds levam?">
    A maioria dos sites de documentação é criada em 30 a 60 segundos. Sites maiores, com muitas páginas, podem levar mais tempo.
  </Accordion>

  <Accordion title="Posso visualizar as alterações antes de publicar?">
    Sim! Use o CLI do Jamdesk (`jamdesk dev`) para visualizar localmente com atualização automática. As alterações só entram no ar quando você envia para o GitHub ou executa `jamdesk deploy`.
  </Accordion>

  <Accordion title="Posso fazer deploy sem o GitHub?">
    Sim. Execute `jamdesk deploy` no diretório do projeto. O CLI empacota seus arquivos, faz o upload e inicia um build diretamente. Não é necessário um repositório Git. Consulte o [guia de deploy pelo CLI](/pt/cli/deploy) para obter detalhes.
  </Accordion>

  <Accordion title="O que inicia um build?">
    Os builds são iniciados automaticamente quando você envia alterações para sua ramificação conectada do GitHub. Você também pode iniciar builds manualmente pelo dashboard ou com `jamdesk deploy` pelo CLI.
  </Accordion>

  <Accordion title="Posso reverter para uma versão anterior?">
    Sim. Acesse **Deployments** no seu projeto, encontre o build anterior e clique em **Rollback**.
  </Accordion>
</AccordionGroup>

## Cobrança e preços

<AccordionGroup>
  <Accordion title="Quanto custa o Jamdesk?">
    O plano Pro custa US$ 29/mês por projeto. Projetos adicionais custam US$ 15/mês cada. Consulte [Planos e preços](/pt/help/billing/plans) para obter detalhes.
  </Accordion>

  <Accordion title="Existe um plano gratuito?">
    Oferecemos um teste gratuito de 14 dias. Depois disso, você precisará de uma assinatura Pro para continuar.
  </Accordion>

  <Accordion title="Quais métodos de pagamento vocês aceitam?">
    Aceitamos cartões de crédito Visa, Mastercard, American Express e Discover.
  </Accordion>

  <Accordion title="Posso receber um reembolso?">
    Oferecemos reembolsos dentro de 30 dias após seu primeiro pagamento. Entre em contato com o suporte para obter ajuda.
  </Accordion>
</AccordionGroup>

## Domínios personalizados

<AccordionGroup>
  <Accordion title="Posso usar meu próprio domínio?">
    Sim! Adicione um domínio personalizado em **Settings** → **Domains**. Os certificados SSL são provisionados automaticamente.
  </Accordion>

  <Accordion title="Quanto tempo leva a propagação do DNS?">
    As alterações de DNS normalmente são propagadas em poucas horas, mas podem levar até 48 horas.
  </Accordion>

  <Accordion title="Posso hospedar a documentação em um subcaminho como /docs?">
    Sim. Use um proxy reverso (Cloudflare, AWS, nginx) para disponibilizar o Jamdesk em um subcaminho. Consulte [Hospedagem em subcaminho](/pt/deploy/subpath-hosting).
  </Accordion>
</AccordionGroup>

## Equipes e colaboração

<AccordionGroup>
  <Accordion title="Como convido um membro da equipe?">
    Abra seu projeto, acesse **Settings** → **Members**, digite o e-mail da pessoa no campo **Invite Member** e clique em **Invite**. Ela receberá um e-mail com um link para entrar no projeto.

    <Frame>
      <img src="/images/dashboard/settings-team.webp" alt="Aba Members nas configurações do projeto, mostrando o campo Invite Member e a lista atual de membros" style={{ display: 'block', margin: '0 auto' }} />
    </Frame>

    Os usuários convidados precisam ter uma conta do Jamdesk; caso não tenham, serão solicitados a criar uma ao aceitar o convite. Já é membro, mas o link de convite informa que ele foi "already been accepted"? Você não precisa de um novo convite. Basta entrar e você voltará ao projeto. Consulte [Membros da equipe](/pt/help/projects/team-members) para saber mais sobre funções e limites de membros.
  </Accordion>

  <Accordion title="Quantos membros de equipe posso ter?">
    Todos os planos incluem membros de equipe ilimitados por projeto, sem custo adicional.
  </Accordion>

  <Accordion title="Os membros da equipe podem editar a documentação?">
    Os membros da equipe podem visualizar builds e iniciar novos builds, mas a edição é feita no seu repositório do GitHub. Qualquer pessoa com acesso ao repositório pode editar a documentação.
  </Accordion>

  <Accordion title="Como transfiro a propriedade do projeto?">
    Acesse **Settings** → **Members** e clique em **Transfer Ownership** ao lado do membro que deseja promover. O novo proprietário precisa ser um membro existente da equipe.
  </Accordion>
</AccordionGroup>

## CLI

<AccordionGroup>
  <Accordion title="Onde ficam armazenadas minhas credenciais do CLI?">
    Em `~/.jamdeskrc`, um arquivo JSON com permissões `0600` (somente seu usuário pode lê-lo). Ele armazena seu token de atualização, e-mail e ID de usuário. Execute `jamdesk logout` para apagá-lo.
  </Accordion>

  <Accordion title='Por que o CLI informa "session expired"?'>
    Seu token de atualização não é mais válido. Isso acontece após alterações de senha, exclusões de conta ou longos períodos de inatividade. Execute `jamdesk login` para obter uma nova sessão.
  </Accordion>

  <Accordion title="Posso usar o CLI em pipelines de CI/CD?">
    Sim, mas o login baseado em navegador não funciona em ambientes sem interface. Entre na sua máquina local e copie `~/.jamdeskrc` para o executor de CI. O token de atualização cuida da autenticação a partir desse ponto.
  </Accordion>

  <Accordion title="Como corrijo links quebrados automaticamente?">
    Execute `jamdesk fix`. O comando corrige links internos quebrados que têm um destino correto não ambíguo (âncoras com erros de digitação e divergências de âncoras entre localidades), editando seus arquivos `.mdx` locais após uma prévia. Use `jamdesk fix --dry-run` para ver primeiro as alterações planejadas; somente links cuja âncora corrigida corresponde a um título real são alterados, deixando os casos ambíguos para revisão manual. Consulte [Correção automática de links quebrados](/pt/cli/fix-broken-links).
  </Accordion>
</AccordionGroup>

## Conteúdo e recursos

<AccordionGroup>
  <Accordion title="Quais formatos de arquivo são compatíveis?">
    O Jamdesk é compatível com arquivos MDX (Markdown + JSX) e arquivos Markdown padrão.
  </Accordion>

  <Accordion title="Posso usar componentes React personalizados?">
    Sim. Defina componentes diretamente no MDX com `export const` ou crie componentes reutilizáveis no diretório `/snippets`. Para componentes interativos com hooks, use arquivos `.tsx` com `'use client'`. Consulte [Componentes React personalizados](/pt/content/react-components) e [Snippets](/pt/content/snippets).
  </Accordion>

  <Accordion title="Existe um limite de páginas?">
    Não há um limite fixo de páginas. A maioria dos sites de documentação funciona bem com centenas de páginas.
  </Accordion>

  <Accordion title="O Jamdesk é compatível com vários idiomas?">
    Sim. Use a propriedade `languages` na configuração de navegação para criar um seletor de idioma. Cada idioma recebe sua própria estrutura de navegação e conteúdo. Consulte [Suporte a vários idiomas](/pt/setup/languages).
  </Accordion>

  <Accordion title="O Jamdesk traduz meu conteúdo automaticamente?">
    Não. O Jamdesk não traduz o conteúdo por você. Você fornece os arquivos MDX traduzidos, e o Jamdesk cuida do roteamento, da navegação, do seletor de idioma e do estilo RTL. Traga as traduções do seu próprio fluxo de trabalho (tradutores humanos, tradução automática ou um LLM) e coloque-as em diretórios com o prefixo do idioma (`es/`, `fr/` etc.). Consulte [Suporte a vários idiomas](/pt/setup/languages) para saber mais sobre a estrutura de diretórios e a configuração.
  </Accordion>
</AccordionGroup>

## Chat com IA

<AccordionGroup>
  <Accordion title="Meu site de documentação tem chat com IA?">
    Sim. Todo site do Jamdesk inclui um assistente de chat integrado que responde às perguntas dos visitantes com base na sua documentação. Ele é ativado por padrão e não requer configuração. Consulte [Chat com IA](/pt/ai/chat) para obter detalhes.
  </Accordion>

  <Accordion title="O chat com IA tem custo adicional?">
    Não. O chat com IA está incluído em todos os planos sem custo adicional.
  </Accordion>

  <Accordion title="Posso desativar o chat com IA?">
    Sim. Defina `chat.enabled` como `false` no seu `docs.json`:

    ```json
    { "chat": { "enabled": false } }
    ```

    O painel de chat e o atalho de teclado serão removidos após o próximo build.
  </Accordion>

  <Accordion title="Quais dados o chat usa para responder às perguntas?">
    O chat usa somente as páginas de documentação publicadas. Durante cada build, o Jamdesk indexa seu conteúdo em um banco de dados vetorial. Quando um visitante faz uma pergunta, as seções relevantes são recuperadas e enviadas ao Claude como contexto. A IA não pode acessar dados fora da sua documentação.
  </Accordion>
</AccordionGroup>

## Privacidade e acesso

<AccordionGroup>
  <Accordion title="Posso ter documentação pública e privada no mesmo site?">
    Sim. Marque as páginas internas com `private: true` no frontmatter ou liste os caminhos em `auth.password.private[]` no `docs.json`. As páginas públicas continuam públicas; as privadas exibem uma tela de desbloqueio. Tudo permanece em um único projeto, portanto as páginas públicas e privadas compartilham o mesmo repositório e build. Consulte [Controle de acesso](/pt/setup/access-control) e [Proteção por senha](/pt/setup/password-protection).
  </Accordion>

  <Accordion title="Como protejo todo o meu site de documentação com uma senha?">
    Defina `auth.password.enabled: true` no `docs.json`, envie a alteração e defina uma senha em **Project Settings → Password Protection** no dashboard. Todos os visitantes verão uma tela de desbloqueio até inserirem a senha. Consulte [Proteção por senha](/pt/setup/password-protection).
  </Accordion>

  <Accordion title="Os leitores podem entrar com a própria conta em vez de usar uma senha compartilhada?">
    Sim, nos planos Enterprise. O Single Sign-On permite que os leitores se autentiquem pelo seu provedor de identidade (Okta, Google Workspace, Azure AD etc.), sem senhas compartilhadas, com um registro completo de auditoria e desprovisionamento instantâneo. Consulte [SSO](/pt/setup/sso) ou [entre em contato com a equipe de vendas Enterprise](https://jamdesk.com/pricing).
  </Accordion>

  <Accordion title="Devo separar a documentação interna e externa em dois projetos?">
    Normalmente, não. Um único projeto com `private: true` nas páginas internas é mais simples, pois você mantém tudo em um repositório e gerencia o conteúdo em um único dashboard. Use dois projetos somente quando os públicos precisarem de branding, domínios personalizados ou análises totalmente separados. Consulte [Controle de acesso](/pt/setup/access-control) para conhecer os padrões.
  </Accordion>

  <Accordion title="Qual é a diferença entre um editor e um leitor?">
    **Editors** escrevem a documentação fazendo commit de MDX no seu repositório conectado do GitHub, portanto qualquer pessoa com acesso de push à sua ramificação de documentação pode publicar uma alteração. **Readers** visualizam o site publicado: todos (público), qualquer pessoa com a senha (modo de senha) ou qualquer pessoa conectada pelo seu IdP (SSO). **Dashboard team members** são um conceito separado: eles gerenciam builds e análises, mas não criam conteúdo diretamente. Consulte [Controle de acesso](/pt/setup/access-control).
  </Accordion>
</AccordionGroup>

## Artigos relacionados

<Columns cols={2}>
  <Card title="Contatar o suporte" icon="headset" href="/pt/help/support/contact">
    Obtenha ajuda da equipe do Jamdesk
  </Card>
  <Card title="Falhas de build" icon="triangle-exclamation" href="/pt/help/troubleshooting/build-failures">
    Diagnostique erros comuns
  </Card>
</Columns>