Google Chat Integration

Google Workspace के भीतर seamless communication के लिए अपने agent को Google Chat से connect करें।

अवलोकन

Google Chat integration प्रदान करती है:

• Bot के साथ direct messaging
• @mention triggers के साथ Google Workspace Spaces support
• Space-level agent routing — अलग-अलग Spaces को अलग-अलग agents assign करें
• Conversation memory और opt-in space context awareness के साथ text-based responses
• Instant acknowledgment के साथ async processing
• Domain-based isolation के साथ enterprise-ready security

पूर्व-आवश्यकताएं

• एक active AI agent (Agents section में बनाया गया)
• एक Google Workspace account (personal Gmail accounts supported नहीं हैं)
• एक verified domain — connect करने से पहले Settings > Domains में अपना domain ownership verify करें

Setup Steps

1. अपना Domain Verify करें (One-Time Setup)

Google Chat connect करने से पहले, अपना domain ownership verify करें:

1. Sidebar से Settings पर जाएं
2. Domains tab पर क्लिक करें
3. आपका domain आपके account email से auto-detect होता है
4. दिखाई गई values के साथ अपने DNS provider में TXT record जोड़ें:
   • Type: TXT
   • Name: _cuneiform-verify (या दिखाई गई full value)
   • Content: Displayed verification string (जैसे, cuneiform-verify=abc123...)
5. Verify Now पर क्लिक करें — DNS changes propagate होने में 48 घंटे तक लग सकते हैं
6. Status Verified हो जाने पर, integration बनाने के लिए आगे बढ़ें

Verification card पर common DNS providers (Cloudflare, GoDaddy, Namecheap, Route 53, DigitalOcean, Hostinger) के quick links दिखाए जाते हैं।

2. Google Chat Integration बनाएं

1. Sidebar से Integrations पर जाएं
2. “Google Chat Bots” के under, Connect Bot पर क्लिक करें
3. वह Agent चुनें जो DMs और unlinked Spaces के लिए default होगा
4. एक Bot Name दर्ज करें (admin panel में आपके reference के लिए)
5. Connect Bot पर क्लिक करें
6. Displayed Verification Code copy करें (format: VERIFY-XXXXXX)

3. Bot Verification Complete करें

Integration बनाने के बाद, आपको verification code मिलेगा:

1. Google Chat खोलें
2. Start a chat → Find apps पर क्लिक करें
3. Platform bot खोजें
4. Bot के साथ direct message शुरू करें
5. Verification code भेजें (जैसे, VERIFY-ABC123)
6. Bot confirm करेगा: “Setup complete! Your workspace (yourdomain.com) is now connected. Send a message to start chatting!”

आपका integration status “Pending Verification” से “Active” हो जाएगा।

Bot का उपयोग करना

Direct Messages

Users conversation शुरू कर सकते हैं:

1. Google Chat खोलें
2. Start a chat → Find apps पर क्लिक करें
3. अपने bot का नाम खोजें
4. स्वाभाविक रूप से chat करें — bot DMs में सभी messages का respond करता है

DMs हमेशा default agent द्वारा handle किए जाते हैं।

Spaces में

Bot को Space में जोड़ें:

1. Space खोलें
2. Space name पर क्लिक करें → Manage apps
3. अपना bot जोड़ें
4. Interact करने के लिए @Cuneiform Chat से bot mention करें — bot Spaces में केवल @mentions का respond करता है

Space-Level Agent Routing

प्रत्येक Space optionally default से अलग agent उपयोग कर सकता है। Space में ये bot commands उपयोग करें (@mention जरूरी है):

Routing कैसे काम करती है:

• DMs → हमेशा default agent उपयोग करते हैं
• Custom agent वाला Space → assigned agent उपयोग करता है
• Custom agent के बिना Space → default agent पर fall back होता है

Thread History Awareness

Default रूप से, bot केवल वही message देखता है जिसने उसे सीधे @mention किया हो। अगर team members पहले context messages भेजते हैं (दूसरे threads में या Space में पहले) और फिर bot को @mention करते हैं, तो उसके पास वह context नहीं होगा — जब तक कि कोई Space manager /connect न चलाए।

How It Works

