Mensajes de error bien elaborados ayudan a los usuarios a entender qué falló y cómo solucionarlo, reduciendo la frustración y las solicitudes de soporte. Esta guía establece estándares para escribir mensajes de error claros, consistentes y empáticos a lo largo de la interfaz.
Principios fundamentales
| Principio | Qué significa |
|---|---|
| Claridad | Utiliza un lenguaje sencillo y cotidiano. Evita la jerga y las descripciones vagas. |
| Capacidad de acción | Dile al usuario exactamente qué hacer a continuación. Si no hace falta ninguna acción, díselo. |
| Empatía | Nunca culpes al usuario. Usa una expresión neutra y de apoyo. |
| Consistencia | Utiliza el mismo tono, estructura y terminología en todos los mensajes (por ejemplo, no mezcles "error de servidor" y "error de sistema" para el mismo problema). |
| Brevedad | Sé breve — suficiente contexto para ser útil, nada más. |
| Accesibilidad | Sigue las directrices de WCAG para que los mensajes sean comprensibles para usuarios de todas las capacidades. |
Anatomía de un mensaje de error
Cada mensaje de error debería responder hasta tres preguntas:
- ¿Qué ha pasado? Exponga el problema claramente.
- ¿Por qué ocurrió? (opcional) Añade una breve razón si ayuda al usuario a entender.
- ¿Qué debería hacer el usuario a continuación? Da una acción o un punto concreto para ayudar más.
Estructura:
| Componente | Ejemplo |
|---|---|
| Cabecera | "No se puede procesar la solicitud" |
| Descripción | "Tuvimos un problema mientras procesamos su solicitud. Por favor, inténtalo de nuevo." |
| Acción/Ayuda | "Si el problema persiste, contacta con el soporte en support@document360.com." |
Directrices de escritura
| Directriz | ✅ Do | ❌ No |
|---|---|---|
| Utiliza lenguaje claro | "El tamaño del archivo supera el límite permitido." | "Fallido en la subida del archivo por limitaciones de tamaño." |
| Sé específico | "Dirección de correo electrónico inválida. Por favor, introduzca un formato válido (por ejemplo, name@domain.com)." | "Error de entrada." |
| Aportar una solución | "El nombre de usuario ya está tomado. Prueba con otro nombre de usuario." | "Este nombre de usuario no está disponible." |
| Evita la jerga técnica | "No pudimos conectarnos al servidor. Comprueba tu conexión a internet e inténtalo de nuevo." | "Error del servidor 503 detectado." |
| Utiliza un lenguaje educado y positivo | "Algo salió mal. Por favor, inténtalo de nuevo en unos minutos." | "¡Error! Inténtalo de nuevo." |
| Alinearse con el contexto | "No pudimos salvar eso. Por favor, inténtalo de nuevo." | "¡Error de guardado! ¡Acción bloqueada!" |
| Usa la voz activa | "No pudimos encontrar el artículo solicitado." | "El artículo solicitado no fue encontrado." |
| Evita las palabras negativas | "No pudimos completar tu petición." | "No he procesado tu solicitud." |
Códigos de error: Inclúyelos solo para errores complejos o técnicos que ayuden a la resolución de problemas.
Ejemplo: "La solicitud no pudo procesarse (Código de error: 403). Contacta con el soporte para recibir ayuda."
Escenarios de error comunes
| Escenario | Mensaje de error |
|---|---|
| Entrada inválida | "Contraseña inválida. La contraseña debe tener al menos 8 caracteres e incluir un número." |
| Campo requerido faltante | "Se requiere dirección de correo electrónico. Por favor, introduzca su correo electrónico para continuar." |
| Tiempo de espera del servidor | "Estamos teniendo problemas para conectarnos al servidor. Por favor, inténtalo de nuevo más tarde." |
| Error de subida de archivos | "Fallido la subida del archivo. Asegúrate de que el archivo tenga menos de 5 MB y esté en un formato compatible." |
| Acceso denegado | "No tienes permiso para ver esta página. Contacta con tu administrador." |
| Incumplimiento de pago | "El pago no pudo ser procesado. Revisa los datos de tu tarjeta o prueba otro método." |
| Entrada duplicada | "Este nombre de categoría ya existe. Por favor, elige otro nombre." |
| Sesión finalizada | "Tu sesión ha expirado. Por favor, inicia sesión de nuevo para continuar." |
Lista de verificación previa a la publicación
- ¿El mensaje es claro y conciso?
- ¿Explica eso qué salió mal?
- ¿Ofrece un siguiente paso concreto?
- ¿Está libre de jerga técnica?
- ¿El tono es educado y profesional?
- ¿Es coherente con otros mensajes de error del producto?
Mantenimiento
Revisa periódicamente todos los mensajes de error a medida que evolucionan las características del producto y actualízalos con rapidez para evitar directrices desactualizadas o confusas.