A página Issues é onde sua equipe acompanha o que precisa ser melhorado no bot. Você sinaliza uma resposta do bot a partir de uma conversa e depois a acompanha em um quadro até ser corrigida: quem cuida dela, qual a urgência, o que foi dito sobre ela. Você a encontra em Improve › Issues.
Criar uma Issue
Criar uma Issue a partir de uma conversa real é a forma mais eficaz de melhorar seu bot, porque você parte de um problema que um usuário realmente encontrou.
Em Conversations, abra uma conversa e selecione a mensagem do bot que deu errado.
Clique em Create issue.
Em What is the problem?, dê à Issue um título curto (por exemplo Resposta errada sobre preços).
Se quiser, adicione uma Description, uma Category e uma prioridade. A descrição é publicada como primeiro comentário da Issue.
A nova Issue aparece em To do. Se você não escolheu uma Category, ela vai para Unclassified issues.
Acompanhe suas Issues no quadro
A página abre em um quadro Kanban com uma coluna por status:
To do: ninguém começou ainda
In progress: alguém está cuidando dela
Done: corrigida. A coluna mostra as Issues fechadas nos últimos 7 dias; as mais antigas continuam acessíveis pela aba All
Archived: as Issues que você não precisa mais ver. A coluna fica recolhida até você clicar nela. Só administradores e managers podem arquivar Issues
Em cada coluna, as Issues são agrupadas por Category. Cada Category mantém sua cor, no quadro e na lista.
Mudar o status
Arraste um cartão para outra coluna.
Ou abra a Issue e mude o Status dela.
Para atualizar várias Issues de uma vez, marque as caixas delas e use Change status na barra que aparece. Move to move as Issues para outra Category.
Encontrar uma Issue
As abas no topo (All, To do, In progress, Done, Archived) mostram um status por vez, com o número de Issues de cada um.
O ícone de busca encontra uma Issue pelo título.
Filters restringe a lista por Priority, Category, Author, Assigned e Date range.
Sort by ordena as Issues por data (Newest first, Oldest first), prioridade, status ou autor.
List (no canto superior direito) mostra as Issues em tabelas agrupadas por Category no lugar do quadro.
Trabalhar em uma Issue
Clique em uma Issue para abrir o painel de detalhe.
Propriedades
No topo do painel, abaixo do título e do autor:
Status: To do, In progress, Done ou Archived
Priority: High, Medium, Low ou None. Indica à equipe o que tratar primeiro
Category: o grupo ao qual a Issue pertence
Assigned to: o colega que cuida da Issue. Qualquer membro do bot pode ser atribuído
Use case: para os administradores do bot, um link para o Use Case que produziu a resposta sinalizada, quando ele é conhecido
Clique em um valor para alterá-lo.
Conversa
O bloco Conversation mostra a resposta do bot sinalizada, destacada em vermelho, com as mensagens logo antes e logo depois.
Show earlier messages / Show later messages mostram o restante da conversa.
O ícone de ampliar dá mais altura à pré-visualização; o ícone de link externo abre a conversa completa.
Logs abre o trace da resposta sinalizada, para ver o que o bot fez passo a passo. Disponível para os administradores do bot.
📘 Os logs são guardados por 30 dias
O trace de uma Issue pode ser aberto durante os 30 dias seguintes à sua criação. Trate suas Issues rapidamente para ter todos os detalhes à mão.
Navegar entre Issues
As setas para cima e para baixo (ou K e J) abrem a Issue anterior ou seguinte, na ordem do quadro.
O ícone de link copia um link direto para a Issue, para compartilhá-la em uma mensagem.
Esc ou o X fecham o painel.
Comentar e mencionar um colega
Os comentários servem para a equipe chegar a um acordo sobre o problema e sobre como corrigi-lo.
Digite seu comentário na caixa na parte de baixo do painel e clique na seta ou pressione ⌘↵ (Ctrl+Enter).
Use a barra de ferramentas para negrito, itálico, sublinhado e dois níveis de título.
Se um comentário não puder ser publicado, seu texto fica na caixa para você tentar de novo.
Mencionar um colega
Digite @ e o começo de um nome: escolha um membro do bot na lista com as setas e Enter, ou clique nele. A menção aparece destacada no comentário.
Quando você publica o comentário, cada pessoa mencionada recebe um e-mail com um botão que abre a Issue, no bot certo.
Só as menções novas enviam e-mail: editar um comentário não notifica de novo as pessoas já mencionadas.
Você nunca recebe e-mail pelo seu próprio comentário.
Só membros do bot podem ser mencionados. Se a lista estiver vazia, convide primeiro seus colegas em Settings.
Organizar suas Categories
As Categories agrupam as Issues da forma mais útil para sua equipe. Clique em Add a new category no fim da página para criar uma e mova Issues para ela pelo painel de uma Issue ou com Move to.
Você pode agrupar as Issues por tipo de problema:
Resposta errada: o bot respondeu, mas a resposta está errada
Conteúdo faltando: a base de conhecimento ou os fluxos não cobrem a pergunta
API: uma API falhou ou retornou dados errados
Fora do escopo: pedidos que o bot ainda não trata, para guardar como backlog de novos Use Cases
Ou por equipe: Equipe de conteúdo, Equipe de produto, Atendimento ao cliente.
Editar e excluir
Editar ou excluir um comentário: passe o mouse sobre o seu próprio comentário e use os ícones. Na edição, Esc cancela e ⌘↵ salva. Um comentário excluído não pode ser recuperado.
Excluir uma Issue: abra a Issue, clique em ⋯ no topo do painel e depois em Delete. A exclusão é definitiva: para manter o histórico de uma Issue, passe-a para Done ou Archived. Só administradores e managers podem excluir Issues.