1. कोई Space manager Space में @Cuneiform Chat /connect भेजता है
2. Bot एक one-time authorization link भेजता है (10 minutes में expire हो जाता है)
3. Manager link पर क्लिक करता है और अपने Google Workspace account से sign in करता है
4. अब bot हर @mention से पहले के पिछले 15 minutes के भीतर Space में भेजे गए messages पढ़ सकता है

Connect होने के बाद, हर @mention पर bot automatically recent Space messages को context के रूप में पढ़ता है — समझता है कि @mention होने से पहले team क्या discuss कर रही थी।

उदाहरण: Team members “what are the pricing plans?” और “what’s included in starter?” post करते हैं, फिर bot को “can you help?” के साथ @mention करते हैं — bot तीनों messages देखता है और full context के साथ respond करता है।

Requirements and Privacy

• केवल Space managers (regular members नहीं) /connect चला सकते हैं
• Authorization per-Space है — हर Space को अपने /connect की जरूरत होती है
• Space manager का Google OAuth token encrypted और सुरक्षित रूप से stored होता है
• केवल वही messages readable होते हैं जो उस manager के account को दिखते हैं
• Space से bot हटाने पर stored token automatically delete हो जाता है

Re-authorization

अगर bot access खो देता है (जैसे, आपके Google account में token revoke हो जाए), तो वह Space को notify करेगा:

⚠️ Thread history access has expired or been revoked. A space manager should run /connect to restore it.

Access restore करने के लिए दोबारा /connect चलाएं।

Features

Async Responses

जब आप message भेजते हैं, bot तुरंत एक brief acknowledgment (जैसे, “Working on it…”) reply करता है और फिर processing complete होने पर full answer deliver करता है। यह आपके सवाल की complexity के आधार पर typically 3–8 seconds लेता है।

Conversation Memory

Bot एक session के भीतर context याद रखता है, इसलिए आप follow-up questions बिना खुद को दोहराए पूछ सकते हैं।

Space context awareness (opt-in): किसी Space manager के /connect चलाने के बाद, bot हर @mention से पहले के पिछले 15 minutes के भीतर Space में भेजे गए messages पढ़ता है — इसलिए वह समझता है कि team पहले से क्या discuss कर रही थी, बिना आपको context दोहराने की जरूरत के। Setup steps के लिए नीचे Thread History Awareness देखें।

Message Queuing

अगर bot अभी process कर रहा है तो आप additional messages भेजते हैं, तो वे queued हो जाते हैं और अगले response में शामिल होते हैं। आपको message मिलेगा जैसे “I’m still working on your previous question. I’ll include this in my next response.”

/help Command

Usage instructions देखने के लिए /help या help type करें, जिसमें available space commands शामिल हैं।

Domain-Based Access

केवल आपके Google Workspace domain के users ही आपके bot के साथ interact कर सकते हैं, जो enterprise-level security ensure करता है।

Text-Based Responses

Bot केवल text messages से respond करता है। Images, files, interactive buttons, और card attachments supported नहीं हैं। Responses approximately 30,000 characters तक limited हैं।

अपना Integration Manage करना

प्रत्येक integration card दिखाता है:

• Bot name - आपका configured display name
• Status badge - Active, Pending Verification, या Error
• Domain name - आपका Google Workspace domain (verification के बाद)
• Default agent - Default agent बदलने के लिए Dropdown (DMs + unlinked Spaces के लिए उपयोग किया जाता है)
• Space mappings - Collapsible section जो दिखाता है कि किन Spaces में custom agent assignments हैं
• Space commands - Collapsible section जो available bot commands दिखाता है
• Last activity timestamp

उपलब्ध Actions

Troubleshooting

Google Chat में Bot नहीं दिख रहा

1. Ensure करें कि आप Google Workspace account उपयोग कर रहे हैं (personal Gmail नहीं)
2. “Find apps” में bot का नाम खोजें
3. App propagate होने के लिए कुछ मिनट wait करें

Google Chat Section दिखाई नहीं दे रहा

1. Google Chat केवल Google Workspace उपयोग करने वाले organizations के लिए दिखता है
2. अगर आपका organization कोई अलग email provider उपयोग करता है (जैसे, Microsoft 365), तो section hidden है
3. System automatically MX records के माध्यम से आपके email provider को detect करता है

Domain Verification Issues

