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 do Chat oferecem suporte à interatividade de algumas das seguintes maneiras:

  • 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
  • Visualizar links
  • @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 os usuários.
  • Descreva brevemente o que seu app do Chat faz. Apresente seu app de chat dizendo às pessoas o que ele pode ajudá-las a fazer em uma ou duas frases.
  • Diga às pessoas como começar. Informe às pessoas como trabalhar com o app do Chat. Se o app do Chat exigir 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 de barra comuns.
  • Explicar como receber ajuda e enviar feedback Termine a mensagem dizendo às pessoas como podem obter ajuda ou oferecer feedback.

Esta mensagem de integração do app do Chat 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

O app do Chat pode receber e responder a interações do usuário, também conhecidas como eventos de interação no 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 de cartão

As mensagens de card são elementos da interface que podem conter widgets interativos e estáticos, como texto, imagens e botões que os apps do Chat podem enviar a usuários e espaços. Se o app do Chat precisar coletar informações de usuários, apresentar informações detalhadas ou orientá-los a seguir uma próxima etapa, envie uma mensagem com card.


Crie e visualize cards com o Criador de cards.

Abra o Criador de cards.

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

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

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

Coleta de 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 dar ao seu app do Chat digitando um comando que começa 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 visualizações de link no app do Chat, sempre que alguém compartilhar um link correspondente, os usuários poderão visualizar 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 anexando um card com informações sobre o caso.

Link visualizado em uma mensagem de card.

@mencionar usuários em uma mensagem

O app do Chat pode @mencionar usuários específicos ou todos eles 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 mencione pessoas.

Mencionar usuários únicos faz com que eles recebam uma notificação e interrompam o que estiverem fazendo. Mencionar todos os usuários em um espaço envia uma notificação para todos no espaço. Mencione pessoas com muita frequência. Assim, elas podem ficar irritadas com o app do Chat e começar a vê-lo como spam.

Não há problema em 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 oferecer a chance de dizerem 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:

O app do Chat envia mensagens para um único usuário.