## 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:

| Aba | O que controla |
|---|---|
| **Geral** | Nome, identificador (slug), título da página, texto do cabeçalho, cor, logo, link da página inicial e exclusão do portal |
| **Domínio** | Domínio próprio, registro CNAME, status do certificado e envio das instruções por e-mail |
| **Tema** | Leiaute (Clássico ou Documentação) e links das redes sociais |
| **Integrações** | Widget de chat ao vivo e os provedores de analytics |

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:

| Bloco | Com recomendação | Sem recomendação — leiaute Clássico | Sem recomendação — leiaute Documentação |
|---|---|---|---|
| Pílulas de tópicos no topo | Suas categorias recomendadas, na sua ordem | Nenhuma pílula aparece: o Clássico não monta lista automática | As 3 primeiras categorias visíveis que já tenham artigo publicado, por posição |
| Bloco de artigos em destaque | Seus artigos recomendados, na sua ordem | Os 6 artigos mais vistos entre as categorias visíveis, e o bloco só aparece se houver pelo menos 6 | Os 6 artigos mais vistos do idioma, mesmo que existam menos de 6 |

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:

| Rede | Prefixo aplicado |
|---|---|
| Facebook | `facebook.com/` |
| X | `x.com/` |
| Instagram | `instagram.com/` |
| LinkedIn | `linkedin.com/` |
| YouTube | `youtube.com/` |
| TikTok | `tiktok.com/` |
| GitHub | `github.com/` |
| WhatsApp | `wa.me/` |

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:

| Provedor | Campo | Formato aceito | Exemplo |
|---|---|---|---|
| Google Tag Manager | `gtm_container_id` | `GTM-` seguido de letras maiúsculas e números | `GTM-XXXXXXX` |
| Google Analytics 4 | `ga4_measurement_id` | `G-` seguido de letras maiúsculas e números | `G-XXXXXXXXXX` |
| Hotjar | `hotjar_site_id` | apenas dígitos | `1234567` |
| Plausible | `plausible_domain` | domínio (letras, números, ponto e hífen) | `example.com` |
| Amplitude | `amplitude_api_key` | letras e números | `0123456789abcdef0123456789abcdef` |
| Microsoft Clarity | `clarity_project_id` | letras e números | `abcd1234ef` |
| Meta Pixel | `meta_pixel_id` | apenas dígitos | `123456789012345` |

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](/hc/ajuda/articles/administration-integracoes-pt-br)
- [Custom Scripts: injetar JS/CSS no dashboard, portal e widget](/hc/ajuda/articles/administration-custom-scripts-pt-br)
- [Whitelabel](/hc/ajuda/articles/administration-whitelabel-pt-br)
- [Canal Site (widget)](/hc/ajuda/articles/inboxes-channels-canal-site-widget-pt-br)