1. DNS changes propagate होने में 48 घंटे तक लग सकते हैं — wait करें और Verify Now दोबारा try करें
2. Check करें कि आपने Settings > Domains में दिखाई exact values के साथ TXT record जोड़ा है
3. Verify करें कि record correct domain पर है (जैसे, _cuneiform-verify.yourdomain.com)
4. Easy access के लिए verification card पर DNS provider quick links उपयोग करें

Verification Code काम नहीं कर रहा

1. Ensure करें कि आप अपने Google Workspace email से code भेज रहे हैं
2. Check करें कि code exactly जैसा दिखाया गया है वैसे दर्ज किया गया है (VERIFY- prefix सहित)
3. Verify करें कि integration अभी भी “Pending Verification” status में है
4. अगर code expire हो गया है तो नया integration बनाने की कोशिश करें

Bot “Working on it…” बोल रहा है लेकिन Response नहीं आता

1. Bot messages asynchronously process करता है — full response के लिए 25 seconds तक wait करें
2. अगर response नहीं आता, तो अपना message दोबारा भेजने की कोशिश करें
3. Check करें कि associated agent सही तरह configured है

Messages Process नहीं हो रहे

1. Confirm करें कि आपका workspace verified है (status “Active” होनी चाहिए)
2. Spaces के लिए, ensure करें कि आप bot को @mention कर रहे हैं
3. Check करें कि associated agent सही तरह configured है

”Organization hasn’t connected” Message

इसका मतलब है bot आपके Google Workspace domain को recognize नहीं कर रहा:

1. आपके admin ने अभी तक integration नहीं बनाया
2. Domain को verification code से verify नहीं किया गया है
3. आप personal Gmail account से message कर रहे हैं (supported नहीं)

/set-agent कहता है Agent नहीं मिला

1. Admin panel में exact agent नाम check करें (case-sensitive)
2. Ensure करें कि agent “Active” status में है
3. Spaces वाले agent names supported हैं — /set-agent के बाद full name type करें

/connect कहता है “Only space managers can run /connect”

/connect चलाने के लिए आपका Space manager होना जरूरी है। अपने Space में किसी Space manager से command चलाने को कहें।

/connect Authorization Link Expire हो गया

Link 10 minutes के लिए valid रहता है। एक fresh link पाने के लिए दोबारा @Cuneiform Chat /connect चलाएं।

Bot “Thread history access has expired” बोल रहा है

किसी Space manager को दोबारा @Cuneiform Chat /connect चलाकर re-authorize करना होगा। यह तब होता है जब Google OAuth token revoke हो जाता है (जैसे, Google account settings में)।

Security

• Domain ownership verification — DNS TXT record prove करता है कि आपका organization domain own करता है, connect करने से पहले
• Google Workspace detection — MX record check confirm करता है कि आपका domain Google Workspace उपयोग करता है
• Domain-based isolation — केवल आपके organization के Google Workspace users आपके bot के साथ interact कर सकते हैं
• Webhook verification — हर incoming request आपके platform के Google Cloud project के खिलाफ validated होती है
• Verification codes single-use हैं और आपके domain से tied हैं
• Messages secure, encrypted connections पर process होते हैं

Disconnect करना

Google Chat integration हटाने के लिए:

1. Sidebar से Integrations पर जाएं
2. अपना Google Chat integration card खोजें
3. Three-dot menu पर क्लिक करें
4. Disconnect चुनें

महत्वपूर्ण Notes

• Google Workspace जरूरी है: Personal Gmail accounts इस integration का उपयोग नहीं कर सकते। अगर आपका org Google Workspace उपयोग नहीं करता, तो Google Chat section दिखाई नहीं देगा।
• Domain verification जरूरी है: Google Chat connect करने से पहले Settings > Domains में अपना domain verify करें।
• प्रति organization एक integration: प्रत्येक organization एक Google Chat integration रख सकता है
• केवल text: Bot images, files, या interactive buttons support नहीं करता
• Org level पर manage: Google Chat Integrations page पर configure होता है, per-agent नहीं
• Space routing: अलग-अलग teams को specialized agents assign करने के लिए Spaces में /set-agent उपयोग करें
• Default agent: Dropdown का उपयोग करके कभी भी default agent बदलें — disconnect की जरूरत नहीं