Cómo escribir mensajes de error prácticos

En esta página, se describen las prácticas recomendadas para escribir mensajes de error prácticos que le indiquen al usuario cómo solucionar el problema para que pueda completar su objetivo.

Cuando un usuario interactúa con una app de Google Chat, encontrarse con mensajes de error puede ser una experiencia frustrante si el error no es práctico. Por ejemplo, el mensaje de error, An error occurred, no es útil porque no explica qué salió mal, cómo puede solucionar el problema el usuario ni cómo puede obtener ayuda. En esta página, se describe cómo estructurar los mensajes de error para que sean útiles para los usuarios. Para ello, se muestran ejemplos prácticos y no prácticos.

Estructura del mensaje de error

Un mensaje de error práctico tiene la siguiente estructura:

  • Qué salió mal Indicar por qué la app de Chat no puede completar una solicitud ayuda al usuario a resolver el problema. Explicar por qué ocurrió un error genera confianza.
  • Cómo puede el usuario avanzar hacia su objetivo. Nunca es suficiente con solo decir qué salió mal. Indícales a los usuarios cómo pueden superar el error y completar su objetivo.
  • Cómo obtener ayuda. Si el usuario sigue teniendo problemas, indícale cómo puede obtener más ayuda. Puede ser un comando /help o un vínculo a la documentación de tu app de Chat.

Ejemplo de mensaje de error: Formato de fecha incorrecto

En este ejemplo, el usuario ingresó una fecha en un formato que la app de Chat no esperaba. Escribieron November 19, 2021, pero la app de Chat espera 2021-11-19.

A continuación, se incluyen una versión del mensaje de error con la que se puede tomar una medida y otra con la que no se puede tomar una medida, con las que responde la app de Chat:

Error con diálogo de acción

Un usuario le pide a la app de Chat que programe una reunión con otra persona. La app de Chat responde con un mensaje de error útil y práctico:

I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.

Ejemplo de mensaje de error que le indica al usuario qué salió mal, cómo proceder y cómo obtener ayuda.

Este mensaje de error es útil por los siguientes motivos:

  • Indica qué salió mal. La app de Chat no reconoce el formato de fecha.
  • Explica cómo corregir el error indicándole al usuario el formato de fecha esperado y proporciona un ejemplo de fecha que ayuda a las personas a comprender qué escribir.
  • Ofrece más ayuda con un comando de barra /help. Si los usuarios siguen teniendo problemas, saben cómo obtener más información.

Error no procesable

Un usuario le pide a la app de Chat que programe una reunión con otra persona. La app de Chat responde con un mensaje de error inútil y que no permite tomar medidas:

Enter the correct date format.

Ejemplo de mensaje de error que no proporciona información útil.

Este mensaje de error no permite realizar ninguna acción por los siguientes motivos:

  • No indica si programó la reunión. Es posible que el usuario dude en reprogramar la reunión o suponga que ya se programó.
  • No le indica al usuario cómo formatear la fecha. En lugar de suponer que los usuarios saben cómo formatear la fecha, debería decir que espera el formato de fecha yyyy-mm-dd.
  • No ofrece más ayuda. Cuando los usuarios se atascan y no saben cómo continuar, es posible que dejen de enviar mensajes a la app de Chat.

Probar

Ahora que sabes cómo escribir errores con diálogo de acción, ¿puedes identificar en la siguiente situación cuál de estos errores tiene diálogo de acción?

Una app de Chat crea eventos de calendario cuando los usuarios le envían mensajes con la palabra clave schedule. Para crear un evento de calendario, la app de Chat requiere la autenticación del usuario. Si un usuario no se autenticó, la app de Chat responderá con un mensaje de error.

¿Qué mensaje de error es práctico?
Antes de programar la reunión, debes acceder a tu cuenta escribiendo /signin. Para obtener más información, escribe /help.
Este mensaje de error es útil porque indica lo siguiente:
  • Qué salió mal La app de Chat requiere autenticación.
  • Cómo proceder Escribe /signin para autenticarte.
  • Cómo obtener ayuda Si el usuario quiere más información, puede escribir /help.
Debes autenticarte.
Este mensaje de error no permite realizar ninguna acción porque no indica cómo autenticarse.
Accede.
Este mensaje de error no permite tomar medidas porque no indica cómo acceder y da a entender que el usuario salió de su cuenta en lugar de decirlo claramente, lo que genera confusión.
No se puede programar la reunión.
Este mensaje de error no permite tomar medidas porque no le indica al usuario por qué no se puede programar la reunión ni cómo puede proceder. No se brinda ayuda.