A Google Chat API passou a oferecer streaming de mensagens em Developer Preview. Um app pode mostrar progresso, etapas de ferramenta, citações e texto incremental enquanto um agente de IA ou processo demorado trabalha, e depois transformar o fluxo em uma mensagem permanente. A função foi anunciada em 4 de novembro de 2026, exige autenticação do aplicativo com conta de serviço e escopo chat.bot e ainda não aceita autenticação de usuário.
Use streaming quando a espera precisa ser explicada
Streaming é útil para buscas em bases internas, geração de relatórios, verificações de implantação e outros fluxos que levam vários segundos ou minutos. Em vez de deixar a pessoa sem resposta, o app pode informar a etapa atual e entregar conteúdo conforme ele é produzido.
Não use o recurso para simular atividade. Mostre apenas etapas que realmente ocorreram e preserve linguagem simples. Raciocínio interno sensível, credenciais, parâmetros privados e dados de outras pessoas não devem aparecer como progresso.
- Defina um tempo máximo para cada execução
- Mostre progresso baseado em eventos reais
- Permita cancelamento e trate o comando Stop
- Inclua fontes apenas quando forem verificáveis
- Registre a mensagem final e o resultado do processo
Entenda o ciclo create, update e commit
O app inicia o fluxo com spaces.streamMessages.create, referenciando a mensagem do usuário e informando um texto de progresso. A resposta devolve o nome do StreamMessage e um nextChunkToken. Cada atualização precisa usar o token mais recente.
appendStreamMessageContent acrescenta texto, etapas e citações; patch substitui conteúdo ou atualiza o progresso; commit transforma o fluxo em mensagem permanente e pode anexar cartões, widgets e fontes finais. Se o resultado não deve ser preservado, delete descarta o fluxo ativo.
Implemente autenticação e escopo mínimos
A prévia exige uma conta Business ou Enterprise, um projeto no Google Cloud, Chat API configurada e credenciais de conta de serviço. O streaming usa autenticação do aplicativo com o escopo chat.bot. A documentação informa que autenticação de usuário não é suportada.
Adicione o app apenas aos espaços necessários e mantenha a chave fora do código e dos logs. Separe ambientes de teste e produção, rotacione credenciais e restrinja o serviço de backend que pode iniciar ou concluir mensagens.
Controle concorrência, cancelamento e falhas
O nextChunkToken cria uma ordem obrigatória. Atualizações paralelas ou repetidas podem usar um token antigo e falhar. Centralize a sequência por mensagem, trate repetição de chamadas de forma idempotente e mantenha estado suficiente para retomar ou encerrar com clareza.
Quando a pessoa seleciona Stop, o Chat envia um evento de comando ao app. O backend deve interromper tarefas caras, decidir se confirma uma resposta parcial ou apaga o fluxo e registrar o encerramento. Também defina comportamento para timeout, fonte indisponível e erro de ferramenta.
Valide experiência, segurança e custo
Meça tempo até o primeiro sinal, tempo total, taxa de cancelamento, erros por token, respostas concluídas e custo do backend. Compare com uma mensagem única para saber se o streaming melhora entendimento ou apenas aumenta complexidade.
A função está em Developer Preview e pode mudar antes da disponibilidade geral. Não dependa dela como único canal de um processo crítico. Mantenha fallback, revise limites, faça testes com espaços controlados e reavalie o contrato quando a API avançar de estágio.
Para levar daqui
O streaming da Google Chat API torna agentes e automações demoradas mais transparentes, mas exige estado ordenado, cancelamento real, fontes verificáveis e credenciais mínimas. Comece com um fluxo interno não crítico e mantenha fallback enquanto o recurso estiver em prévia.
