google-chat

# Google Chat Messaging

Send messages to Google Chat using two methods:

1. **Webhooks** - Fast, pre-configured channels (messages appear as a bot)
2. **OAuth** - Dynamic messaging to any space or user (requires authentication)

## Quick Start

### Method 1: Webhooks (Recommended for Known Channels)

Send to a pre-configured channel:

```bash
python3 scripts/send_webhook.py "$WEBHOOK_URL" "Your message here"
```

Example with threading:
```bash
python3 scripts/send_webhook.py "$WEBHOOK_URL" "Reply message" --thread_key "unique-thread-id"
```

**Configuration:** Store webhooks in `google-chat-config.json`:

```json
{
  "webhooks": {
    "acs_engineering_network": "https://chat.googleapis.com/v1/spaces/...",
    "general": "https://chat.googleapis.com/v1/spaces/..."
  }
}
```

Read config and send:
```bash
WEBHOOK_URL=$(jq -r '.webhooks.acs_engineering_network' google-chat-config.json)
python3 scripts/send_webhook.py "$WEBHOOK_URL" "Deploy completed ✅"
```

### Method 2: OAuth (For Dynamic Messaging)

**First-time setup:**

1. Save OAuth credentials to a file (e.g., `google-chat-oauth-credentials.json`)
2. Run initial authentication (opens browser, saves token):

```bash
python3 scripts/send_oauth.py \
  --credentials google-chat-oauth-credentials.json \
  --token google-chat-token.json \
  --space "General" \
  "Test message"
```

**Send to a space by name:**
```bash
python3 scripts/send_oauth.py \
  --credentials google-chat-oauth-credentials.json \
  --token google-chat-token.json \
  --space "Engineering Network" \
  "Deploy completed"
```

**Note:** OAuth messages automatically include `🤖` emoji prefix. Use `--no-emoji` to disable this:
```bash
python3 scripts/send_oauth.py \
  --credentials google-chat-oauth-credentials.json \
  --token google-chat-token.json \
  --space "Engineering Network" \
  "Message without emoji" \
  --no-emoji
```

**List available spaces:**
```bash
python3 scripts/send_oauth.py \
  --credentials google-chat-oauth-credentials.json \...

# Google Chat Skill

Send messages to Google Chat spaces and users via webhooks or OAuth 2.0.

## Features

✅ **Webhook support** - Send to predefined channels (messages appear as configured bot)  
✅ **OAuth support** - Send to any space dynamically (messages appear from your Google Chat App)  
✅ **Space discovery** - List all available spaces and DMs  
✅ **Automatic emoji prefix** - OAuth messages include 🤖 emoji (configurable)  
✅ **Message threading** - Support for threaded conversations

## Quick Start

### Webhook (fastest)
```bash
python3 scripts/send_webhook.py "$WEBHOOK_URL" "Your message"
```

### OAuth (flexible)
```bash
# First time: authenticate
python3 scripts/send_oauth.py \
  --credentials oauth-creds.json \
  --token token.json \
  --space "Channel Name" \
  "Your message"

# List spaces
python3 scripts/send_oauth.py \
  --credentials oauth-creds.json \
  --token token.json \
  --list-spaces
```

## Setup Requirements

**For webhooks:**
- Create incoming webhook in Google Chat space settings

**For OAuth:**
1. Google Cloud Console → Create OAuth 2.0 credentials (Desktop app)
2. Enable Google Chat API
3. Download credentials JSON
4. Run authentication flow (opens browser)

## Configuration Example

See `references/config-example.json` for a config template with multiple webhooks.

## Limitations

- **OAuth cannot create new DMs by email** - This is a Google Chat API limitation
- To send DMs via OAuth, you need the space ID of an existing conversation
- Use `--list-spaces` to discover available DM space IDs

## Full Documentation

See `SKILL.md` for complete usage, examples, and troubleshooting.

---

**Created:** 2026-01-25  
**Tested with:** Google Workspace