Saltar al contenido

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.

Adrià Castany 10 min

Ilustración de una lupa de latón y una caja de herramientas de relojero abierta sobre un banco de madera en un prado al atardecer

¿Qué lleva un buen reporte de bug?

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.
En esta página
  1. Descargar la plantilla
  2. La plantilla de reporte de bugs, para copiar
  3. Antes de escalar, ¿es un fallo?
  4. Cómo se decide la prioridad
  5. La matriz de escalado de incidencias, a quién llega cada nivel
  6. Qué se le dice al cliente mientras
  7. Cerrar el círculo
  8. Cómo lo hace Intake
  9. Preguntas frecuentes

Descargar la plantilla

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.

Word, 13 KB. PDF, 194 KB

La plantilla de reporte de bugs, para copiar

  1. Página 1 de 3 de «Reporte de fallo de soporte a producto»
  2. Página 2 de 3 de «Reporte de fallo de soporte a producto»
Ver como texto

Reporte de fallo de soporte a producto

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

DatoValor
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

PreguntaRespuesta
¿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é.

PrioridadCuándoEjemplo en un software de gestión
CríticaMuchos 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.
AltaUna 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.
MediaAlgo falla, pero hay una alternativa razonable.Un filtro no guarda la selección. Un correo de aviso no llega.
BajaUn 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é esCómo se reconoceQuién lo resuelve
Un falloEl 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ónEl 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 generalVarios 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.

  1. ¿A cuántos clientes afecta? Si son muchos o todavía no se sabe, se empieza por crítica y se baja después.
  2. ¿Pueden seguir trabajando? Si hay una alternativa razonable, es media como mucho.
  3. ¿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.
PrioridadCuándoEjemplo en un software de gestión
CríticaMuchos 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.
AltaUna 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.
MediaAlgo falla, pero hay una alternativa razonable.Un filtro no guarda la selección. Un correo de aviso no llega.
BajaUn 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.

PrioridadA quién se escalaPor dóndeRespuesta de productoSi no llega
CríticaGuardia de desarrollo y responsable de soporteLlamada o aviso de guardia, y el reporte después15 minutos, a cualquier horaA la hora, dirección técnica. Se abre la comunicación de incidencia.
AltaResponsable del área de producto afectadaReporte en el gestor de incidencias y aviso en el canal del equipo4 horas laborablesAl día siguiente, responsable de ingeniería.
MediaCola de fallos del equipo de productoReporte en el gestor de incidenciasEn la siguiente revisión semanalSe repasa en la reunión de soporte y producto.
BajaCola de fallos del equipo de productoReporte en el gestor de incidenciasSin plazo, con decisión comunicadaSe 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énQué hace
Primera línea, una persona o el agente de IARecoge lo que falta (qué hacía, desde cuándo, a quién afecta, la captura), propone la prioridad y pasa el caso
Soporte técnicoReproduce el fallo, busca si hay más casos y rellena el reporte
DesarrolloLo arregla. En crítica, con alguien de guardia
Responsable de soporteAvisa 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

  1. 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.
  2. La conversación espera, no se cierra. El caso del cliente sigue abierto mientras el fallo está en manos de producto.
  3. Producto dice qué ha decidido. Arreglado, aplazado o no se va a hacer. Las tres respuestas sirven. El silencio no.
  4. Soporte avisa a cada cliente. Cuesta un minuto por conversación y es de los mensajes que más confianza dan.
  5. 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.

Ver una conversación convertida en incidencia en el gestor que usa el equipo. Reservar una demo

Preguntas frecuentes

¿Qué debe incluir un reporte de bug?

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.

Guías

Sigue leyendo

Ver todas las guías

Intake

Cómo lo resuelve Intake

Cada cliente, atendido como si fuera el único

15 minutos, sin compromiso