Skip to main content

​
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: 
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 → 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