Esta página explica como criar uma página inicial para seu app Google Chat. A página inicial do app é uma interface de cartão personalizável que um app de chat envia para um usuário quando ele abre uma mensagem no app do Chat.
Por exemplo, é possível configure a mensagem do card da página inicial do app para incluir dicas de interação com o App do Chat usando comandos de barra. Para usuários finais, a página inicial do app é disponível na mensagem direta de um app do Chat apenas se o desenvolvedor de apps ativa o recurso.
Use o Card Builder para criar e visualizar mensagens de cards JSON para apps do Chat:
Abrir o Card BuilderPré-requisitos
Python
Um app do Google Chat com recursos interativos ativados. Para criar um interativo do Chat que usa um serviço HTTP, conclua este guia de início rápido.
Apps Script
Um app do Google Chat com recursos interativos ativados. Para criar um interativo com o app Chat no Apps Script, conclua este guia de início rápido.
Node.js
Um app do Google Chat com recursos interativos ativados. Para criar um interativo do Chat que usa um serviço HTTP, conclua este guia de início rápido.
Java
Um app do Google Chat com recursos interativos ativados. Para criar um interativo do Chat que usa um serviço HTTP, conclua este guia de início rápido.
Configurar a API Chat
Para oferecer suporte à página inicial, atualize a configuração da API Chat no console do Google Cloud.
Python
No console do Google Cloud, acesse Menu > Mais produtos > Google Workspace > Biblioteca de produtos > API Google Chat.
Clique em Gerenciar e depois na guia Configuração.
Marque a caixa de seleção Support App Home.
No campo URL da página inicial do app, adicione um URL. Geralmente, esse valor é o mesmo como o URL do app. Esse URL é chamado para Eventos
APP_HOME
.Clique em Salvar.
Apps Script
No console do Google Cloud, acesse Menu > Mais produtos > Google Workspace > Biblioteca de produtos > API Google Chat.
Clique em Gerenciar e depois na guia Configuração.
Marque a caixa de seleção Support App Home.
Clique em Salvar.
Node.js
No console do Google Cloud, acesse Menu > Mais produtos > Google Workspace > Biblioteca de produtos > API Google Chat.
Clique em Gerenciar e depois na guia Configuração.
Marque a caixa de seleção Support App Home.
No campo URL da página inicial do app, adicione um URL. Geralmente, esse valor é o mesmo como o URL do app. Esse URL é chamado para Eventos
APP_HOME
.Clique em Salvar.
Java
No console do Google Cloud, acesse Menu > Mais produtos > Google Workspace > Biblioteca de produtos > API Google Chat.
Clique em Gerenciar e depois na guia Configuração.
Marque a caixa de seleção Support App Home.
No campo URL da página inicial do app, adicione um URL. Geralmente, esse valor é o mesmo como o URL do app. Esse URL é chamado para Eventos
APP_HOME
.Clique em Salvar.
Criar página inicial do app
O card da página inicial do app é iniciado quando um usuário abre uma mensagem direta no do Chat, que pode ser atualizado como resposta de um evento interativo, como um clique em um botão, o envio de um formulário ou o fechamento de uma caixa de diálogo.
No exemplo a seguir, o app do Chat exibe Um card inicial da página inicial do app que mostra a hora em que o cartão foi criado e um botão. Quando um usuário clica no botão, o app do Chat retorna um cartão atualizado que exibe a hora em que o cartão atualizado foi criado.
Criar o cartão inicial para a página inicial do app
Para criar a página inicial, o app do Chat precisa processar
APP_HOME
eventos de interação e retornam uma instância de
RenderActions
com navegação pushCard
.
Python
Apps Script
Implemente a função onAppHome
que é chamada após todos os eventos APP_HOME
:
Este exemplo envia uma mensagem de card retornando JSON do cartão. Você também pode usar o Serviço de card do Apps Script.
Node.js
Java
Atualizar um card na página inicial do app
Se o card inicial da página inicial tiver widgets interativos, como botões
ou entradas de seleção, o app do Chat precisa processar
os eventos de interação relacionados retornando uma instância do
RenderActions
com a navegação updateCard
. Para saber mais sobre como lidar com
widgets, consulte
Processar as informações inseridas pelos usuários.
Python
Apps Script
Este exemplo envia uma mensagem de card retornando JSON do cartão. Você também pode usar o Serviço de card do Apps Script.
Node.js
Java
Limitações
Em geral,
navigation
é
indisponível para apps do Chat. Não é possível devolver uma pilha de cards.
Apenas pushCard
(para resposta inicial) e updateCard
(para atualizações) são
disponível para os apps do Chat.
Temas relacionados
- Confira exemplos de apps do Chat que usam a página inicial do app.
Para abrir uma caixa de diálogo, use a interação
OPEN_DIALOG
. Para mais informações, ver Abra uma caixa de diálogo em resposta a um card da página inicial do app.Feche uma caixa de diálogo usando a interação
CLOSE_DIALOG
. e voltar ao card da página inicial do app ou usarCLOSE_DIALOG_EXECUTE
para fechar a caixa de diálogo e atualizar o card da página inicial. Para mais informações, consulte Responder a uma caixa de diálogo para o card da página inicial do app.Para ver um exemplo de como usar a página inicial, consulte o Gerenciamento de problemas do app do Chat no codelab Criar apps para o Google Chat com o Gemini.