00 · Panorama
Mapa: las dos caras del módulo
OhMySupport sirve para dos cosas a la vez, y las dos importan. Si solo usas la segunda, estás pagando por un buzón; el valor está en la primera.
Ayuda autónoma
El asistente responde dudas, guía paso a paso y lleva al usuario a la pantalla exacta. Objetivo: que NO abra ticket.
widget (Alt+S) · /soporte/conocimientoGestión de la incidencia
Cuando sí hace falta: ticket con contexto, cola, derivación, SLA, solución validada por el cliente y cierre por el cliente.
/soporte/tickets · /soporte/colaEquipo de soporte
/soporte/dashboardPanel completo con sesión de OhMyDat. Incluido en todas las empresas: no se contrata.
Solicitante
/soporte/mis-ticketsCrea, responde y cierra sus propios tickets.
Cliente externo
/soporte/p/<empresa>/<token>Enlace mágico, sin cuenta. Responde y cierra.
Otros sistemas
/api/soporte/v1API pública con clave y webhooks firmados.
Regla de oro
01 · Puesta en marcha
Primeros 10 minutos
El módulo llega con contenido real y políticas razonables, así que se puede usar desde el minuto uno. Estos pasos lo ajustan a tu negocio.
Abre Soporte desde tu empresa: no hay que contratar nada
/dashboard → Abrir soporte → /soporte/dashboardOhMySupport es una utilidad incluida en todas las empresas: aparece en la tarjeta de cada una con la etiqueta «Incluido» y sin precio. Al entrar por primera vez se crea tu espacio con calendario laboral, 4 políticas de SLA, un equipo con su cola, el árbol de categorías, 5 respuestas tipo, 4 automatizaciones y ~16 artículos de ayuda.
Revisa Configuración
/soporte/configuracionRazón social y NIF (salen en los correos), zona horaria, prefijo de numeración de tickets, retención de datos y la pregunta de la encuesta de satisfacción.
Ajusta el calendario y los SLA
/soporte/configuracion/slaPor defecto, de lunes a viernes de 09:00 a 18:00 con los festivos nacionales. Añade los festivos de tu comunidad o de tu empresa: son los que deciden cuándo vence un ticket.
Promueve a tu equipo
/soporte/equipoLos usuarios entran como solicitantes. Desde Equipo se les da rol (agente N1, N2, supervisor o administrador), equipo y capacidad máxima de tickets abiertos.
Ajusta categorías, automatizaciones y respuestas tipo
/soporte/categorias · /soporte/configuracion/reglas · /soporte/configuracion/macrosEl árbol de categorías es el vocabulario que usa el triaje automático: si no refleja tu negocio, la clasificación será peor. Las reglas y macros sembradas son un punto de partida sensato.
Decide el portal del cliente y crea la primera clave de API
/soporte/portal · /soporte/configuracion/apiActiva el portal si vas a atender a clientes externos y crea el primer enlace. Crea una clave de API solo si tienes integraciones que abrirán tickets.
Ya está
/soporte/ayuda) está abierto sin sesión: enseña a usar el hub, Brain, Time, ERP, DeCA y el propio soporte, así que puedes enlazarlo desde tu web o desde un correo de bienvenida. Con sesión, además, muestra los artículos de tu empresa y el botón «Llévame ahí» en cada paso.02 · En todas partes
El widget: soporte desde cualquier pantalla
El widget se monta una sola vez en el layout raíz, así que está en OhMyDat, Brain, Time, ERP, DeCA y en el propio soporte. Y se apaga solo si no hay sesión: no ensucia las páginas públicas.
Ábrelo con el botón o con Alt+S
El botón flota en la esquina inferior derecha. El atajo Alt+S (⌥S en Mac) lo abre y lo cierra desde cualquier pantalla; Escape también lo cierra.
cualquier pantalla → botón de soporte (Alt+S)Soporte
Asistente de IARespuesta de la IA
Puedes pedir a tu responsable una corrección desde Fichajes → Anular. Te llevo a la pantalla.
Llévame ahí →Pestaña Ayuda: lo que aplica a la pantalla donde estás
/api/soporte/widget/ayudaArtículos relacionados con el módulo y la ruta actuales, incidencias conocidas en curso y novedades que aún no has leído. Es la pestaña que más tickets evita.
Pestaña Nuevo ticket: ya viene relleno
Al abrirla, el formulario llega con el módulo, la pantalla, la versión y los errores de consola ya puestos. Solo escribes qué pasaba y, si quieres, adjuntas la captura.
Pestaña Mis tickets: seguimiento sin salir
Tus tickets abiertos con su estado, la última respuesta y el aviso de si el equipo te está esperando a ti.
El widget no espía
03 · Adjuntos
Capturas de pantalla sin fricción
Cuatro caminos, del más rápido al más lento. En la práctica, el 80 % de las capturas se pegan.
1 · Pegar (Ctrl/⌘+V)
Haz la captura con tu herramienta de siempre y pégala en la zona de adjuntos. Es lo más rápido y funciona también para imágenes copiadas de otras apps.
2 · Capturar pantalla
Botón Capturar pantalla: el navegador pide permiso y eliges qué compartir (pestaña, ventana o pantalla). Se toma un fotograma y el stream se corta inmediatamente.
3 · Arrastrar y soltar
Arrastra el fichero sobre la zona de adjuntos. Sirve para imágenes, PDF y ficheros de texto o log.
4 · Seleccionar fichero
El clásico diálogo del sistema, si lo prefieres.
Límites que conviene saber
.png no cuela.No se admiten enlaces a imágenes
04 · Autoayuda
Ayuda autónoma: que no haga falta el ticket
Este es el corazón del módulo. Un centro de ayuda vacío no reduce ni un ticket: por eso el módulo arranca con artículos reales escritos sobre las pantallas de verdad.
Seis tipos de contenido
/soporte/conocimientoArtículo, pregunta frecuente, guía paso a paso, resolución de problemas, novedad e incidencia conocida. Cada uno se muestra de forma distinta al usuario: una guía, por ejemplo, se convierte en pasos numerados con su botón «Llévame ahí».
Público o interno
Los artículos públicos los ve el cliente en el portal y en el widget; los internos solo el equipo. Un procedimiento con datos internos debe ser interno siempre.
Las guías apuntan a la pantalla
Cada paso puede declarar su pantalla de destino, y eso es lo que habilita el botón que lleva al usuario exactamente allí. Es la diferencia entre explicar y acompañar.
Búsqueda que entiende cómo escribe la gente
Combina tres cosas: coincidencia de términos y de sus raíces —así «ficho» encuentra «fichaje» y «olvido» encuentra «olvidado»—, tolerancia a erratas por similitud de trigramas («fichge» también llega) y peso del título, para que el artículo que se llama como tu problema gane al que solo lo menciona de pasada. Si además hay proveedor de embeddings, se suma la búsqueda semántica con pgvector.
Incidencias conocidas y novedades
/soporte/incidentes · /soporte/novedadesCuando algo se rompe para muchos, se publica una incidencia conocida: aparece en el widget de todos y evita decenas de tickets idénticos. Las novedades avisan de lo nuevo que afecta al usuario.
Convierte soluciones en artículos
05 · Alta
Abrir un ticket que ya viene relleno
Cuéntale el problema al asistente primero
Si el asistente lo resuelve, no hay ticket: es el mejor resultado posible. Si no, ofrece un botón para abrirlo con toda la conversación ya adjunta como contexto.
Asunto y descripción
/soporte/tickets/nuevoEl asunto en una línea; la descripción, con lo que esperabas y lo que pasó. No hace falta que sea perfecto: el triaje lo clasifica y un agente lo reescribe si conviene.
Impacto y urgencia
Dos preguntas sencillas: a cuánta gente afecta (impacto) y cuánto corre prisa (urgencia). La prioridad la calcula la matriz a partir de esas dos respuestas, nunca la elige el usuario ni la inventa el modelo.
/soporte/tickets/nuevo → Prioridad calculada| Impacto \ Urgencia | Baja | Media | Alta | Crítica |
|---|---|---|---|---|
| Crítico | P3 | P2 | P1 | P1 |
| Alto | P3 | P3 | P2 | P1 |
| Medio | P4 | P3 | P3 | P2 |
| Bajo | P4 | P4 | P4 | P3 |
Adjunta la captura y el contexto técnico
El formulario ya trae la pantalla, el módulo y los errores de consola. Añade la captura con la pestaña de adjuntos o directamente desde el widget.
Enviar
El ticket recibe su número, entra en la cola y dispara el triaje automático: categoría, prioridad, etiquetas y un resumen para el agente. Todo eso es editable por la persona que lo atienda.
Varios canales, un mismo motor
06 · Gestión
Cola, triaje y reparto entre agentes
La cola de trabajo
/soporte/colaTodo lo que no está cerrado ni esperando al cliente, ordenado por lo que corre más prisa. Filtra por equipo, cola, prioridad, categoría o agente. El reparto automático asigna por carga real (tickets abiertos frente a capacidad), no a ciegas.
Ficha del ticket
/soporte/tickets/<id>A la izquierda, toda la conversación con sus adjuntos y su cronología. A la derecha, los datos: estado, prioridad, categoría, agente, participantes y relaciones con otros tickets.
Derivar a otro agente o a otro nivel
Derivar exige motivo y deja el traspaso estructurado: qué has comprobado, qué has descartado y qué queda por hacer. Sin eso, el ticket rebota y el cliente lo nota.
Notas internas frente a respuestas
La nota interna solo la ve el equipo; la respuesta la ve el cliente. La distinción está en el servidor: el cliente nunca recibe una nota interna, ni siquiera por error.
Varios tickets iguales
Si el mismo síntoma llega veinte veces, agrúpalos en una incidencia y contéstalos de una vez. Los tickets relacionados y los duplicados mantienen su trazabilidad individual.
Responde con macros
/soporte/configuracion/macrosRespuestas tipo con variables (número de ticket, nombre del cliente, nombre del agente…). Las que no se puedan resolver se avisan en el propio listado: preferimos que se vean a enviar un hueco en blanco.
Las derivaciones no son un botón de escape
07 · IA
La IA: qué hace, qué no hace y cómo se lo dices
Seis operaciones concretas, tres límites que no se negocian y un modo degradado que no miente.
| Operación | Qué hace | ¿Escribe? |
|---|---|---|
| Asistente | Conversa y resuelve dudas antes del ticket | No |
| Triaje | Clasifica categoría, prioridad, etiquetas y resumen | Sí, editable |
| Borrador | Redacta una respuesta para el agente | No, la envía la persona |
| Resumen | Resume el hilo para traspaso o informe | No |
| Análisis de captura | Transcribe y diagnostica una captura | Sí, en el adjunto |
| Artículo desde ticket | Propone un artículo de conocimiento | No, nace en borrador |
Los tres invariantes
Sin proveedor de IA configurado, el módulo lo dice
No se simula una respuesta de IA ni se deja la burbuja en blanco: el asistente avisa de que no hay proveedor y responde con lo que sí ha encontrado en la base de conocimiento, artículo por artículo. Ojo al detalle: tener un modelo configurado no basta si falta la clave de API — el módulo lo comprueba antes de prometer un asistente que no podría contestar, y lo publica en /api/health como iaCredencial.
Modo «solo metadatos»
Con SOPORTE_IA_ENVIAR_CUERPO=0, el texto de los tickets no sale de la instalación: el asistente trabaja con la base de conocimiento y los datos de contexto. Para sectores con datos sensibles.
Las capturas no se envían solas
Solo se mandan al proveedor si alguien lo pide expresamente para una captura concreta, y queda registrado en el historial de IA.
Todo queda registrado y corregible
Cada llamada deja fila con la acción, el modelo, la versión del prompt, los tokens, la latencia y las fuentes citadas. Cada vez que un humano corrige el triaje, queda la medida real de acierto.
08 · Compromisos
SLA en tiempo hábil y calendario
Un SLA que se incumple solo porque era fin de semana no significa nada. Aquí se mide en horas de trabajo y se para cuando el balón no está en tu tejado.
/soporte/configuracion/sla → Calendario laboralFranjas
Objetivos por prioridad
P1
1ª resp. 30 min
siguiente 1 h
resolución 4 h
P2
1ª resp. 2 h
siguiente 4 h
resolución 1 día
P3
1ª resp. 8 h
siguiente 8 h
resolución 1 día
P4
1ª resp. 1 día
siguiente 1 día
resolución 2 días
Tres objetivos por ticket
Primera respuesta, siguiente respuesta y resolución. Se cumplen por separado: un ticket puede responder rápido y tardar en resolverse, y eso hay que poder verlo.
El reloj se para cuando el balón no está en tu tejado
En esperando al cliente, esperando a un tercero y en propuesta de solución, el tiempo no corre. Si no, el SLA castigaría al equipo por la lentitud del cliente.
Avisos al 50, 75 y 100 %, una sola vez
Cada umbral avisa una única vez y escala al nivel que diga la política. No hay tormenta de correos repitiendo lo mismo cada cinco minutos.
Festivos y zona horaria
El calendario trabaja con zona horaria IANA y con los festivos que tú cargues. Un P1 abierto el viernes a las 17:50 con objetivo de 30 minutos vence el lunes a las 09:20, no el viernes a las 18:20.
09 · Desenlace
Solución, cierre por el cliente y reapertura
El ciclo no termina cuando el agente cree que ha terminado: termina cuando el cliente lo confirma.
/soporte/tickets/<id> → Propuesta de soluciónEl agente propone la solución
Propuesta significa: «esto es lo que había y esto es lo que hice». Al pasar a propuesta, el reloj del SLA se detiene y el cliente recibe el aviso.
El cliente la valida… o no
El cliente puede dar la solución por buena, responder que no funcionó, o simplemente cerrar el ticket. Cualquiera de las tres cosas es información útil, y las tres quedan registradas.
El cliente cierra
El cierre por el cliente es el camino principal y queda marcado como tal: en los informes se distingue del cierre por el equipo, y esa diferencia es la mejor medida de si el soporte sirve.
Reapertura con ventana
Dentro de los días configurados (14 por defecto), el cliente puede reabrir el mismo ticket conservando todo el contexto. Fuera de esa ventana, solo supervisores y administradores, y con motivo escrito.
Encuesta de satisfacción
/soporte/encuesta/<empresa>/<token>Tras el cierre se envía una encuesta breve con la pregunta que hayas configurado. La respuesta alimenta los informes sin molestar a quien ya está contento.
10 · Cliente externo
Portal del cliente externo
Tu cliente no va a crearse una cuenta para reportar un problema. Recibe un enlace, y ese enlace se puede revocar.
Crea el acceso
/soporte/portalNombre, correo, PIN opcional, permisos y caducidad. Si lo dejas sin PIN, el enlace por sí solo da acceso: úsalo solo cuando el correo sea de confianza.
Envía el enlace
El token se guarda en claro precisamente para que puedas reenviarlo cuando el cliente pierda el correo. No es un descuido: es la función.
El cliente puede responder, cerrar, reabrir y valorar
Y ver sus propios tickets. Nunca ve notas internas ni toca prioridad, categoría, asignación o estado interno: la restricción está en el servidor, no en la interfaz.
Revocar corta el acceso al instante
El acceso se revalida en cada petición, así que revocar invalida todas las sesiones abiertas sin esperar a que caduque el token.
404, no 403
11 · Automatización
Base de conocimiento y automatizaciones
Reglas: condición → acciones
/soporte/configuracion/reglasSe evalúan en orden, en cascada, y cada aplicación queda registrada. Admite una prueba en seco contra un ticket real: evalúa la regla y te dice qué haría, sin tocar nada.
Respuestas tipo con variables
/soporte/configuracion/macrosPlantillas con número de ticket, nombre del cliente y del agente. Las variables que no se puedan resolver se avisan antes de enviar.
Indexado del conocimiento
El módulo indexa cada 15 minutos los artículos publicados cuyo texto ha cambiado. Publicar indexa; despublicar desindexa. Si no hay proveedor de embeddings, la búsqueda sigue funcionando en modo léxico.
Informes
/soporte/informesVolumen y evolución, cumplimiento de SLA por prioridad y por agente, tiempo hasta la primera respuesta, reaperturas, satisfacción y los tickets que más se repiten. Es la lista de la compra de la próxima mejora.
Auditoría
/soporte/auditoriaQuién cambió qué configuración y cuándo, y la verificación de la cadena de integridad de cada ticket. Si algo no cuadra, se señala en rojo el eslabón exacto.
12 · Integración
API pública e integración
Para que otros sistemas abran y consulten tickets sin pasar por la interfaz.
Crea una clave
/soporte/configuracion/apiLa clave se muestra una sola vez. Empieza por sup_test_ para probar sin miedo, y usa sup_live_ en producción. Cada clave lleva sus permisos (leer tickets, escribir tickets, escribir mensajes, ver consumo).
Operaciones disponibles
/api/soporte/v1Listar y crear tickets, consultar y modificar un ticket, añadir mensajes y consultar el consumo. La descripción OpenAPI 3.1 está en /api/soporte/v1/openapi.
Dos detalles que ahorran disgustos
Idempotencia con la cabecera Idempotency-Key (24 horas): si tu sistema reintenta, no se duplica el ticket. Y paginación por cursor con has_more y next, para recorrer listados largos sin perder filas.
Desde otros módulos del hub
/api/internal/soporte/ticketsUn módulo puede abrir un ticket con x-internal-key y una referenciaExterna. Con dedupe activo, un worker que reintenta cada cinco minutos no genera 288 tickets al día.
Webhooks firmados
Los eventos salen firmados con HMAC usando el secreto del endpoint y se reintentan con backoff. Por seguridad, los destinos internos están bloqueados salvo que se habiliten expresamente.
La API no se salta las reglas
13 · Confianza
Trazabilidad, retención y confianza
Un ticket puede acabar siendo prueba de que algo se hizo, se avisó o se resolvió. Por eso el historial no se puede editar.
Timeline del ticket
Lo que ves en la ficha: legible, con autor y hora, encadenado con el evento anterior del mismo ticket.
Cadena global
Los hitos de todos los tickets, verificables de un tirón. Detecta cualquier manipulación.
Auditoría
Quién tocó la configuración, cuándo y qué cambió. Separada del timeline para no mezclar.
Retención y anonimización
/soporte/configuracionPasado el plazo (3 años por defecto, nunca menos de 1), se destruyen los datos personales y se conserva la estadística y la prueba de que el hecho existió. El RGPD exige destruir los datos, no la prueba.
Legal hold
Si hay una reclamación o una inspección en marcha, se marca el ticket o el adjunto concreto y la purga se detiene mientras dure. Todo queda registrado.
Adjuntos verificados
Cada fichero guarda su hash. Si el contenido no cuadra con lo que se subió, se rechaza en lugar de servirse: preferimos un error visible a servir algo manipulado.
14 · Ayuda
Problemas frecuentes
El botón de soporte no aparece en ninguna pantalla+
El widget se apaga solo si no hay sesión de empresa. Entra desde OhMyDat con el botón Conectar y comprueba que la contratación del módulo está activa. En las páginas públicas no aparece a propósito.
El asistente dice que no hay proveedor de inteligencia artificial+
Significa exactamente eso: no hay un proveedor de IA configurado en tu instalación. El módulo no lo disimula. Puedes seguir usando la base de conocimiento, que funciona igual, y configurar el proveedor cuando lo tengas.
La IA me dijo algo que no es cierto+
Marca la respuesta como incorrecta en el propio chat: queda registrado y es la señal que usamos para mejorar. El asistente no ejecuta acciones ni envía nada por su cuenta, así que una respuesta equivocada nunca cambia datos.
He perdido el enlace del portal de un cliente+
Entra en Portal del cliente y reenvíalo: por eso el token se guarda en claro. Si sospechas que se ha filtrado, revócalo y crea uno nuevo: la revocación corta el acceso al instante.
Un ticket no vence aunque lleve días parado+
Es lo esperado si está esperando al cliente, esperando a un tercero o en propuesta: en esos estados el reloj del SLA se para. Si crees que está mal clasificado, cambia el estado desde la ficha.
Mi cliente dice que no ve la respuesta+
Comprueba que la escribiste como respuesta y no como nota interna: la nota interna solo la ve el equipo, por diseño y también por seguridad. Si fue un error, reenvíala como respuesta.
La búsqueda no encuentra un artículo que sé que existe+
Revisa que esté publicado y que su visibilidad coincida con quién busca (los internos no salen en el widget del cliente). Si acabas de publicarlo, el indexado tarda como máximo 15 minutos.
¿Puedo cerrar un ticket yo, si soy el solicitante?+
Sí. De hecho es el camino preferido: un ticket cerrado por quien lo abrió es la mejor señal de que la solución sirvió. Y puedes reabrirlo dentro de la ventana configurada conservando todo el contexto.
¿Vienes del hub? Repasa el Manual de OhMyDat para crear empresas y contratar productos. El detalle técnico y de operación está en docs/soporte-manual.md. ¿Necesitas ayuda? Escríbenos desde Contacto.