Plantilla de reporte de bugs de soporte a producto, con su matriz de escalado
El formulario que rellena soporte para pasar un fallo a producto y que desarrollo lo reproduzca a la primera, con los criterios de prioridad, la matriz de a quién se escala cada nivel y lo que se le dice al cliente mientras. Se descarga en Word y en PDF, y se puede copiar desde esta página.
Diez apartados que soporte rellena en cinco minutos y que ahorran a desarrollo la primera hora. Se sustituye lo que va entre corchetes y se pega en el gestor de incidencias del equipo.
Incluye
Diez apartados, matriz y seis mensajes
Formatos
Word, PDF y texto para copiar
Para quién
Soporte, producto y desarrollo
Sirve con
Jira, Linear, GitHub, Asana o un documento
En resumen
Un reporte de bug sirve cuando desarrollo lo reproduce sin volver a preguntar. Lleva qué pasa, qué debería pasar, los pasos, el contexto y el impacto.
La prioridad la decide el efecto en los clientes y no la insistencia de uno. Tres preguntas bastan. ¿A cuántos afecta? ¿Pueden seguir trabajando? ¿Hay datos o dinero en juego?
La matriz de escalado deja decidido de antemano quién recibe cada nivel, por dónde y en cuánto tiempo responde.
Al cliente se le confirma el fallo, se le da la alternativa y se le promete un aviso, nunca una fecha.
El fallo se vincula a las conversaciones de todos los clientes que lo sufren, para avisar a cada uno cuando se arregle.
La plantilla es la misma en los dos formatos. Word sirve para adaptarla a los campos del gestor de incidencias de la empresa, y PDF para enseñarla en la reunión de soporte y producto.
Plantilla de reporte de bugs de soporte a producto
Diez apartados con los datos por rellenar entre corchetes y la tabla de prioridades. Gratis, sin pedir correo.
Lo que va entre corchetes se sustituye por los datos del caso. Un reporte por fallo, aunque lo cuenten varios clientes.
01 Título
[Qué falla y dónde, en una línea. «Error al guardar una factura con descuento del 100 %» y no «Problema con facturas».]
02 Qué pasa
[Lo que ocurre, en una o dos frases, con el mensaje de error literal si lo hay.]
03 Qué debería pasar
[El resultado que esperaba el cliente.]
04 Pasos para reproducirlo
[Primer paso, empezando desde una pantalla conocida.]
[Segundo paso, con los datos exactos que se introducen.]
[Tercer paso.]
[Resultado. Se reproduce [siempre, a veces o solo en esta cuenta].]
05 Contexto
Dato
Valor
Cuenta y plan
[Identificador de la cuenta] y [plan]
Usuario y permisos
[Usuario] con el permiso de [permiso]
Navegador o dispositivo
[Navegador y versión] en [sistema]
Versión del producto
[Versión o entorno]
Fecha y hora
[fecha], [hora], hora de [Madrid]
Mensaje de error
[Texto literal o código]
Adjuntos
[Captura, vídeo o fichero de ejemplo]
06 Impacto y alcance
Pregunta
Respuesta
¿A cuántos clientes afecta, que se sepa?
[Número] y [nombres o segmento]
¿Qué no pueden hacer?
[El trabajo que se queda parado]
¿Hay alternativa?
[Sí, cuál] o [No]
¿Hay datos o dinero en juego?
[Sí, cuáles] o [No]
¿Algún cliente afectado tiene SLA o un contrato grande?
[Sí, cuál y qué plazo] o [No]
¿Desde cuándo ocurre?
[fecha, o desde qué versión]
07 Prioridad propuesta
Prioridad propuesta por soporte [Crítica, Alta, Media o Baja], según la tabla. Producto la confirma o la cambia y dice por qué.
Prioridad
Cuándo
Ejemplo en un software de gestión
Crítica
Muchos clientes no pueden usar algo esencial y no hay alternativa, o hay datos o dinero en juego.
Nadie puede iniciar sesión. Se emiten facturas con el importe equivocado.
Alta
Una función clave falla, o un cliente no puede trabajar, y la alternativa es incómoda.
La exportación a contabilidad falla con ciertos datos. Una integración principal no sincroniza.
Media
Algo falla, pero hay una alternativa razonable.
Un filtro no guarda la selección. Un correo de aviso no llega.
Baja
Un detalle que no impide trabajar.
Un texto mal alineado. Una traducción incorrecta.
08 Qué se le ha dicho al cliente
[Lo que ya sabe el cliente. Si se le ha confirmado el fallo, qué alternativa se le ha dado y qué se le ha prometido. Nunca una fecha que producto no haya dado.]
09 Conversaciones
[Enlace a cada conversación de cliente con este fallo. Son las personas a las que hay que avisar cuando se arregle.]
10 Antes de enviar
Soporte lo ha reproducido, o explica por qué no ha podido.
Se ha descartado que sea un problema de configuración o del plan.
Se ha buscado si ya existe un reporte del mismo fallo.
Los pasos empiezan desde una pantalla conocida y llevan los datos exactos.
El impacto dice cuántos clientes y si hay alternativa.
No hay datos personales del cliente en el título ni en la descripción.
Antes de escalar, ¿es un fallo?
«Me sale un error», «no me deja guardar», «desde ayer va fatal». Así llegan a soporte la mayoría de los fallos, y no todos lo son. Este filtro es lo que más tiempo de desarrollo ahorra.
Qué es
Cómo se reconoce
Quién lo resuelve
Un fallo
El producto no hace lo que debería y se reproduce con los mismos pasos.
Producto, con el reporte de esta guía.
Un problema de configuración
El producto funciona, pero la cuenta está mal configurada.
Soporte, en la misma conversación.
Una pregunta que parece un fallo
«No me deja exportar» porque su plan no incluye la exportación.
Soporte. Si se repite, es una petición de producto y no un fallo.
Una caída general
Varios clientes avisan de lo mismo en poco tiempo.
Guardia de desarrollo, y se abre la comunicación de incidencia.
Al cliente se le pide solo lo que falta. Su cuenta, su plan y muchas veces su navegador ya están en la conversación, y preguntárselos le hace sentir que repite trabajo.
Cómo se decide la prioridad
Soporte propone la prioridad con tres preguntas, en este orden, y producto la confirma.
¿A cuántos clientes afecta? Si son muchos o todavía no se sabe, se empieza por crítica y se baja después.
¿Pueden seguir trabajando? Si hay una alternativa razonable, es media como mucho.
¿Hay datos o dinero en juego? Una pérdida de información, un dato a la vista de quien no debe o un cobro erróneo suben siempre un nivel.
Prioridad
Cuándo
Ejemplo en un software de gestión
Crítica
Muchos clientes no pueden usar algo esencial y no hay alternativa, o hay datos o dinero en juego.
Nadie puede iniciar sesión. Se emiten facturas con el importe equivocado.
Alta
Una función clave falla, o un cliente no puede trabajar, y la alternativa es incómoda.
La exportación a contabilidad falla con ciertos datos. Una integración principal no sincroniza.
Media
Algo falla, pero hay una alternativa razonable.
Un filtro no guarda la selección. Un correo de aviso no llega.
Baja
Un detalle que no impide trabajar.
Un texto mal alineado. Una traducción incorrecta.
Los ejemplos de la tabla se cambian por los del propio producto. En un software sanitario, una cita que no se guarda es crítica aunque afecte a una sola clínica. En una fintech, cualquier importe mal calculado lo es. Con un ejemplo propio en cada nivel, dos personas clasifican igual.
La matriz de escalado de incidencias, a quién llega cada nivel
Sin matriz, a quién se avisa depende de quién lee el caso y de lo nervioso que esté. Con ella, la decisión está tomada antes de que ocurra.
Prioridad
A quién se escala
Por dónde
Respuesta de producto
Si no llega
Crítica
Guardia de desarrollo y responsable de soporte
Llamada o aviso de guardia, y el reporte después
15 minutos, a cualquier hora
A la hora, dirección técnica. Se abre la comunicación de incidencia.
Alta
Responsable del área de producto afectada
Reporte en el gestor de incidencias y aviso en el canal del equipo
4 horas laborables
Al día siguiente, responsable de ingeniería.
Media
Cola de fallos del equipo de producto
Reporte en el gestor de incidencias
En la siguiente revisión semanal
Se repasa en la reunión de soporte y producto.
Baja
Cola de fallos del equipo de producto
Reporte en el gestor de incidencias
Sin plazo, con decisión comunicada
Se agrupa con otros del mismo tipo.
Los plazos son un punto de partida para un equipo de software con clientes de empresa, y se ajustan a lo que producto puede cumplir. Lo que la matriz mide es la respuesta de producto a soporte, que es confirmar la prioridad y decir qué va a pasar. El plazo con el cliente lo fija el acuerdo de nivel de servicio, y para eso está la plantilla de SLA de soporte técnico.
Una prioridad crítica es además un problema de comunicación. Los mensajes para cada momento están en el kit de comunicación de incidencias.
Quién hace qué
Quién
Qué hace
Primera línea, una persona o el agente de IA
Recoge lo que falta (qué hacía, desde cuándo, a quién afecta, la captura), propone la prioridad y pasa el caso
Soporte técnico
Reproduce el fallo, busca si hay más casos y rellena el reporte
Desarrollo
Lo arregla. En crítica, con alguien de guardia
Responsable de soporte
Avisa a los clientes afectados y decide cuándo se cierra
El agente de IA resuelve las dudas de uso y, en lo demás, recoge los datos antes de pasar el caso. Lo que no decide solo es que algo no es grave. Si varios clientes avisan de lo mismo en poco tiempo, llega a una persona.
Con un equipo de tres personas
→Crítica. Quien lleva la parte técnica tiene el móvil encendido, también fuera de horario.
→Alta. Quien atiende a los clientes avisa en el canal del equipo y alguien de desarrollo lo coge ese día.
→Media y baja. Se quedan registradas y se repasan en la reunión semanal.
Qué se le dice al cliente mientras
El cliente quiere saber tres cosas. Que no es culpa suya, qué puede hacer mientras y que alguien le avisará. Una fecha de arreglo no está en la lista, porque soporte no la controla.
Pedir el dato que falta
Gracias, [Nombre]. Para poder reproducirlo, ¿qué se estaba intentando guardar cuando apareció el error? Si es posible, una captura de la pantalla con el mensaje ayuda mucho. Con eso el equipo técnico lo encuentra antes.
Confirmar el fallo, con alternativa
Hola, [Nombre].
Lo hemos reproducido. Es un fallo nuestro al [qué falla] y no tiene que ver con la configuración de la cuenta. Ya está en manos del equipo técnico.
Mientras tanto, [la alternativa, paso a paso] y funciona sin problema.
No puedo dar una fecha todavía. Sí puedo decir que escribiré aquí en cuanto esté arreglado, sin que haga falta volver a preguntar.
[Nombre de la persona]
Confirmar el fallo, sin alternativa
Hola, [Nombre].
Lo hemos reproducido. Es un fallo nuestro al [qué falla] y ahora mismo no hay otra forma de hacerlo. Sabemos que deja parado [el trabajo afectado], y por eso el equipo técnico lo tiene con prioridad [alta o crítica].
Escribiré aquí el [día] a las [hora] con el estado, haya novedades o no, y antes si queda resuelto.
[Nombre de la persona]
Seguimiento sin novedades
Hola, [Nombre].
Tal como quedamos, escribo con el estado. El equipo técnico sigue trabajando en [el fallo]. [Lo que se sabe hoy, en una frase.] Todavía no hay fecha.
Volveré a escribir el [día]. Si mientras tanto cambia algo en la cuenta o el fallo aparece en otro sitio, ese dato ayuda.
[Nombre de la persona]
Avisar de que está arreglado
Hola, [Nombre].
Ya está corregido. Desde hoy, [qué funciona ya]. No hace falta hacer nada, y [la alternativa] ya no es necesaria.
Gracias por avisar y por los datos. Si vuelve a aparecer, basta con responder a este mensaje.
[Nombre de la persona]
Explicar que no se va a cambiar
Hola, [Nombre].
El equipo de producto ha revisado [el comportamiento] y ha decidido no cambiarlo, porque [el motivo, en una frase]. Prefiero decirlo claro a dejarlo abierto.
La forma de conseguir [lo que necesita el cliente] es [la alternativa]. Si eso no encaja con la forma de trabajar del equipo, lo vemos juntos en una llamada.
[Nombre de la persona]
Cerrar el círculo
Un fallo, un reporte. Cuando llega otro cliente con lo mismo, su conversación se añade al reporte que ya existe. El recuento de conversaciones es el mejor argumento de prioridad.
La conversación espera, no se cierra. El caso del cliente sigue abierto mientras el fallo está en manos de producto.
Producto dice qué ha decidido. Arreglado, aplazado o no se va a hacer. Las tres respuestas sirven. El silencio no.
Soporte avisa a cada cliente. Cuesta un minuto por conversación y es de los mensajes que más confianza dan.
Una reunión corta cada semana. Soporte y producto repasan los reportes abiertos, los que llevan más conversaciones detrás y los que volvieron por falta de datos.
Un cliente nuevo encuentra fallos que los antiguos ya esquivan. Durante sus primeros meses conviene tratarlos un nivel por encima, y el plan de onboarding de clientes B2B lo recoge entre sus señales.
Cómo lo hace Intake
En Intake, el reporte sale de la conversación. Con Jira, Linear, GitHub o Asana conectados, una persona del equipo pulsa crear incidencia y la IA prepara el borrador, con un título que nombra el fallo y una descripción con qué pasa y cómo reproducirlo, sin nombres, correos ni teléfonos. Esa persona lo revisa antes de crearlo. Al final van el cliente afectado, con su empresa, y el enlace a la conversación.
La incidencia llega al proyecto de Jira, al equipo de Linear, al repositorio de GitHub o al proyecto de Asana elegidos en los ajustes. En Jira y en Linear se eligen responsable, prioridad y etiquetas. En GitHub, responsable y etiquetas, porque no tiene prioridad. En Asana, responsable. El agente de IA no crea incidencias por su cuenta. Las crea siempre una persona.
Cuando otro cliente cuenta el mismo fallo, su conversación se vincula a la incidencia que ya existe pegando su clave o su enlace, y cada conversación enseña las demás que la comparten. La conversación puede esperar a la incidencia, pospuesta y sin cierre automático. Cuando la incidencia se cierra, vuelve a la bandeja y quien la lleva recibe el aviso. Avisar al cliente lo decide el equipo, Intake no le escribe solo.
Un título que nombre el fallo, qué pasa, qué debería pasar, los pasos para reproducirlo, el contexto, que es la cuenta, el navegador, la versión, la hora y el mensaje de error, y el impacto, que es cuántos clientes y si hay alternativa.
¿Cómo se reporta un bug a desarrollo?
Siempre con la misma forma y en el mismo sitio, el gestor de incidencias del equipo. Soporte lo reproduce antes, descarta que sea configuración, busca si ya existe y propone una prioridad con el impacto delante.
¿Quién decide la prioridad de un bug?
Soporte la propone, porque conoce el efecto en los clientes, y producto la confirma o la cambia y dice por qué. La decide el alcance y no la insistencia de un cliente.
¿Qué es una matriz de escalado?
Una tabla que dice, para cada nivel de prioridad, a quién se avisa, por qué canal, en cuánto tiempo responde y qué ocurre si no responde. Cuatro niveles bastan, crítica, alta, media y baja. Deja la decisión tomada antes de que llegue el caso.
¿Se le da al cliente una fecha de arreglo?
Solo si producto la ha dado. Lo habitual es confirmar el fallo, ofrecer la alternativa y prometer un aviso cuando esté arreglado. En una prioridad alta sin alternativa, se promete la fecha del siguiente mensaje.
¿Cómo se evita que un fallo se reporte dos veces?
Buscando antes de crear y vinculando la conversación nueva al reporte que ya existe. Así un fallo tiene un solo reporte con todas sus conversaciones detrás.