Saltar al contenido

Cómo escribir mensajes de error que no generen tickets de soporte (con antes y después)

«Ha ocurrido un error. Inténtalo de nuevo más tarde.» Cada mensaje así es un ticket esperando a llegar. Qué tiene que decir un buen mensaje de error, ocho ejemplos de antes y después de un SaaS, cómo encontrar los mensajes que más preguntas generan y cómo trabajar con soporte para arreglarlos.

Adrià Castany 9 min

En esta página
  1. ¿Cómo es un buen mensaje de error?
  2. Qué tiene que decir
  3. Ocho ejemplos de antes y después
  4. Reglas que se repiten
  5. Encontrar los que más tickets generan
  6. El código de referencia
  7. Preguntas frecuentes
  8. Para seguir
Señal de advertencia con un signo de exclamación
Así contesta el agente de IA de Intake con la documentación de cada empresa

Una de las fuentes de tickets más subestimadas de un SaaS está en el propio producto: los mensajes de error. «Algo ha salido mal.» «Error 500.» «No se ha podido completar la operación.» El usuario no sabe qué ha pasado, si es culpa suya ni qué hacer. Así que hace lo único que puede: escribir a soporte.

Y en soporte la conversación empieza siempre igual: «¿Qué estabas haciendo? ¿Qué mensaje te sale? ¿Me mandas una captura?». Un mensaje de error bien escrito evita la mitad de esos casos, y la otra mitad llega con la información que hace falta.

¿Cómo es un buen mensaje de error?

Dice qué ha pasado con las palabras del usuario, por qué (si se sabe) y qué puede hacer ahora para resolverlo. No usa jerga técnica ni culpa a nadie, aparece junto al problema y, si el usuario no puede resolverlo solo, le da un código o una referencia para que soporte lo encuentre al momento. Para saber qué mensajes generan más tickets, mira qué errores mencionan los clientes en las conversaciones de soporte.

Qué tiene que decir

PartePregunta que respondeEjemplo
Qué ha pasado¿Qué ha fallado?No hemos podido importar el archivo
Por qué¿Es culpa mía? ¿Por qué?La columna «Email» está vacía en 12 filas
Qué hacer¿Cómo lo arreglo?Complétala o elimina esas filas y vuelve a subirlo
Referencia (si hace falta)¿Cómo pido ayuda?Si sigue fallando, escríbenos con el código IMP-204

No todos los mensajes necesitan las cuatro partes, pero ninguno debería quedarse en la primera.

Ocho ejemplos de antes y después

1. Importación de datos

  • Antes: Error al procesar el archivo.
  • Después: No hemos podido importar el archivo: 12 filas no tienen email. Complétalas o elimínalas y vuelve a subirlo. [Ver las filas]

2. Límite del plan

  • Antes: Has alcanzado el límite.
  • Después: Tu plan incluye 3 proyectos y ya tienes 3. Para crear otro, archiva uno o pasa al plan Pro.

3. Permisos

  • Antes: Acceso denegado.
  • Después: Solo los administradores pueden cambiar la facturación. Pídeselo a Laura García, que es la administradora de tu cuenta.

4. Contraseña

  • Antes: Contraseña no válida.
  • Después: La contraseña necesita al menos 8 caracteres y un número.

5. Pago

  • Antes: Error en el pago.
  • Después: Tu banco ha rechazado la tarjeta. Prueba con otra o pregunta a tu banco si tiene algún límite. No se ha hecho ningún cargo.

6. Integración

  • Antes: Error de conexión con el servicio externo.
  • Después: Hemos perdido la conexión con tu calendario. Suele pasar al cambiar la contraseña de la cuenta de Google. [Volver a conectar]

7. Error del servidor

  • Antes: Error 500.
  • Después: Algo ha fallado por nuestra parte. Tus cambios están guardados. Vuelve a intentarlo en un momento; si sigue pasando, escríbenos con el código SRV-7F3A.

8. Formulario

  • Antes: Hay errores en el formulario.
  • Después: Revisa el campo «CIF»: falta una letra al final. (Y el mensaje, junto al campo y no arriba del todo.)
Intake con los casos reales de la empresa, en una demo de 15 minutos

Reglas que se repiten

  • Sin jerga: «timeout», «excepción» o «payload» no significan nada para el usuario.
  • Sin culpas: «Has introducido un dato incorrecto» suena a reproche; «falta la letra final del CIF» ayuda.
  • Concreto: «12 filas no tienen email» se puede arreglar; «datos no válidos», no.
  • Junto al problema: el mensaje al lado del campo que falla, no en una alerta genérica.
  • Con una acción: un botón o un enlace que lleve al siguiente paso.
  • Tranquilizar cuando hace falta: «No se ha hecho ningún cargo», «tus cambios están guardados».

Encontrar los que más tickets generan

No hace falta revisar todos los mensajes del producto. Empieza por los que llegan a soporte:

  1. Busca en las conversaciones frases como «me sale un error», «no me deja» o «dice que».
  2. Agrupa por mensaje o por pantalla: unos pocos suelen acumular la mayoría.
  3. Reescribe esos primero y mide si bajan las conversaciones sobre ellos.

Si tu herramienta de soporte clasifica de qué va cada conversación, vas mucho más rápido. Más sobre este método en cómo reducir los tickets repetidos.

El código de referencia

En los errores que el usuario no puede resolver solo, un código corto en el mensaje cambia la conversación con soporte:

  • Sin código: «Me sale un error al guardar.» Hacen falta cinco preguntas para saber cuál.
  • Con código: «Me sale SRV-7F3A.» Soporte lo busca en los registros y sabe qué pasó.

Si además atiende un agente de IA, puede tener documentado qué significa cada código y qué hacer, y responder al momento. Cómo recoger el resto de la información cuando sí es un fallo lo contamos en reportes de bugs útiles.

Preguntas frecuentes

¿Qué debe incluir un mensaje de error?

Qué ha pasado con las palabras del usuario, por qué (si se sabe), qué puede hacer para resolverlo y, si no puede solo, una referencia para pedir ayuda.

¿Cómo reduce tickets un buen mensaje de error?

Resuelve en el momento lo que el usuario puede arreglar solo, y da a soporte la información necesaria cuando no puede.

¿Hay que mostrar el código de error técnico?

Un código corto de referencia, sí, para que soporte lo encuentre. El detalle técnico completo no ayuda al usuario.

¿Quién escribe los mensajes de error?

Lo ideal es que producto o diseño, con soporte aportando qué mensajes generan más preguntas y qué dudas tienen los clientes.

¿Por dónde empiezo?

Por los mensajes que más aparecen en las conversaciones de soporte. Unos pocos suelen concentrar la mayoría de los tickets.

Para seguir

Siguiente pasoGuías para pasar a la prácticaPlantillas, listas y calculadoras para usar hoy, con cada dato explicado.

Las novedades, por correo

RSS

Solo las novedades, con la baja en cada correo. Más detalle en la política de privacidad.

De perseguir conversaciones a cuidar a cada cliente

15 minutos, sin compromiso