jezweb/google-chat-messages

O que google-chat-messages faz?

Envie mensagens do Google Chat via webhooks de entrada — texto, cartões ricos (cardsV2), respostas em thread. Tipos TypeScript, utilitário de criação de cartões, referência de widgets inline. Use sempre que o usuário quiser postar no Google Chat a partir de um script, construir uma resposta de chatbot, enviar um cartão de notificação, construir uma integração de webhook do Google Chat ou solucionar problemas de cartões / threads.

Visão Geral

Esta skill fornece uma maneira programática de interagir com o Google Chat através de webhooks de entrada. Ela abstrai a complexidade da API REST do Google Chat, oferecendo uma interface simples e tipada para enviar mensagens de texto, cartões interativos e respostas em thread.

Recursos

• Envio de mensagens de texto simples
• Criação de cartões ricos (cardsV2) com suporte a widgets
• Respostas em thread para conversas encadeadas
• Suporte completo a tipos TypeScript
• Utilitário embutido para construção de cartões
• Documentação inline de widgets

Casos de Uso

• Enviar notificações de sistemas de monitoramento
• Construir respostas de chatbots
• Automatizar postagens em canais do Google Chat
• Criar integrações de webhook personalizadas
• Depurar problemas de cartões e threading

Como Usar

1. Configure um webhook de entrada no Google Chat (espaço ou sala)
2. Use a skill para construir e enviar mensagens
3. Aproveite os tipos TypeScript e utilitários para maior produtividade

Exemplo

import { sendMessage } from 'jezweb/google-chat-messages';

const webhookUrl = 'https://chat.googleapis.com/v1/spaces/.../messages?key=...';

// Enviar uma mensagem de texto
await sendMessage(webhookUrl, { text: 'Olá, mundo!' });

// Enviar um cartão
await sendMessage(webhookUrl, {
  cardsV2: [
    {
      cardId: 'card-1',
      card: {
        header: { title: 'Notificação', subtitle: 'Exemplo' },
        sections: [
          { widgets: [{ textParagraph: { text: 'Mensagem do cartão' } }] }
        ]
      }
    }
  ]
});

// Enviar uma resposta em thread
await sendMessage(webhookUrl, {
  text: 'Resposta na thread',
  thread: { name: 'spaces/.../threads/...' }
});

Referência de Widgets

Consulte a documentação inline ou o arquivo widgets.md para uma lista completa de widgets suportados para cartões.

Solução de Problemas

• Certifique-se de que a URL do webhook está correta e possui as permissões adequadas.
• Para problemas com cartões, verifique a estrutura JSON e a compatibilidade dos widgets.
• Para problemas com threads, confirme que você está usando o nome correto da thread retornado pela API.