Centro de ayuda · Guía de acceso

Da a cada cliente las respuestas adecuadas

Muestra cada indicación a las personas a las que se aplica. Usa audiencias básicas para visitantes y clientes con sesión iniciada, o crea grupos a partir de atributos verificados como el plan y el rol.

1. Conecta el inicio de sesión de clientes verificados

Un propietario o administrador configura el acceso en Canales → tu canal → Centro de ayuda. El desarrollador de tu aplicación conecta la identidad del cliente una sola vez. Para contenido solo para visitantes, puedes elegir Visitantes sin crear ningún flujo de inicio de sesión.

  1. Abre la pestaña Chat en vivo del canal. Conecta un sitio web si el canal no tiene ninguno y busca Identidad de visitante segura.
  2. Elige Verificación opcional o Exigir prueba para identificar, selecciona Generar secreto de firma y guárdalo solo en tu backend. Si ya hay un secreto configurado, elige Opcional: verificar cuando haya un JWT u Obligatorio para identificar y definir atributos en Modo de verificación. Exigir prueba para identificar sigue permitiendo el chat anónimo; la audiencia del centro de ayuda es la que controla el acceso al contenido.
  3. Cuando tu aplicación autentica a un cliente, tu servidor firma un token de identidad de corta duración (JWT) con user_id, email, iat, exp y atributos de confianza. Lee el plan y el rol de tu propia base de datos. Los atributos sin firmar del navegador y los campos del contacto no pueden conceder acceso.
  4. Pasa el JWT al widget y conecta una acción de inicio de sesión del centro de ayuda para quienes abran las páginas alojadas o tu dominio personalizado. Usa la guía para desarrolladores enlazada abajo para ver el código exacto.
Genera y envía una identidad verificada

En el ejemplo de abajo, los atributos firmados son:

JSON · atributos dentro del JWT firmado
{"plan":"pro","role":"admin"}

2. Crea una audiencia de clientes Pro

  1. Vuelve a Centro de ayuda. En Audiencias, selecciona Nueva audiencia (el botón +) o Crear una audiencia si es tu primer grupo.
  2. Escribe Clientes Pro como Nombre. Deja Cumplir en Todas las reglas.
  3. En Atributo, escribe plan. Pon Condición en es uno de y Tipo de valor en Texto.
  4. Escribe pro y business en líneas separadas en Valores · uno por línea. Selecciona Guardar audiencia.
  5. Para crear un grupo Administradores, repite el proceso con Atributo role, Condición es, Tipo de valor Texto y Valor admin.

Cómo se cumplen las reglas: Todas las reglas exige que se cumplan todas las condiciones de la audiencia; Cualquier regla exige al menos una. Puedes añadir hasta 10 reglas. Todas las audiencias heredadas deben cumplirse igualmente, aunque una audiencia concreta use Cualquier regla.

El texto distingue mayúsculas y minúsculas. El número 5 es distinto del texto «5»; elige Número para comparaciones como es al menos. Un atributo ausente nunca cumple una comparación, ni siquiera no es. Tiene un valor excluye null; No tiene valor coincide con ausente o null. Las claves de atributo empiezan por una letra y usan letras, números o guiones bajos, hasta 64 caracteres; las claves de identidad reservadas, como email, no son atributos.

3. Aplica la audiencia donde la necesites

Un artículo

Abre el artículo, pon ¿Quién puede leerlo? en Clientes verificados y elige Clientes Pro en Audiencia de clientes. Selecciona Publicar en un artículo nuevo o Guardar cambios en uno publicado. Si el acceso básico es heredado, es de solo lectura; aun así puedes elegir una audiencia de clientes adicional.

Una categoría entera

Selecciona el lápiz junto a la categoría en Categorías. Elige Clientes verificados y una Audiencia de clientes, y selecciona Guardar. Cada artículo de esa categoría debe cumplir esta restricción además de la suya propia.

Un centro de ayuda privado

  1. En Acceso al centro de ayuda, elige Clientes verificados. Deja Audiencia de clientes en Todos los clientes verificados, o elige Clientes Pro para restringir todo el centro a ese grupo.
  2. Introduce la página de inicio de sesión de tu aplicación como URL de inicio de sesión de clientes; por ejemplo, https://app.example.com/login. Es la página de inicio de sesión de tu aplicación, no el acceso del equipo de Sonny.
  3. Tras el inicio de sesión, tu aplicación debe enviar al cliente al endpoint de autenticación del centro de ayuda con un JWT firmado y reciente. La URL de inicio de sesión por sí sola no completa esta conexión.
  4. Selecciona Guardar acceso. Mantén el centro publicado para que los clientes autorizados puedan abrirlo.
Conecta el inicio de sesión en las páginas alojadas y en el dominio personalizado

