> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincelo.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Chat Setup

> Connect Fincelo to Google Chat for CSM alerts — bidirectional, with interactive buttons.

## Setup Time: 20 minutes

Google Chat is Fincelo's primary recommended channel — it supports full bidirectional communication, rich card messages, and interactive buttons without any additional app store approval process.

***

## Option A — Incoming Webhook (10 minutes, one-way)

Best for getting started quickly. CSM receives alerts but must act from the Fincelo app.

1. Open Google Chat → your CS alerts space (or create one: `#fincelo-cs-alerts`)
2. Click space name → **Apps & Integrations → Webhooks → Add Webhook**
3. Name: `Fincelo` → Create → **Copy the webhook URL**
4. Fincelo → **Settings → CSM Hub → Channel Config → Google Chat**
5. Paste webhook URL → Save ✅

**Test:**

```bash theme={null}
curl -X POST "YOUR_WEBHOOK_URL"   -H "Content-Type: application/json"   -d '{"text": "✅ Fincelo CSM Hub connected"}'
```

***

## Option B — Google Chat API (30 minutes, bidirectional)

Full two-way integration — CSM can click buttons in Google Chat to acknowledge, log calls, snooze, and resolve alerts.

### Step 1 — Google Cloud Project

1. [console.cloud.google.com](https://console.cloud.google.com) → New Project: "Fincelo CSM Hub"
2. APIs & Services → Library → **Google Chat API** → Enable

### Step 2 — Configure Chat App

1. APIs → Google Chat API → **Configuration**
2. App URL: `https://app.fincelo.app/api/webhooks/google-chat`
3. Interactive features: ✅ Enable
4. Save

### Step 3 — Service Account

1. IAM & Admin → Service Accounts → Create
2. Name: `fincelo-chat-bot`
3. Generate key → JSON → Download
4. Add to Fincelo: **Settings → CSM Hub → Google Chat Bot Token**

### Step 4 — Add Bot to Space

1. In Google Chat space → Apps & Integrations → **Add apps** → search "Fincelo" → Install

### Step 5 — Get Space ID

* In browser URL when in the space: `chat.google.com/room/SPACE_ID/...`
* Copy SPACE\_ID → paste in Fincelo → **Settings → CSM Hub → Google Chat Space ID**

***

## Getting CSM User IDs (for @mentions)

For @mentions in alerts:

1. In Google Chat → click CSM's profile
2. Options → **Copy user ID** (format: `users/12345...` or email)
3. Add in Fincelo → **Settings → CSM Hub → CSM Roster → Google Chat User ID**