Configurações do portal da Central de Ajuda

Visão geral

O portal é o site público da sua Central de Ajuda: a página inicial, as categorias, os artigos e a busca que seus clientes acessam sem precisar de login. Tudo o que define a aparência e o comportamento desse site fica em Central de Ajuda → (portal) → Configurações, na rota .../portals/<slug>/settings do painel.

A tela tem quatro abas verticais:

Há ainda uma configuração que não vive nessa tela: o conteúdo recomendado, escolhido por idioma na página Localidades do portal.

Pré-requisitos

• O recurso Central de Ajuda (help_center) precisa estar habilitado na conta — ele vem ligado por padrão. Com o recurso desligado, as páginas públicas do portal param de servir conteúdo e passam a exibir um aviso de central inativa.
• Um portal já criado na conta.
• Para editar a seção de analytics você precisa ser administrador da conta. A restrição é aplicada nas duas pontas: os cartões só aparecem para administradores e a API descarta os campos de analytics enviados por quem não é administrador — mesmo que o papel tenha permissão para editar as outras configurações do portal. O motivo está no próprio código: analytics injeta scripts de rastreamento em todas as páginas públicas.
• Para domínio próprio, acesso ao painel de DNS do domínio.

Passo a passo

1. Abra Central de Ajuda no menu lateral e selecione o portal que deseja configurar.
2. Clique em Configurações. A aba Geral abre primeiro.
3. Em Geral, ajuste nome, identificador, título da página, texto do cabeçalho, cor e logo. O botão de salvar só habilita quando algo muda.
4. Em Domínio, clique em Adicionar (ou Editar) e informe o domínio próprio. Ao salvar, a plataforma abre o diálogo de DNS com o registro pronto para copiar, no formato seu-dominio CNAME <host da instalação>. Você pode enviar essas instruções por e-mail para quem administra o DNS.
5. Em Tema, escolha o leiaute e, no leiaute Documentação, adicione os links sociais.
6. Em Integrações, escolha o widget de chat ao vivo e preencha os identificadores de analytics que quiser usar. Clique em Salvar Alterações.
7. Para o conteúdo recomendado, volte à Central de Ajuda, abra Localidades, clique no menu do idioma desejado e escolha Selecionar conteúdo recomendado.

Configurações & opções

Conteúdo recomendado por idioma

O diálogo Conteúdo recomendado deixa você fixar, para cada idioma, quais categorias e quais artigos aparecem em destaque na página inicial:

• Até 3 categorias e até 6 artigos. O contador mostra quantos slots restam.
• A ordem importa: arraste os itens para a sequência em que os visitantes devem vê-los. A página inicial respeita exatamente essa ordem.
• A busca de artigos é feita no servidor e considera apenas artigos publicados daquele idioma.
• Salvar com as duas listas vazias remove a seleção daquele idioma, e o portal volta aos padrões automáticos.

Como a página inicial decide o que mostrar:

Duas regras que evitam surpresas: uma categoria recomendada não precisa ter artigos publicados para aparecer, ao contrário da lista automática, que só considera categorias com pelo menos um artigo publicado. Já a visibilidade não é negociável — categorias e artigos restritos a operadores nunca aparecem no portal público, e itens excluídos depois da escolha simplesmente somem da lista.

Leiaute

Duas opções, gravadas no portal:

• Clássico — página inicial acolhedora, com busca e tópicos em destaque.
• Documentação (marcado como beta) — navegação lado a lado, que mantém todos os guias a um clique de distância.

Qualquer valor diferente desses dois é tratado como Clássico. Existe ainda uma variação interna "simples" (?show_plain_layout=true), usada pela prévia de artigo dentro do painel — ela não é uma opção de configuração.

Links sociais

A seção de links sociais aparece somente quando o leiaute é Documentação, porque é o rodapé desse leiaute que exibe os ícones. São oito redes, e você digita apenas o identificador — a plataforma monta o endereço completo:

Remover um link limpa o identificador guardado. O rodapé some por completo quando não há nenhuma rede preenchida e a assinatura da plataforma está desativada — seja pelo whitelabel da conta, seja pela remoção da assinatura configurada para toda a instalação.

Domínio próprio

• O domínio é único em toda a instalação: dois portais não podem apontar para o mesmo endereço.
• O campo aceita apenas o domínio puro, como ajuda.suaempresa.com. Colar um endereço completo, com https:// ou com caminho, é recusado no próprio diálogo com um erro de formato.
• O diálogo de DNS mostra o registro CNAME pronto, com botão de copiar.
• O envio das instruções por e-mail exige um endereço válido e um domínio já configurado no portal — sem isso a ação é recusada com uma mensagem explicando o motivo.
• O status do certificado (Ativo / Pendente / Erro) e o botão de atualizar status aparecem apenas em contas hospedadas na nuvem. Em instalações próprias, o certificado é responsabilidade da sua infraestrutura.

