Cómo reportar un error a un desarrollador para que lo arregle

Un buen reporte de error le dice al desarrollador exactamente cómo hacer que el problema aparezca en su propia pantalla. Necesita los pasos que seguiste, lo que esperabas, lo que pasó en realidad, dónde pasó (dispositivo, navegador, cuenta, entorno) y alguna evidencia, como un mensaje de error o una captura. Con esas cinco cosas, el desarrollador casi siempre puede ponerse a arreglar en lugar de hacerte preguntas.

En esta guía desarmamos cada parte, te mostramos cómo juntar la evidencia técnica sin ser técnico, te dejamos una plantilla para copiar y repasamos las costumbres que hacen que un error tarde más en resolverse.

¿Por qué importa cómo reportas un error?

Casi todo el tiempo que se dedica a un error se va en reproducirlo, no en arreglarlo. Un mensaje como "el pago no funciona" puede significar muchas cosas: que el botón no responde, que rechazan la tarjeta, que el cobro pasa pero el pedido no aparece. Cada una tiene una causa distinta en una parte distinta del código.

Si el desarrollador tiene que adivinar, prueba lo que no es, te pregunta, espera tu respuesta y pierde un día. Si cobra por hora, ese día lo pagas tú. Un reporte claro convierte una queja vaga en una tarea concreta.

¿Qué debe incluir un reporte de error?

1. Un título específico

Escribe qué falla y dónde. "No se crea el pedido después de un pago exitoso con Stripe" sirve. "¡¡Los pagos no sirven!!" no.

2. Pasos para reproducirlo

Numéralos, empezando desde un punto al que cualquiera pueda llegar:

1. Entra con un usuario del plan gratuito.
2. Ve a Configuración y luego a Facturación.
3. Haz clic en "Mejorar plan" y paga con una tarjeta de prueba.
4. Vuelves al panel principal.

Después repite tú los pasos. Si el error no pasa siempre, di con qué frecuencia ("más o menos una de cada tres veces").

3. Resultado esperado y resultado real

• Esperado: el panel muestra la insignia Pro y los nuevos límites.
• Real: el panel sigue mostrando el plan gratuito. Al recargar diez minutos después, sigue igual.

4. Dónde pasó

El entorno (sitio en vivo, vista previa, staging), el dispositivo, el sistema operativo, el navegador y su versión, y la cuenta que usaste. "Sitio en vivo, iPhone, Safari, cuenta prueba2@tudominio.com" se escribe en diez segundos.

5. Cuándo pasó

Fecha y hora, con tu zona horaria. Así el desarrollador encuentra la línea exacta en los registros del servidor.

6. Evidencia

Una captura de pantalla, una grabación corta o, mejor todavía, los datos técnicos que explicamos abajo.

7. Impacto

A cuántos usuarios afecta, si hay dinero o datos de por medio y si existe una forma de esquivarlo. Esto define la prioridad.

¿Cómo sacas los datos técnicos?

Tu navegador ya guarda la información que el desarrollador necesita. En Chrome, Edge o Firefox en una computadora, las herramientas para desarrolladores se abren con F12 (o Cmd+Option+I en Mac). La documentación de Chrome DevTools explica cada panel con detalle.

La pestaña Console

1. Abre las herramientas para desarrolladores y haz clic en Console.
2. Repite los pasos que provocan el error.
3. Busca los mensajes en rojo. Copia el primero como texto (clic derecho, copiar) o haz una captura que muestre el mensaje completo.

El primer error suele ser la causa. Los siguientes muchas veces son consecuencias.

La pestaña Network

1. Haz clic en Network y repite los pasos.
2. Busca filas en rojo o con un estado de 400 o más.
3. Haz clic en la fila y anota su nombre, el código de estado y el texto de la respuesta.

Un 401 o 403 apunta al inicio de sesión o a los permisos, un 404 a una ruta que no existe, un 500 a un error del servidor. Nuestra guía sobre qué hacer si tu app de Lovable o Bolt dejó de funcionar explica qué suelen significar estos códigos, y la de monitoreo y errores en producción muestra cómo detectarlos antes de que te los reporte un usuario.

En el teléfono

En el propio teléfono no tienes herramientas para desarrolladores, así que lo mejor es una grabación de pantalla. Tanto iOS como Android traen una grabadora integrada. Que sea corta y empiece justo antes del problema.

¿Hay una plantilla que pueda copiar?

Título: [qué falla] en [pantalla o función]

Pasos para reproducirlo:
1.
2.
3.

Esperado:
Real:

Entorno: en vivo / staging / vista previa
Dispositivo y navegador:
Cuenta usada:
Fecha y hora (zona horaria):
Frecuencia: siempre / a veces (cada cuánto)

Evidencia: captura, grabación, error de consola, petición fallida
Impacto: a quién afecta, si hay dinero o datos, forma de esquivarlo

¿Qué errores retrasan el arreglo?

• Varios problemas en un solo mensaje. Reporta cada uno por separado para que se pueda seguir, arreglar y confirmar.
• Describir la solución en vez del problema. "Pon el botón en azul" esconde el porqué. "Los usuarios no ven el botón" deja que el desarrollador encuentre el arreglo correcto.
• Mandar contraseñas. Nunca compartas tu acceso personal. Crea una cuenta de prueba para el desarrollador.
• Solo decir "no funciona". Sin pasos ni lo que viste, el desarrollador arranca de cero.
• Cambiar cosas mientras lo arreglan. Si sigues usando tu herramienta de IA en la misma zona, el error puede moverse o cambiar de forma. Pausa hasta que el arreglo esté listo.

¿Cómo confirmas que quedó arreglado?

Cuando el desarrollador te diga que está listo, repite tus pasos originales en el mismo entorno y dispositivo. Luego prueba lo que está alrededor: si el error era de facturación, intenta también cancelar y bajar de plan. Si vuelve a aparecer, responde en el mismo hilo con lo que viste, para que el historial quede junto.

Respuestas rápidas

¿Y si no logro reproducir el error? Repórtalo igual, con la hora, la cuenta y lo que recuerdes. Muchas veces los registros del servidor completan el resto.

¿Uso una herramienta como Jira o GitHub Issues? Cualquier lugar compartido sirve si mantiene un error por elemento. Para un equipo chico, GitHub Issues o un tablero compartido alcanza.

¿Qué sirve más, capturas o grabaciones? Grabaciones cuando el problema tiene varios pasos. Capturas cuando es un solo valor incorrecto o un mensaje de error.

¿Qué hago con errores que reportó un usuario? Pídele los mismos datos, o reprodúcelo tú primero, antes de pasárselo al desarrollador.

¿Necesitas a alguien que resuelva tu lista de errores?

Si tienes una lista de problemas y nadie que los arregle, nuestros planes de mantenimiento de software cubren arreglos continuos, con una persona que te responde en un día hábil. También puedes pasar el chequeo gratuito de tu app o mandarnos tu reporte.