Projetar interações do usuário

Esta página descreve como implementar a interatividade do usuário em apps do Google Chat. De mensagens de texto a interfaces gráficas do usuário baseadas em cartões, os apps de chat oferecem suporte à interatividade de algumas das maneiras abaixo:

  • Apresentar os usuários ao seu app do Chat
  • Responder a interações no Chat
  • Mensagens do card
  • Caixas de diálogo
  • Comandos de barra
  • Links de prévia
  • @mencionar usuários em uma mensagem

Apresentar os usuários ao seu app do Chat

Integre pessoas e espaços ao seu app do Chat com uma mensagem de boas-vindas que detalha o que o app do Chat faz e como as pessoas podem trabalhar melhor com ele.

Uma mensagem de integração eficaz tem a seguinte estrutura:

  • Diga "Olá". Defina a voz e o tom certos para seus usuários.
  • Descreva brevemente o que seu app do Chat faz. Apresente seu app de chat contando às pessoas o que ele pode ajudar a fazer em uma ou duas frases.
  • Diga às pessoas como começar. Informe às pessoas como usar seu app do Chat. Se ele requer configuração ou autorização, este é um bom lugar para solicitar que as pessoas concluam o processo de configuração. Por exemplo, sugira um ou dois comandos comuns de barra.
  • Explicar como receber ajuda e enviar feedback Encerre a mensagem dizendo às pessoas como podem obter ajuda ou oferecer feedback.

A mensagem de integração do app do Chat a seguir prepara os usuários para o sucesso:

Exemplo de mensagem de integração para um app do Chat de programação.

Receber e responder a interações no Chat

Seu app do Chat pode receber e responder a interações do usuário, também conhecidas como eventos de interação do app do Chat. Todas as interações descritas nesta página são do Chat, mas também podem incluir outras interações, como adicionar ou remover um app do Chat de um espaço.

Enviar mensagens do cartão

Mensagens de card são elementos da IU que podem conter widgets interativos e estáticos, como texto, imagens e botões que os apps de chat podem enviar a usuários e espaços. Se o app do Chat precisar coletar informações dos usuários, apresentar informações detalhadas ou orientar os usuários a seguir a próxima etapa, envie uma mensagem em card.

Esta é uma mensagem de card de um app do Chat:

App de chat enviando uma mensagem com um cartão.

Abrir caixas de diálogo nas mensagens

As caixas de diálogo são interfaces baseadas em cards que um usuário pode abrir em janelas para interagir com o app do Chat. Nas caixas de diálogo, é possível agrupar várias mensagens de cartão sequencialmente, o que ajuda os usuários a concluir processos de várias etapas, como preencher dados de formulário.

No exemplo abaixo, um app do Chat inicia uma caixa de diálogo para coletar detalhes de contato de um usuário que emite o comando de barra /createContact:

Coletar detalhes sobre um novo contato de um usuário com uma caixa de diálogo.

Configurar comandos de barra

Os comandos de barra permitem registrar e anunciar comandos específicos que os usuários podem fornecer ao app do Chat digitando um comando que comece com uma barra (/), como /help.

Veja a seguir uma lista de comandos de barra disponíveis para o app Cymbal Chat:

Escolha um comando de barra para interagir com o app do Chat.

Depois que você configurar as visualizações de link no app do Chat, sempre que alguém compartilhar um link correspondente, os usuários poderão ver o link anexando um cartão à mensagem.

O app do Chat a seguir ajuda os agentes de atendimento ao cliente a visualizar links para casos compartilhados em um espaço do Chat. Para isso, basta anexar um cartão com informações sobre o caso.

Link visualizado em uma mensagem de card.

@mencionar usuários em uma mensagem

Seu app do Chat pode @mencionar usuários específicos ou todos os usuários em um espaço para notificá-los sobre a mensagem. Antes de mencionar um único usuário, especialmente antes de mencionar todos os usuários em um espaço, considere se isso é realmente necessário ou não por não mencionar pessoas.

Mencionar usuários únicos faz com que eles recebam uma notificação e interrompam o que estiverem fazendo. Quando você menciona todos os usuários em um espaço, uma notificação é enviada para todos no espaço. Mencione pessoas com muita frequência. Assim, elas podem ficar incomodadas e começar a ver o app do Chat como spam.

É possível mencionar usuários por motivos muito importantes ou urgentes. Por exemplo, o seguinte app do Chat @menciona um espaço cheio de desenvolvedores de software para notificá-los de que o congelamento de código está se aproximando e para dar a eles a chance de dizer que precisam de um pouco mais de tempo antes do prazo:

O app do Chat envia mensagens para todos os usuários em um espaço.

Por outro lado, o seguinte app de chat menciona um cliente diretamente para agradecê-lo, o que é educado, mas não é digno de notificação:

Mensagens no app de chat para apenas um usuário.