Las restricciones se suman. Si el centro de ayuda exige Clientes Pro y una categoría exige Administradores, sus artículos exigen ambas. Poner Todos en un artículo no anula la categoría. Visitantes y Clientes verificados son audiencias básicas excluyentes entre sí.

4. Previsualiza y comprueba una sesión real de cliente

  1. En la parte superior de Centro de ayuda, cambia Ver como a Visitante, Cliente verificado o Cliente con atributos….
  2. Para Cliente con atributos…, introduce el JSON de ejemplo de arriba. Las filas atenuadas quedan ocultas para ese lector; el recuento incluye el estado de publicación y todas las restricciones heredadas. Todos los artículos vuelve a la lista de edición completa.
  3. Usa la tabla de abajo para probar un centro de ayuda solo para Pro que contiene una categoría solo para administradores. Cambia el plan y el rol de ejemplo para comprobar cada resultado.
  4. Abre un navegador real sin sesión e inicia sesión con cada cliente de prueba. Comprueba la navegación, la búsqueda, la URL directa de un artículo y la pestaña Ayuda del widget. Previsualizar atributos no inicia tu sesión ni cambia el acceso de ningún cliente.
Acceso esperado para un centro solo para Pro y una categoría solo para administradores
LectorCentro de ayudaArtículo de la categoría de administradores
Visitante sin sesiónPágina de inicio de sesiónOculto
Cliente Pro, administradorPuede leerPuede leer
Cliente Pro, miembroPuede leerOculto
Cliente Free, administradorMensaje de accesoOculto

Los artículos denegados se omiten de los resultados y sus URL directas devuelven «no encontrado». Un centro de ayuda privado muestra una página de inicio de sesión o un mensaje de acceso con tu marca en lugar de su contenido. Su sitemap está vacío y la indexación está bloqueada; los artículos solo para visitantes también se excluyen de los sitemaps públicos. Las respuestas de la IA y la búsqueda del Copilot aplican las mismas reglas a la identidad de cliente verificada de la conversación.

Las URL de las imágenes subidas son públicas. Restringir un artículo no protege sus imágenes si alguien ya tiene la URL de la imagen.

Cambiar o quitar una audiencia

Edita una audiencia con su botón de lápiz y selecciona Guardar audiencia. Los cambios en las reglas se aplican en la siguiente petición. Los atributos de cliente actualizados requieren un JWT nuevo o volver a iniciar sesión en el centro de ayuda; las sesiones de lector firmadas existentes conservan sus atributos hasta que caducan.

Para quitar una restricción con nombre de un sitio, selecciona Todos los clientes verificados (o Todos en la audiencia heredada) en Audiencia de clientes y guarda. Para hacer público ese contenido, elige también Todos en ¿Quién puede leerlo? y comprueba que sus elementos superiores permiten el acceso público.

El botón de eliminar de la audiencia muestra cuántos artículos, categorías y centros de ayuda la usan. Al eliminarla se quitan las reglas de atributos de ese grupo; el contenido vinculado sigue siendo solo para verificados y conserva cualquier otra restricción heredada. Los clientes que antes no cumplían la regla eliminada pueden obtener acceso ahora. Revisa esas asignaciones antes de confirmar.

Resolver problemas de acceso

Un cliente verificado ve la página de inicio de sesión
Comprueba el modo de verificación en la pestaña Chat en vivo de este canal, la caducidad del JWT, el secreto de firma y la URL de inicio de sesión del centro de ayuda. El acceso al panel del equipo es independiente del inicio de sesión de clientes.
El cliente ha iniciado sesión pero no puede leer una respuesta
Revisa todas las audiencias heredadas y los nombres, tipos y valores exactos de los atributos firmados. Un cliente Pro puede no cumplir igualmente la regla de administradores de una categoría.
¿Quién puede leerlo? está desactivado
El centro de ayuda o la categoría definen la audiencia básica. Edita ese elemento superior para cambiarla; usa Audiencia de clientes para acotar aún más el acceso verificado.
Aparece «Ningún lector coincide»
Las restricciones solo para visitantes y solo para verificados se contradicen. Usa el acceso heredado cuando se ofrezca, o corrige primero los ajustes del centro de ayuda o de la categoría.
Un cambio de plan aún no ha cambiado el acceso
Genera un JWT nuevo con los atributos actualizados y vuelve a identificar al cliente en el widget. En las páginas alojadas o con dominio personalizado, completa de nuevo el inicio de sesión del centro de ayuda. Las cookies existentes conservan sus atributos firmados hasta que caducan.
Falta un artículo en la búsqueda o en el widget
Comprueba que está publicado, que el centro está publicado, que Búsqueda está activada para los resultados de búsqueda y que el lector cumple todas las restricciones. Una pestaña Ayuda vacía se oculta.

Documentación relacionada