Central de ajuda · Guia de acesso

Dê a cada cliente as respostas certas

Mostre cada orientação para quem ela realmente se aplica. Use os públicos básicos para visitantes e clientes conectados, ou crie grupos a partir de atributos verificados, como plano e função.

1. Conecte o login verificado dos clientes

Um proprietário ou administrador configura o acesso em Canais → seu canal → Central de ajuda. O desenvolvedor do seu app conecta a identidade dos clientes uma única vez. Para conteúdo só para visitantes, você pode escolher Visitantes sem criar um fluxo de login.

  1. Abra a aba Chat ao vivo do canal. Conecte um site se o canal ainda não tiver um e encontre Identidade segura do visitante.
  2. Escolha Verificação opcional ou Exigir comprovação para identificar, selecione Gerar segredo de assinatura e guarde-o apenas no seu backend. Se já houver um segredo configurado, escolha Opcional — verificar quando houver JWT ou Obrigatório para identificação e atributos em Modo de verificação. Exigir comprovação para identificar ainda permite chat anônimo; é o público da central de ajuda que controla o acesso ao conteúdo.
  3. Depois que o seu app autentica um cliente, o seu servidor assina um token de identidade de curta duração (JWT) com user_id, email, iat, exp e atributos confiáveis. Leia plan e role do seu próprio banco de dados. Atributos não assinados enviados pelo navegador e campos do contato não concedem acesso.
  4. Passe o JWT para o widget e conecte uma ação de login da central de ajuda para quem abre as páginas hospedadas ou o seu domínio personalizado. Use o passo a passo para desenvolvedores indicado abaixo para ver o código exato.
Gere e envie uma identidade verificada

No exemplo abaixo, os atributos assinados são:

JSON · atributos dentro do JWT assinado
{"plan":"pro","role":"admin"}

2. Crie um público de clientes Pro

  1. Volte para Central de ajuda. Em Públicos, selecione Novo público (o botão de mais) ou Criar um público, se este for o seu primeiro grupo.
  2. Digite Clientes Pro em Nome. Deixe Corresponder a definido como Todas as regras.
  3. Em Atributo, digite plan. Defina Condição como é um destes e Tipo de valor como Texto.
  4. Digite pro e business em linhas separadas em Valores · um por linha. Selecione Salvar público.
  5. Para criar um grupo Administradores, repita com Atributo role, Condição é, Tipo de valor Texto e Valor admin.

Como as regras são avaliadas: Todas as regras exige todas as condições deste público; Qualquer regra exige pelo menos uma. Você pode adicionar até 10 regras. Todos os públicos herdados ainda precisam corresponder, mesmo que um público específico use Qualquer regra.

Texto diferencia maiúsculas de minúsculas. O número 5 é diferente do texto “5”; escolha Número para comparações como é no mínimo. Atributos ausentes nunca atendem a comparações, inclusive não é. tem um valor exclui null; não tem valor corresponde a ausente ou null. As chaves de atributo começam com uma letra e usam letras, números ou sublinhados, com até 64 caracteres; chaves de identidade reservadas, como email, não são atributos.

3. Aplique o público onde precisar

Um artigo

Abra o artigo, defina Quem pode ler isto? como Clientes verificados e escolha Clientes Pro em Público de clientes. Selecione Publicar para um artigo novo ou Salvar alterações para um já publicado. Se o acesso básico for herdado, ele fica somente leitura; mesmo assim, você pode escolher um público de clientes adicional.

Uma categoria inteira

Selecione o lápis ao lado da categoria em Categorias. Escolha Clientes verificados e um Público de clientes e clique em Salvar. Todos os artigos dessa categoria precisam atender a essa restrição, além das suas próprias.

Uma central de ajuda privada

  1. Em Acesso à central de ajuda, escolha Clientes verificados. Deixe Público de clientes como Todos os clientes verificados ou escolha Clientes Pro para restringir toda a central a esse grupo.
  2. Informe a página de login do seu app em URL de login dos clientes, por exemplo https://app.example.com/login. Esta é a página de login do seu app, não o login da equipe no Sonny.
  3. Depois do login, o seu app precisa enviar o cliente para o endpoint de autenticação da central de ajuda com um JWT assinado novo. A URL de login sozinha não completa essa conexão.
  4. Selecione Salvar acesso. Mantenha a central como Publicado para que os clientes autorizados possam abri-la.
Conecte o login das páginas hospedadas e do domínio personalizado