Chat ao vivo

O cartão Chat ao vivo com o ConversaLabs conecta uma caixa de entrada de widget de site ao portal, para que o visitante fale com a equipe enquanto lê os artigos. A lista mostra apenas caixas do tipo widget de site; escolher Sem widget desconecta o portal de qualquer widget.

Provedores de analytics

Sete provedores, cada um com o seu identificador e um formato validado antes de salvar:

Como isso é injetado no portal:

• O bloco de scripts entra no <head> de todas as páginas públicas do portal — exceto na prévia interna de artigo (leiaute simples), justamente para que a prévia não conte como visita.
• Google Tag Manager e Meta Pixel também recebem a versão noscript (iframe e pixel de imagem) logo no início do <body>, para navegadores com JavaScript desativado.
• O Meta Pixel dispara PageView a cada navegação interna do portal, não só no primeiro carregamento.
• Deixar o campo em branco desativa aquele provedor: valores vazios são descartados no envio.

Casos de uso

• Lançamento de produto: fixe a categoria do produto novo nas pílulas do topo e os 6 artigos de primeiros passos como recomendados, no idioma do público-alvo.
• Central multilíngue: escolha recomendações diferentes por idioma — o público em espanhol vê os guias em espanhol em destaque, sem afetar o português.
• Base de conhecimento técnica: use o leiaute Documentação, com navegação lateral e links sociais no rodapé.
• Marca própria: publique a Central em ajuda.suaempresa.com com domínio próprio e logo.
• Medição de conteúdo: conecte GA4 para medir tráfego e Microsoft Clarity para ver mapas de calor de quais artigos travam o visitante.
• Anúncios: use o Meta Pixel para medir conversões e montar públicos a partir de quem lê a Central.

Dicas, limites e boas práticas

• Os limites de 3 categorias e 6 artigos são rígidos. Se você tentar gravar mais do que isso pela API, apenas os primeiros itens da lista são considerados.
• Prefira um contêiner do Google Tag Manager a vários scripts soltos: você troca tags sem precisar voltar ao painel.
• Não use GTM e GA4 ao mesmo tempo para a mesma propriedade — isso dobra a contagem de visitas.
• Trate os identificadores de analytics como configuração de alto impacto: eles adicionam scripts de terceiros a páginas públicas, o que afeta desempenho e privacidade. Reveja a sua política de cookies antes de ligar mapas de calor e gravações de sessão.
• Revise as recomendações depois de arquivar ou excluir artigos: o item some do portal, mas a lista continua com um slot ocupado até você editá-la.
• Duas pessoas podem salvar abas diferentes ao mesmo tempo sem apagar o trabalho uma da outra — a plataforma trava o registro durante a gravação e mescla sobre a versão mais recente.
• O idioma padrão do portal não pode estar marcado como rascunho.

Solução de problemas

"Configuração de analytics inválida" — a requisição trouxe um campo de analytics que não existe ou um valor que não é texto. Use apenas os sete campos da tabela acima.

A mensagem diz que um campo de analytics é inválido — o valor não bate com o formato esperado. Confira o prefixo (GTM-, G-) e o tipo de caractere: Hotjar e Meta Pixel aceitam apenas dígitos. O painel também marca o campo em vermelho e bloqueia o botão de salvar antes do envio.

O botão Salvar está desabilitado — ou nada mudou desde a última gravação, ou algum campo está com formato inválido, ou uma gravação ainda está em andamento.

Não vejo os cartões de analytics — eles são exclusivos de administradores da conta.

Os eventos não aparecem quando abro a prévia do artigo pelo painel — é o comportamento esperado: a prévia interna não carrega os scripts de analytics, para não poluir suas métricas com tráfego da própria equipe.

Um artigo recomendado não aparece na página inicial — verifique se ele está publicado, se é público (e não restrito a operadores), se pertence ao mesmo idioma da recomendação e se não foi excluído depois da escolha.

O bloco de artigos em destaque não aparece no leiaute Clássico — sem conteúdo recomendado, esse bloco exige pelo menos 6 artigos publicados dentro de categorias visíveis do idioma; abaixo disso ele fica oculto. Escolher artigos recomendados exibe o bloco com qualquer quantidade.

Configurei os links sociais e o rodapé continua sem ícones — os links sociais só são exibidos no leiaute Documentação.

O status do certificado não aparece — ele é exibido apenas em contas na nuvem; em instalação própria, verifique o certificado na sua infraestrutura.

As instruções de DNS não são enviadas — confirme que o portal já tem um domínio próprio salvo e que o e-mail informado é válido.

Veja também

• Integrações
• Custom Scripts: injetar JS/CSS no dashboard, portal e widget
• Whitelabel
• Canal Site (widget)