google-chat-messages

1# Google Chat Messages
2 
3Send messages to Google Chat spaces via incoming webhooks. Produces text messages, rich cards (cardsV2), and threaded replies.
4 
5## What You Produce
6 
7- Text messages with Google Chat formatting
8- Rich card messages (cardsV2) with headers, sections, widgets
9- Threaded conversations
10- Reusable webhook sender utility
11 
12## Workflow
13 
14### Step 1: Get Webhook URL
15 
16In Google Chat:
171. Open a Space > click space name > **Manage webhooks**
182. Create webhook (name it, optionally add avatar URL)
193. Copy the webhook URL
20 
21Store the URL as an environment variable or in your secrets manager — never hardcode.
22 
23### Step 2: Choose Message Type
24 
25| Need | Type | Complexity |
26|------|------|------------|
27| Simple notification | Text message | Low |
28| Structured info (status, digest) | Card message (cardsV2) | Medium |
29| Ongoing updates | Threaded replies | Medium |
30| Action buttons (open URL) | Card with buttonList | Medium |
31 
32### Step 3: Send the Message
33 
34Use `assets/webhook-sender.ts` for the sender utility. Use `assets/card-builder.ts` for structured card construction.
35 
36## Text Formatting
37 
38Google Chat does NOT use standard Markdown.
39 
40| Format | Syntax | Example |
41|--------|--------|---------|
42| Bold | `*text*` | `*important*` |
43| Italic | `_text_` | `_emphasis_` |
44| Strikethrough | `~text~` | `~removed~` |
45| Monospace | `` `text` `` | `` `code` `` |
46| Code block | ` ```text``` ` | Multi-line code |
47| Link | `<url\|text>` | `<https://example.com\|Click here>` |
48…