As restrições se somam. Se a central de ajuda exige Clientes Pro e uma categoria exige Administradores, os artigos dela exigem os dois. Todos em um artigo não substitui a categoria. Visitantes e clientes verificados são públicos básicos mutuamente exclusivos.

4. Visualize a prévia e depois confira uma sessão real de cliente

  1. No topo da Central de ajuda, mude Ver como para Visitante, Cliente verificado ou Cliente com atributos….
  2. Em Cliente com atributos…, digite o JSON de exemplo acima. As linhas esmaecidas ficam ocultas para esse leitor; a contagem considera o status de publicação e todas as restrições herdadas. Todos os artigos volta para a lista completa de edição.
  3. Use a tabela abaixo para testar uma central de ajuda só para clientes Pro que contém uma categoria só para administradores. Altere plan e role do exemplo para conferir cada resultado.
  4. Abra um navegador real sem login e entre com cada cliente de teste. Confira a navegação, a pesquisa, a URL direta de um artigo e a aba Ajuda do widget. Visualizar atributos na prévia não faz o seu login nem altera o acesso de um cliente.
Acesso esperado em uma central só para Pro com uma categoria só para administradores
LeitorCentral de ajudaArtigo da categoria de administradores
Visitante sem loginPágina de loginOculto
Cliente Pro, administradorPode lerPode ler
Cliente Pro, membroPode lerOculto
Cliente gratuito, administradorMensagem de acessoOculto

Artigos negados são omitidos dos resultados, e URLs diretas retornam não encontrado. Uma central de ajuda privada mostra uma página de login ou uma mensagem de acesso com a sua marca em vez do conteúdo. O sitemap dela fica vazio e a indexação não é permitida; artigos só para visitantes também ficam fora dos sitemaps públicos. As respostas da IA e as buscas do Copilot seguem as mesmas regras para a identidade verificada do cliente na conversa.

As URLs das imagens enviadas são públicas. Restringir um artigo não protege as imagens dele se alguém já tiver a URL da imagem.

Altere ou remova um público

Edite um público pelo botão de lápis e selecione Salvar público. As alterações nas regras valem a partir da próxima requisição. Atributos de cliente atualizados exigem um novo JWT ou um novo login na central de ajuda; sessões de leitor já assinadas mantêm os atributos até expirarem.

Para remover uma restrição nomeada de um lugar, selecione Todos os clientes verificados (ou Todos do público herdado) em Público de clientes e salve. Para tornar esse conteúdo público, escolha também Todos em Quem pode ler isto? e confira se os níveis acima permitem acesso público.

O botão de excluir do público mostra quantos artigos, categorias e centrais de ajuda o usam. A exclusão remove as regras de atributos desse grupo; o conteúdo vinculado continua só para clientes verificados e mantém as demais restrições herdadas. Clientes que antes não atendiam à regra excluída podem passar a ter acesso. Revise essas atribuições antes de confirmar.

Solucione problemas de acesso

Um cliente verificado vê a página de login
Confira o modo de verificação na aba Chat ao vivo deste canal, a validade do JWT, o segredo de assinatura e a URL de login da central de ajuda. O login da equipe no painel é separado do login dos clientes.
O cliente está conectado, mas não consegue ler uma resposta
Confira todos os públicos herdados e os nomes, tipos e valores exatos dos atributos assinados. Um cliente Pro ainda pode ser barrado pela regra de administradores de uma categoria.
Quem pode ler isto? está desativado
A central de ajuda ou a categoria define o público básico. Edite esse nível acima para alterá-lo; use Público de clientes para restringir ainda mais o acesso verificado.
Aparece Nenhum leitor correspondente
Restrições só para visitantes e só para verificados entram em conflito. Use o acesso herdado quando for oferecido ou corrija primeiro as configurações da central de ajuda ou da categoria.
Uma mudança de plano ainda não alterou o acesso
Gere um novo JWT com os atributos atualizados e identifique o cliente de novo no widget. Nas páginas hospedadas ou de domínio personalizado, faça o login na central de ajuda novamente. Os cookies existentes mantêm os atributos assinados até expirarem.
Um artigo não aparece na pesquisa ou no widget
Confira se ele está publicado, se a central está como Publicado, se Pesquisa está ativada para os resultados de pesquisa e se o leitor atende a todas as restrições. Uma aba Ajuda vazia fica oculta.

Documentos relacionados