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`.
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.
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.
/signin
. Para obtener más información, escribe /help
.- 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
.