La página Issues es donde tu equipo sigue lo que hay que mejorar en el bot. Señalas una respuesta del bot desde una conversación y luego la sigues en un tablero hasta que se corrige: quién se encarga, qué urgencia tiene, qué se ha dicho sobre ella. La encuentras en Improve › Issues.
Crear una Issue
Crear una Issue desde una conversación real es la forma más eficaz de mejorar tu bot, porque partes de un problema que un usuario ha encontrado de verdad.
En Conversations, abre una conversación y selecciona el mensaje del bot que ha fallado.
Haz clic en Create issue.
En What is the problem?, da a la Issue un título corto (por ejemplo Respuesta incorrecta sobre precios).
Si quieres, añade una Description, una Category y una prioridad. La descripción se publica como primer comentario de la Issue.
La nueva Issue aparece en To do. Si no has elegido Category, va a Unclassified issues.
Sigue tus Issues en el tablero
La página se abre en un tablero Kanban con una columna por estado:
To do: nadie ha empezado todavía
In progress: alguien se está encargando
Done: corregida. La columna muestra las Issues cerradas en los últimos 7 días; las más antiguas siguen accesibles desde la pestaña All
Archived: las Issues que ya no necesitas ver. La columna queda plegada hasta que haces clic en ella. Solo los administradores y los managers pueden archivar Issues
En cada columna, las Issues se agrupan por Category. Cada Category conserva su color, en el tablero y en la lista.
Cambiar el estado
Arrastra una tarjeta a otra columna.
O abre la Issue y cambia su Status.
Para actualizar varias Issues a la vez, marca sus casillas y usa Change status en la barra que aparece. Move to las mueve a otra Category.
Encontrar una Issue
Las pestañas de arriba (All, To do, In progress, Done, Archived) muestran un estado a la vez, con el número de Issues de cada uno.
El icono de búsqueda encuentra una Issue por su título.
Filters acota la lista por Priority, Category, Author, Assigned y Date range.
Sort by ordena las Issues por fecha (Newest first, Oldest first), prioridad, estado o autor.
List (arriba a la derecha) muestra las Issues en tablas agrupadas por Category en lugar del tablero.
Trabajar en una Issue
Haz clic en una Issue para abrir su panel de detalle.
Propiedades
En la parte superior del panel, bajo el título y su autor:
Status: To do, In progress, Done o Archived
Priority: High, Medium, Low o None. Indica al equipo qué tratar primero
Category: el grupo al que pertenece la Issue
Assigned to: el compañero que se encarga de la Issue. Se puede asignar a cualquier miembro del bot
Use case: para los administradores del bot, un enlace al Use Case que produjo la respuesta señalada, cuando se conoce
Haz clic en un valor para cambiarlo.
Conversación
El bloque Conversation muestra la respuesta del bot señalada, resaltada en rojo, con los mensajes justo antes y después.
Show earlier messages / Show later messages muestran el resto de la conversación.
El icono de ampliar da más altura a la vista previa; el icono de enlace externo abre la conversación completa.
Logs abre el trace de la respuesta señalada, para ver lo que hizo el bot paso a paso. Disponible para los administradores del bot.
📘 Los logs se conservan 30 días
El trace de una Issue se puede abrir durante los 30 días siguientes a su creación. Trata tus Issues rápido para tener todos los detalles a mano.
Pasar de una Issue a otra
Las flechas arriba y abajo (o K y J) abren la Issue anterior o siguiente, en el orden del tablero.
El icono de enlace copia un enlace directo a la Issue, para compartirla en un mensaje.
Esc o la cruz cierran el panel.
Comentar y mencionar a un compañero
Los comentarios sirven para que el equipo se ponga de acuerdo sobre el problema y cómo corregirlo.
Escribe tu comentario en el cuadro de la parte inferior del panel y haz clic en la flecha o pulsa ⌘↵ (Ctrl+Enter).
Usa la barra de herramientas para la negrita, la cursiva, el subrayado y dos niveles de título.
Si un comentario no se puede publicar, tu texto se queda en el cuadro para volver a intentarlo.
Mencionar a un compañero
Escribe @ y el principio de un nombre: elige a un miembro del bot en la lista con las flechas y Enter, o haz clic en él. La mención aparece resaltada en el comentario.
Cuando publicas el comentario, cada persona mencionada recibe un e-mail con un botón que abre la Issue, en el bot correcto.
Solo las menciones nuevas envían un e-mail: editar un comentario no vuelve a notificar a las personas ya mencionadas.
Nunca recibes un e-mail por tu propio comentario.
Solo se puede mencionar a los miembros del bot. Si la lista está vacía, invita primero a tus compañeros desde Settings.
Organizar tus Categories
Las Categories agrupan las Issues de la forma más útil para tu equipo. Haz clic en Add a new category al final de la página para crear una y mueve Issues a ella desde el panel de una Issue o con Move to.
Puedes agrupar las Issues por tipo de problema:
Respuesta incorrecta: el bot respondió, pero la respuesta es incorrecta
Contenido que falta: la base de conocimiento o los flujos no cubren la pregunta
API: una API falló o devolvió datos incorrectos
Fuera de alcance: peticiones que el bot aún no trata, para guardarlas como backlog de nuevos Use Cases
O por equipo: Equipo de contenido, Equipo de producto, Atención al cliente.
Editar y eliminar
Editar o eliminar un comentario: pasa el ratón sobre tu propio comentario y usa los iconos. En edición, Esc cancela y ⌘↵ guarda. Un comentario eliminado no se puede recuperar.
Eliminar una Issue: ábrela, haz clic en ⋯ en la parte superior del panel y luego en Delete. La eliminación es definitiva: para conservar el historial de una Issue, pásala mejor a Done o Archived. Solo los administradores y los managers pueden eliminar Issues.