Corrigir problemas no site de documentação
O que cada mensagem do site de documentação significa e como corrigi-la: publicações recusadas ou com falha, status de páginas, domínios personalizados, sites privados, o assistente, sites pausados ou offline, importações, o formulário de contato e endereços de site.
Esta página lista as mensagens que um site de documentação pode exibir para você ou para seus leitores, o que cada uma significa e o que fazer. Encontre a mensagem que você vê ou a área em que ela está: publicação, páginas, domínios, sites privados, o assistente, sites offline, importações, o formulário de contato ou criação de site.
Publicação
Uma publicação foi recusada
Estas mensagens aparecem quando você clica em Publicar, antes que qualquer coisa seja compilada. Seu site ao vivo não muda.
| Mensagem | Motivo | O que fazer |
|---|---|---|
| "Nothing to publish." | Tudo já está ao vivo. | Nada; suas alterações já foram publicadas. |
| "Add pages before publishing." | O site não tem páginas prontas e nada ao vivo ainda. | Adicione uma página e finalize-a para que fique pronta. |
| "Verify your email to publish." | No plano Gratuito, a pessoa que está publicando não confirmou seu endereço de e-mail. | Confirme seu endereço de e-mail com o link que a Clevera enviou por e-mail. |
| "A publish is already running for this doc site." | Outra publicação está em andamento. | Aguarde a conclusão. |
| "This doc site was published many times in the last hour. Try again in a few minutes." | Um site pode ser publicado até 60 vezes por hora. | Aguarde alguns minutos. Com a publicação automática ativada, as alterações são agrupadas para você. |
| "Your plan doesn't include private doc sites. Make the site public or upgrade to publish it." | O site é privado e o workspace mudou para um plano sem sites privados. | Defina o Acesso como Público ou faça upgrade para o Pro. |
| "Paused sites are read-only." | O site excedeu o limite de sites do seu plano. | Consulte Um site está pausado. |
| "This doc site is suspended. Contact support to restore it." | A Clevera colocou o site offline. | Entre em contato com o suporte. |
| "Publishing is temporarily unavailable. Your live site hasn't changed." | A publicação está pausada do nosso lado por um curto período. | Tente novamente mais tarde. |
| "Only admins and editors can publish." | Sua função pode editar páginas, mas não publicar. | Peça ao proprietário do workspace, a um administrador ou a um editor. |
Uma publicação falhou
Quando uma publicação falha, o site mantém a versão anterior: "Os leitores ainda veem a última versão." Você verá um banner, "Version n didn't publish", com See details. Em Publicação, a versão com falha diz "Couldn't publish this build." com o motivo e Tentar novamente. O proprietário, administradores e editores também recebem uma notificação "Publishing site failed", enviada por e-mail se não for lida após cerca de 10 minutos.
| Motivo | O que fazer |
|---|---|
| "We couldn't collect the site's content." | Tentar novamente. |
| "The site couldn't be built." | Tentar novamente. Entre em contato com o suporte se continuar falhando. |
| "The site's files couldn't be saved." | Tentar novamente em alguns minutos. |
| "Publishing took too long." | Tentar novamente. Entre em contato com o suporte se continuar acontecendo. |
| "This publish is held for review." | Esta versão é verificada antes de ir ao ar. Entre em contato com o suporte se ela permanecer retida. |
| "Publishing failed." | Tentar novamente. Entre em contato com o suporte se continuar falhando. |
Uma publicação com falha não é tentada novamente por conta própria. Clique em Tentar novamente ou publique novamente.
Avisos antes de publicar
Eles não impedem a publicação. Eles aparecem na folha de revisão para que você possa corrigi-los primeiro.
| Aviso | O que fazer |
|---|---|
| "name is an AI draft nobody has reviewed. It won't publish until it's marked ready." | Abra a página do site, revise-a e ative Pronto para publicar. |
| "name still has n placeholders to fill." | Preencha os espaços reservados entre colchetes. |
| "name is a legal page. Have it reviewed before you publish." | Peça a alguém para verificar o texto legal. |
| "n changes left out — they stay unpublished." | Você deixou alterações de fora desta publicação. Clique em Put back para incluí-las. |
Após uma publicação, os detalhes do build podem listar problemas de conteúdo em suas páginas:
| Problema | O que fazer |
|---|---|
| "the link to page doesn't lead to a page on this site." | Corrija ou remova o link. |
| "the link to page points to a heading that doesn't exist." | Atualize o link para um cabeçalho existente. |
| "an image has no alt text." | Adicione uma descrição à imagem. |
| "a heading is empty." | Escreva o cabeçalho ou remova-o. |
| "an image is larger than 5 MB; readers on slow connections wait for it." | Use uma imagem menor. |
| "title has no current export, so it plays through the Clevera player…" | Exporte o vídeo e publique novamente para que ele seja reproduzido pelo próprio site. |
| "This video has no share link yet, so the page can't show the player." | Abra o vídeo e crie seu link de compartilhamento. |
| "An image (…) isn't from this workspace and was left out." | Faça upload da imagem para este workspace. |
Consulte Publicar um site de documentação.
Status das páginas
Em Páginas, cada página mostra sua situação:
| Status | Significado | O que fazer |
|---|---|---|
| Não pronto | O artigo não foi finalizado no editor. | Finalize-o no editor para publicá-lo. |
| Alterado | Editado desde a última publicação. | Publicar. |
| Ainda não publicado | Adicionado desde a última publicação. | Publicar. |
| Oculto | Publicado, mas não na navegação. | Ative Mostrar na navegação se os leitores precisarem encontrá-lo no menu. |
| Agendado | Vai ao ar na data definida. | Nada. |
Domínios personalizados
Cada mensagem de domínio, com causas e correções passo a passo, está em Conectar um domínio personalizado. A versão resumida:
| Você vê | Causa comum | Correção |
|---|---|---|
| Travado em Aguardando DNS | O registro está no host DNS errado, o nome está duplicado (help.example.com.example.com) ou ainda não apareceu. |
Aguardando DNS |
| "Your CNAME points somewhere else" | Valor incorreto ou um registro A, AAAA ou CNAME antigo no mesmo nome. | Corrigir o destino |
| "Your record goes through Cloudflare's proxy" | O registro está com Proxy (nuvem laranja). | Defina como Apenas DNS. Detalhes |
| "Your DNS provider flattens the CNAME" | "Flatten all CNAMEs" do Cloudflare ou a chave Flatten do registro, um registro ALIAS/ANAME ou um Alias do Route 53. | Use um CNAME simples. Detalhes |
| "Our hosting provider couldn't confirm the domain" | O registro mudou nos últimos minutos ou está com flattening ou proxy. | Detalhes |
| Travado em Emitindo certificado ou "The certificate wasn't issued" | Um registro CAA, um proxy ou flattening bloqueia o certificado. | Detalhes |
| "Your CAA records block the certificate" | Seus registros CAA não permitem a Amazon. | Adicione 0 issue "amazon.com". Detalhes |
| "This domain is already used by another service" | O domínio ainda está vinculado a outra configuração de hospedagem, geralmente seu host de documentação anterior. | Detalhes |
| "This domain is connected to another Clevera site" | Outro site de documentação possui ou detém o domínio. | Adicione o registro TXT. Detalhes |
| Leitores veem "403 ERROR" ou "Not secure" | Normal até que o domínio esteja Ao vivo ou após ser desconectado. | Detalhes |
| "Not found" logo após Ao vivo | O site ainda está republicando sob o novo endereço. | Aguarde alguns minutos, faça uma atualização forçada. Detalhes |
| "We can't find your CNAME record any more" | O registro foi removido, editado, teve proxy ou flattening aplicado após ir ao ar. | Recoloque-o em até 14 dias. Detalhes |
| Domain "is paused" | O plano não inclui mais domínios personalizados ou o site está pausado. | Detalhes |
| Uma mensagem ao clicar em Conectar | Partes extras no endereço, um domínio raiz, plano Gratuito ou o site já possui um domínio. | Mensagens de conexão |
Aguardar é normal: as alterações de DNS geralmente aparecem em minutos e podem levar até um dia, e o certificado geralmente leva de 5 a 30 minutos depois disso.
Sites privados
O que os leitores veem em um site com senha ou login de workspace:
| Mensagem | Motivo | O que fazer |
|---|---|---|
| "That password didn't work." | Senha incorreta. | Compartilhe a senha atual novamente. |
| "Too many attempts. Wait a minute and try again." | Muitas senhas incorretas em pouco tempo. | Aguarde e tente novamente. |
| "You don't have access to this doc site" | O leitor fez login com uma conta que não é membro do seu workspace. | Convide-o para o workspace ou peça que faça login com a conta que usa lá. |
| "We can't sign you in right now. Try again in a few minutes." | Um problema temporário. | Tente novamente mais tarde. |
| Leitores são solicitados a inserir a senha novamente | Você alterou a senha, o tipo de acesso ou clicou em Desconectar todos. | Compartilhe a nova senha. |
Nas configurações: uma senha precisa de pelo menos 10 caracteres ("Use at least 10 characters."), e sites privados estão disponíveis no plano Pro em diante. Consulte Controlar quem pode ler um site de documentação.
O assistente de IA
| Mensagem | Por que | O que fazer |
|---|---|---|
| Leitores veem "O assistente não está disponível no momento. Pesquise nos documentos." | O workspace usou suas respostas mensais, o site usou seu compartilhamento diário, o leitor fez 30 perguntas hoje ou há um problema temporário. | Verifique Insights → Assistente. Faça upgrade ou aguarde a redefinição no dia 1º. |
| Leitores veem "Você está enviando perguntas rapidamente. Aguarde um momento e tente novamente." | Perguntas enviadas rápido demais. | Aguarde um momento. |
| "As respostas da IA estão pausadas até data" | O workspace usou suas respostas do mês. Leitores ainda podem usar a pesquisa. | Fazer upgrade para mais respostas. |
| "Experimente o assistente no seu site publicado." | Você está na visualização do aplicativo. | Abra o site ativo. |
| Sem Perguntar à IA no site | O assistente está desativado ou ainda não foi publicado. | Ative Mostrar o assistente e publique. |
Veja Configurar o assistente do site de documentação.
Sites pausados, offline e suspensos
Um site está pausado
"Este site está pausado porque seu plano inclui menos sites de documentação. Ele é somente leitura e ficará offline em data."
Seu workspace tem mais sites de documentação do que o plano inclui, geralmente após um downgrade. Sites pausados permanecem online, mas apenas como leitura, e ficam offline 30 dias depois. Nada é excluído. Clique em Escolher sites para manter ou faça upgrade. Você recebe e-mails quando um site é pausado e antes de ele ficar offline. Veja Planos e limites de sites de documentação.
O que os leitores veem
| Leitores veem | Por que | O que fazer |
|---|---|---|
| "Este site está offline" / "O proprietário tirou este site de documentação do ar." | O site não foi publicado, foi pausado após a data de expiração, é privado em um plano sem sites privados ou nunca foi publicado. | Publique-o, mantenha-o ou faça upgrade. |
| "Este site está indisponível" / "Este site de documentação foi suspenso." | A Clevera suspendeu o site. | Entre em contato com o suporte. |
| "Este site foi removido" / "Não há mais um site de documentação neste endereço." | O site foi excluído, o domínio foi desconectado ou um endereço antigo parou de redirecionar. | Compartilhe o endereço atual. |
| "Página não encontrada" | Nada está publicado neste endereço. | Verifique o endereço ou publique o site. |
| "Esta página não existe" / "Ela pode ter sido movida ou o link tem um erro de digitação." | A página não está no site ativo. | Adicione um redirecionamento a partir do endereço antigo. |
Sites suspensos
"Este site foi tirado do ar pela Clevera e é somente leitura. Entre em contato com o suporte se achar que isso é um erro."
Um site suspenso fica offline e é somente leitura, e suas configurações não podem ser alteradas. O proprietário do workspace recebe um e-mail com o motivo. Entre em contato com o suporte para restaurá-lo.
Importações e exportações
| Mensagem | O que fazer |
|---|---|
| "Apenas o proprietário do workspace pode importar ou exportar conteúdo." | Peça ao proprietário. |
| "Esse token não funcionou. Verifique se ele foi copiado na íntegra e tem acesso de leitura, depois tente novamente." | Crie um novo token com acesso de leitura. |
| "Não conseguimos acessar a origem." / "Não conseguimos encontrar a origem." | Verifique se o endereço abre em um navegador. |
| "O site bloqueou nosso leitor. Só podemos importar páginas públicas." | Use a API ou o método zip, se houver um. |
| "O robots.txt deste site pede aos rastreadores para não lerem estas páginas." | Permita a leitura ou use outro método. |
| "Não encontramos páginas para importar." | Verifique se o endereço aponta para a documentação, não para uma página de marketing. |
| "A origem está limitando a velocidade de leitura. Tente novamente em alguns minutos." | Aguarde e comece novamente. |
| "A importação parou inesperadamente. O que foi importado está no relatório; você pode desfazer." | Abra o relatório, desfaça se desejar e comece novamente. |
| "Algumas dessas páginas estão ativas no seu site, portanto a importação não pode ser desfeita." | Remova as páginas que você não deseja. |
| "Você pode solicitar até 3 exportações por dia." | Aguarde até o horário mostrado. |
Veja Importar e exportar um site de documentação.
Formulário de contato
| Mensagem | O que fazer |
|---|---|
| Ainda não verificado no cartão de contato | Clique no link no e-mail de confirmação. As mensagens não são entregues até que você faça isso. |
| "Este link expirou" | Os links funcionam por 7 dias. Clique em Reenviar. |
| "Este link não é mais válido" | Use o link mais recente ou clique em Reenviar. |
| "Enviamos um link há menos de um minuto. Verifique a caixa de entrada e tente novamente." | Aguarde um minuto. |
| "Enviamos o limite máximo de links de confirmação hoje. Tente novamente amanhã." | Você pode enviar 10 links por dia. |
| "O formulário de contato está disponível no plano Starter e superior." | Faça upgrade para ativá-lo. |
| Leitores veem "A mensagem não pôde ser enviada. Tente novamente mais tarde." | Um problema temporário; os leitores podem tentar novamente. |
| Leitores veem "Você enviou várias mensagens. Tente novamente mais tarde." | Um endereço enviou várias mensagens em pouco tempo. |
Veja Coletar feedback e mensagens dos leitores.
Criar um site e seu endereço
| Mensagem | O que fazer |
|---|---|
| "Use pelo menos 6 caracteres" / "Use 40 caracteres ou menos" | Os endereços têm de 6 a 40 caracteres. |
| "Use letras minúsculas, números e hifens simples" | Sem espaços, maiúsculas ou hifens duplos, e nenhum hífen no início ou no fim. |
| "Este endereço está reservado" / "Este endereço não está disponível" | Escolha outro endereço. |
| "Este endereço contém um nome protegido. Entre em contato com o suporte se for sua marca." | Entre em contato com o suporte com a prova de que é sua marca. |
| "Outro site já usa este endereço" | Escolha outro endereço. |
| "Seu plano inclui 1 site de documentação." | Faça upgrade ou exclua um site que você não precisa. |
| "Você pode criar até 5 sites de documentação por dia. Tente novamente amanhã." | Aguarde até amanhã. |
Veja Criar um site de documentação.
Ainda com problemas?
Entre em contato com o suporte da Clevera. Inclua o nome do site e a mensagem exata que você vê.