Base de conocimiento de GetMyBot

Centro de ayuda público

Publique artículos de la base de conocimientos como un sitio público con capacidad de búsqueda, en varios idiomas, en su propio dominio.

En esta página

El centro de ayuda convierte los artículos publicados de la base de conocimientos en un sitio público con navegación, búsqueda, comentarios sobre artículos y su propio mapa del sitio . Se configura en Base de conocimientos → Centro de ayuda.

Cada centro de ayuda tiene una dirección permanente con el formato https://getmybot.dev/help/{key}, donde {key} es una clave pública opaca generada para el bot. Se puede agregar un dominio personalizado como help.example.com más adelante; La dirección permanente sigue funcionando.

Lo que se publica

El estado del artículo lo decide todo:

  • Publicado — visible en el sitio y en su búsqueda.
  • Interno: disponible solo para el agente de IA. Nunca aparece en el sitio, en los resultados de búsqueda, en el mapa del sitio ni en los metadatos de la página.
  • Borrador: nunca publicado en ninguna parte; Ni siquiera se puede buscar internamente.

Las categorías le dan al sitio su navegación. Solo se muestran las categorías que seleccione en Categorías de navegación, y una categoría aparece en esa lista una vez que contiene un artículo publicado.

Las solicitudes de un artículo faltante y las solicitudes de uno privado devuelven la misma respuesta , por lo que el sitio no se puede utilizar para investigar qué títulos internos existen.

Marca e idiomas

  • Nombre del centro de ayuda y logotipo (una imagen de hasta 2 MB).
  • Color de acento: un valor hexadecimal simple como GMBTOken0X, que se utiliza para enlaces y acciones principales de . Se rechaza el CSS arbitrario.
  • Idiomas disponibles e idioma predeterminado. Un visitante puede cambiar el idioma ; una solicitud de un idioma que usted no ofrece vuelve al el predeterminado.
  • Enlace de chat de soporte: la dirección detrás del botón "Contactar con soporte". Sólo se aceptan direcciones https://.
  • Habilitar el centro de ayuda público: el interruptor maestro. Mientras está desactivado, las rutas públicas no devuelven nada en absoluto.

Búsqueda y comentarios

La búsqueda del sitio cubre artículos publicados en el idioma seleccionado. Se ejecuta en el servidor , por lo que también encuentra palabras que no están en el título.

Debajo de cada artículo, un visitante responde ¿Le resultó útil este artículo?. Un visitante de puede votar una vez por artículo: el sitio establece una cookie solo HTTP firmada para con ese propósito, acepta el voto solo desde sus propias páginas y limita las tarifas de los envíos de . Los votos se cuentan por artículo y alimentan la base de conocimientos. análisis en lugar de mostrarse a los visitantes.

Motores de búsqueda

Permitir que los motores de búsqueda indexen este centro de ayuda controla el robots.txt y el mapa del sitio generados:

  • activado: robots.txt permite el rastreo y apunta a /help/{key}/sitemap.xml, que enumera la página de índice de cada idioma habilitado y cada artículo publicado, con la fecha de la última actualización del artículo.
  • Desactivado: robots.txt no permite todo y el mapa del sitio está vacío.

El modificador se lee en el momento de la solicitud y la respuesta nunca se almacena en caché, por lo que desactiva la indexación y surte efecto inmediatamente. El contenido interno y borrador nunca llega al mapa del sitio ni a los metadatos de la página.

Dominio personalizado

Agregar un dominio es un flujo DNS de dos registros.

  1. Ingrese la dirección (por ejemplo, help.example.com) en Dominio personalizado. El nombre de host está normalizado a su formato ASCII; Se rechazan las direcciones IP, los comodines localhost, y los sufijos públicos simples como example.co.uk.
  2. El panel muestra dos registros que deben existir:
    • un registro TXT en ese nombre de host con el valor mybot-help=<token>,
    • un registro CNAME que apunta el nombre de host al host de la aplicación.
  3. Presione Verificar DNS. La verificación requiere el valor TXT exacto y un destino que realmente se resuelva en el host de la aplicación.

El valor TXT se muestra una vez, justo después de agregar el dominio, y se mantiene solo en ese navegador. Si lo pierde, elimine el dominio y agréguelo nuevamente para recibir un nuevo valor .

Los estados del dominio son En espera de verificación, Verificado, Activo, Error de verificación y Deshabilitado. Una verificación fallida almacena un motivo:

  • El valor TXT no coincide con el emitido: publicaste un token diferente o más antiguo.
  • El registro TXT no se encontró en DNS: el registro falta o aún no se ha propagado. Los cambios de DNS pueden tardar hasta 24 horas.
  • El dominio no apunta al destino mostrado: el CNAME (o los registros A ) se resuelven en otro lugar.

HTTPS, enrutamiento y desactivación de

Se emite un certificado a pedido y solo para un nombre de host que esté actualmente activo en un centro de ayuda habilitado; el servidor web solicita la API antes de cada emisión de . Por lo tanto, un nombre de host no verificado o deshabilitado nunca recibe una certificado.

Una vez que un dominio está activo, las solicitudes se reescriben en el centro de ayuda de ese bot mientras se conservan la ruta y el idioma. Una búsqueda de host exitosa se almacena en caché solo durante 30 segundos, por lo que la desactivación de un dominio surte efecto casi de inmediato.

Desactivar desactiva tanto la ruta pública como el acceso al certificado mientras mantiene el registro. Un dominio deshabilitado no se puede volver a verificar: elimínelo y agréguelo nuevamente para obtener un nuevo valor TXT. Eliminar lo elimina por completo.

Páginas relacionadas