Centros de ayuda
Crea un centro de respuestas independiente de los agentes. El servicio se habilita en el contrato del cliente desde Central, con la opción Centros de ayuda.
En el panel, abre Centros de ayuda → Nuevo centro. Escribe un nombre, una dirección y elige el acceso. La dirección se conserva después de crear el centro.
- Público: cualquier visitante puede consultar los artículos publicados en el portal.
- Privado: solo los miembros autorizados de la empresa y las claves de servidor con permiso de lectura pueden acceder. El portal público devuelve «no disponible».
Los propietarios y administradores editan artículos. Los demás miembros pueden leer los artículos publicados. Guardar crea un borrador; usa Leer → Publicar artículo para actualizar el portal. Una modificación posterior del borrador no cambia la versión pública hasta volver a publicarla. Retirar publicación oculta el artículo. Las eliminaciones se confirman y quedan auditadas.
La búsqueda consulta texto publicado en la base de datos. Los borradores y centros privados no se incluyen en las respuestas públicas. El contenido se presenta como texto, sin ejecutar HTML.
API
Usa una clave de servidor de producción con help_centers:read o help_centers:write. Consultar borradores requiere permiso de escritura; /reader permite leer lo publicado con permiso de lectura. Las claves de sandbox no acceden a estos recursos. No publiques la clave en un navegador.
| Método | Ruta | Función |
|---|---|---|
| GET / POST | /v1/help-centers |
Listar o crear centros |
| PATCH / DELETE | /v1/help-centers/:id |
Cambiar acceso/datos o eliminar el centro |
| GET / POST | /v1/help-centers/:id/articles |
Listar borradores o crear un artículo |
| PATCH / DELETE | /v1/help-centers/:id/articles/:article |
Guardar o eliminar un artículo |
| POST | /v1/help-centers/:id/articles/:article/publish |
Publicar la revisión indicada |
| POST | /v1/help-centers/:id/articles/:article/unpublish |
Retirar la revisión indicada |
| GET | /v1/help-centers/:id/reader |
Leer únicamente el contenido publicado del centro autorizado |
| GET | /public/help/:tenantSlug/:centerSlug |
Leer un centro público sin credenciales |
Crear un centro: { "name": "Ayuda para clientes", "slug": "clientes", "description": "Respuestas frecuentes", "visibility": "private" }.
Crear un artículo: { "title": "Cómo empezar", "body": "Abre tu panel y configura el servicio.", "category": "Primeros pasos" }.
Al editar un artículo agrega revision con el número obtenido al leerlo. Publicar o retirar requiere { "revision": 1 }, sustituyendo el número por la revisión actual. Una revisión desactualizada devuelve 409 para evitar sobrescribir cambios de otra persona.
Los listados aceptan q, page y pageSize (10, 20, 30 o 50). El portal se abre con el enlace Abrir portal del panel. El cambio a privado se aplica en las siguientes consultas; el contenido que un visitante ya leyó no puede retirarse de su dispositivo.
Esta entrega no incluye dominios personalizados, generación de artículos con IA ni gestión editorial avanzada.