Slack Integration
Team-wide access के लिए अपने agent को Slack workspaces में जोड़ें।
अवलोकन
Slack integration प्रदान करती है:
- Slash command support (
/ask) - Direct message conversations
- Channel mentions
- Workspace-wide availability
पूर्व-आवश्यकताएं
- Slack workspace admin या app installation permissions
- Active agent के साथ Cuneiform Chat account
Setup Steps
1. Integration Setup शुरू करें
- Sidebar में Integrations पर जाएं
- Slack card खोलें
- Add to Slack पर क्लिक करें
2. App Authorize करें
- Install करने के लिए workspace चुनें
- Permissions review करें
- Allow पर क्लिक करें
3. Installation Verify करें
- Slack खोलें
- Slash command try करें:
/ask Hello - Verify करें कि response मिलता है
Bot का उपयोग करना
Slash Commands
किसी भी channel में /ask command का उपयोग करें:
/ask What is our refund policy?Response channel में दिखता है।
Direct Messages
Private conversations के लिए bot को directly message करें:
- Slack sidebar में app खोजें
- Direct message खोलें
- स्वाभाविक रूप से chat करें
Channel Mentions
Channels में सवाल पूछने के लिए bot को mention करें:
@YourBot What are the shipping options?Features
Workspace-Wide Access
एक बार install हो जाने के बाद, bot सभी workspace members के लिए उपलब्ध है।
Thread Replies
Responses threads में post हो सकते हैं ताकि channels organized रहें।
Rich Formatting
Responses Slack की formatting support करते हैं:
- Bold और italic text
- Links
- Code blocks
- Lists
Bot केवल तब respond करता है जब explicitly invoke किया जाए (slash command या mention) ताकि noise से बचा जाए।
Configuration Options
Slack integration card से आप ये कर सकते हैं:
| Option | विवरण |
|---|---|
| Default agent | चुनें कि कौन सा agent reply करे जब कोई channel-specific mapping लागू न हो |
| Channel mappings | specific Slack channels को specific agents पर route करें |
| Channel commands | अपने workspace में available slash commands manage करें |
Multi-Workspace Support
आप same agent को कई Slack workspaces में install कर सकते हैं:
- प्रत्येक workspace के लिए अलग authorization जरूरी है
- सभी workspaces same agent और content share करते हैं
- Conversations प्रत्येक workspace के लिए अलग-अलग track होते हैं
Troubleshooting
Command नहीं मिल रहा
अगर /ask काम नहीं कर रहा:
- Verify करें कि app आपके workspace में installed है
- Check करें कि app के पास proper permissions हैं
- Integration दोबारा install करने की कोशिश करें
Response नहीं आ रहा
अगर bot respond नहीं कर रहा:
- Verify करें कि आपका agent configured और working है (Playground में test करें)
- Check करें कि Slack integration connected है
- Ensure करें कि bot के पास channel access है
Permission Issues
Slack app ये OAuth scopes request करता है (pre-configured — install के दौरान आप Allow पर क्लिक करते ही ये सब grant हो जाते हैं):
commands— Slash commands के लिएchat:write— Messages भेजने के लिएchat:write.customize— Custom username/icon के साथ messages भेजेंapp_mentions:read— @ mentions के लिएim:history— Context के लिए direct-message history पढ़ेंchannels:history— Context के लिए public-channel history पढ़ेंchannels:read— Public channels list करेंgroups:history— Context के लिए private-channel history पढ़ेंmpim:history— Context के लिए group-DM history पढ़ेंusers:read— User names resolve करेंcanvases:write— Slack canvases बनाएं और edit करेंassistant:write— Agents & AI Apps pane में suggested prompts seed करें
Security
- OAuth tokens encrypted हैं
- Explicit commands/mentions के अलावा messages का कोई access नहीं
- Workspace data private रहता है
Disconnect करना
Slack integration हटाने के लिए:
-
Cuneiform Chat से:
- Integrations (sidebar) → Slack → Disconnect
-
Slack से:
- Workspace settings पर जाएं
- Apps → App खोजें → Remove
दोनों steps complete removal ensure करते हैं।