ai features complete - nself-org/nchat GitHub Wiki
Version: 1.0.0 (v0.7.0) Last Updated: January 31, 2026
A comprehensive guide to all AI-powered features in nself-chat, including message summarization, smart search, intelligent bots, and auto-moderation.
- Overview
- Getting Started
- Message Summarization
- Smart Search
- Bot Interactions
- Auto-Moderation
- Privacy & Data Usage
- Opt-In/Opt-Out
- Troubleshooting
- FAQ
nself-chat includes four major AI-powered capabilities:
| Feature | Description | Status | AI Required |
|---|---|---|---|
| Message Summarization | Generate summaries of conversations, threads, and channels | โ Available | Optional |
| Smart Search | Semantic search that understands meaning, not just keywords | โ Available | Optional |
| Intelligent Bots | Automated assistants that respond to commands and events | โ Available | No |
| Auto-Moderation | AI-powered content detection for toxicity, spam, and NSFW | โ Available | Optional |
All AI features in nself-chat are designed with graceful degradation:
- With AI APIs configured: Full semantic understanding, advanced summaries, and intelligent detection
- Without AI APIs: Local fallbacks provide basic functionality without requiring external services
- User control: All AI features respect user preferences and privacy settings
| Provider | Summarization | Search Embeddings | Moderation | Cost |
|---|---|---|---|---|
| OpenAI | GPT-4o-mini | text-embedding-3-small | โ TensorFlow.js | ~$0.001 per 1K messages |
| Anthropic | Claude 3.5 Haiku | โ (falls back to local) | โ TensorFlow.js | ~$0.0015 per 1K messages |
| Local | Basic statistics | Keyword search | โ TensorFlow.js | Free |
To see which AI features are available in your workspace:
- Click your profile in the top-right corner
- Go to Settings > AI Features
- View the status dashboard:
โ
Message Summarization: Enabled (OpenAI)
โ
Smart Search: Enabled (Semantic)
โ
Auto-Moderation: Enabled (AI-powered)
โ ๏ธ Bot Responses: Basic (No AI configured)
If you're an admin setting up AI features:
- Navigate to Admin Panel > AI Configuration
- Choose your AI provider (OpenAI or Anthropic recommended)
- Enter your API key (see Admin Guide)
- Test the connection
- Enable features for your workspace
Note: Regular users don't need to configure anything - AI features work automatically once enabled by admins.
Message summarization uses AI to condense long conversations into concise, readable summaries. This helps you:
- Catch up quickly after being away
- Review lengthy discussions without reading every message
- Understand thread context at a glance
- Extract key decisions from conversations
What it does: Provides a comprehensive overview of channel activity over a time period.
When to use:
- Starting your workday
- Reviewing what happened while you were offline
- Understanding channel activity patterns
How to access:
- Open any channel
- Click the โก Summarize button in the top toolbar
- Select "Channel Digest"
- Choose time period (Last hour, Today, Last 7 days, Custom)
Example Output:
๐ Channel Digest: #engineering (Last 24 hours)
Summary:
The engineering team discussed the authentication bug affecting login
flows, decided to implement 2FA for all users, and reviewed the Q1
roadmap. Sarah reported fixing the database migration issue.
Key Points:
โข Authentication bug fix deployed to staging
โข 2FA implementation approved for Q1
โข Database migration completed successfully
โข Code review process updated
Topics: Authentication, Security, Database, Process Improvements
Participants: 8 members | Messages: 156
What it does: Summarizes a conversation thread to help you understand the discussion.
When to use:
- Before joining a long thread
- Reviewing decisions made in a thread
- Understanding context without reading all replies
How to access:
- Hover over any message with replies
- Click "View Thread"
- Click the ๐ Summary button at the top of the thread panel
Example Output:
๐งต Thread Summary
The team discussed implementing dark mode. Three design approaches
were proposed. Final decision: Use CSS variables for maximum
flexibility. Alex will create a design system document by Friday.
Key Decisions:
โข CSS variables approach approved
โข Design system doc due Friday
โข Color contrast must meet WCAG AA standards
Participants: 4 | Messages: 23
What it does: Shows you what you missed since you were last online.
When to use:
- Returning after time away
- Checking in on channels you don't actively monitor
- Quick status updates
How to access:
- Automatically appears when you open a channel with new messages
- Or click your profile > "Catch Up" to see all channels
Example Output:
๐ Welcome back! You missed 47 messages in 3 channels.
#engineering (23 messages):
โข Bug fix for authentication deployed
โข Q1 roadmap reviewed and approved
#design (15 messages):
โข New brand guidelines published
โข User research findings shared
#general (9 messages):
โข Team lunch scheduled for Friday
โข Office will be closed on Monday
What it does: Generates a brief 1-2 sentence summary of any selection of messages.
When to use:
- Quick context on recent messages
- TL;DR for lengthy discussions
- Sharing context with others
How to access:
- Select multiple messages (Shift+Click)
- Right-click and choose "Summarize Selection"
Example Output:
Brief Summary: Discussion about API rate limiting. Team decided to
implement exponential backoff and increase default limits for premium users.
Step-by-step:
- Navigate to any channel or thread
- Look for the summarization controls:
- โก Button in the toolbar (Channel Digest)
- ๐ Button in thread header (Thread Summary)
- Right-click menu on selected messages (Quick Summary)
- Choose summary type and time range
- Click "Generate Summary"
- Wait 2-5 seconds for AI processing
- Review and optionally "Copy" or "Share" the summary
Keyboard Shortcuts:
-
Cmd/Ctrl + Shift + S- Summarize current view -
Cmd/Ctrl + Shift + D- Generate channel digest -
Esc- Close summary panel
Step-by-step:
- Tap the โฎ Menu icon in the top-right
- Select "Summarize"
- Choose summary type
- Tap "Generate"
- View summary and tap "Done" when finished
Tips for Mobile:
- Summaries are optimized for mobile screens
- Swipe down to dismiss
- Long-press summary to copy
Options available:
| Option | Description | Values |
|---|---|---|
| Style | Output format | Brief, Detailed, Bullet Points |
| Length | Summary length | Short (100 words), Medium (300 words), Long (500 words) |
| Focus | What to emphasize | All content, Decisions only, Key points only |
| Language | Output language | Auto-detect, English, Spanish, French, German, etc. |
To customize:
- Click Settings in the summary panel
- Adjust options
- Click "Regenerate" to apply changes
If you see "Summarization not available":
โ Solution: The workspace administrator needs to configure AI settings. This is normal and the feature will work once configured.
If you see "Using basic summary":
โน๏ธ What this means: AI is not configured, but you'll still get a basic statistical summary showing message counts, participants, and time ranges.
Smart Search uses AI to understand the meaning of your queries, not just match keywords. This means:
- Natural language: Search like you talk - "show me discussions about the login bug"
- Conceptual matching: Finds related content even with different wording
- Context awareness: Understands synonyms and paraphrasing
- Relevance ranking: Best results first, combining semantic similarity and recency
Query: authentication issues
Finds: Messages about login problems, password resets, 2FA errors, session timeouts
Query: who can help with React?
Finds: Messages from team members discussing React, frontend, components, hooks
Query: decisions about the API
Finds: Messages containing conclusions, approvals, or choices regarding API design
Natural Language:
"What did Sarah say about the database migration?"
โ Finds Sarah's messages related to database, migration, schema changes
Time-Based:
"bug reports from last week"
โ Filters to messages from the past 7 days containing bug descriptions
Multi-Concept:
"authentication AND security NOT testing"
โ Finds security-related auth discussions, excluding test-related messages
-
Click the search icon (๐) in the top toolbar or press
Cmd/Ctrl + K - Type your query in natural language
- View results as you type (debounced after 300ms)
- Click a result to jump to that message in context
Search Bar Features:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ Search messages with AI... โ
โ โ
โ โจ Semantic search enabled โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Available Filters:
| Filter | Description | Example |
|---|---|---|
| Channel | Search within specific channel(s) | #engineering |
| User | Messages from specific users | from:sarah |
| Date | Time range | after:2026-01-01 |
| Has Thread | Only messages with replies | has:thread |
| Has Links | Messages containing URLs | has:links |
| Has Files | Messages with attachments | has:files |
Combining Filters:
authentication in:#engineering from:sarah after:2026-01-15
โ Sarah's messages about authentication in #engineering since Jan 15
| Operator | Usage | Example |
|---|---|---|
| AND | Both terms must be present | API AND security |
| OR | Either term present | bug OR issue |
| NOT | Exclude term | deploy NOT staging |
| "" | Exact phrase | "critical bug" |
| ( ) | Group terms | (API OR backend) AND performance |
Each search result shows:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฌ Sarah in #engineering โ
โ 15 minutes ago โ
โ โ
โ "We fixed the authentication bug by... โ
โ ...implementing proper session..." โ
โ โ
โ ๐ฏ Relevance: 95% | Type: Semantic โ
โ ๐ 2 replies โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Elements explained:
- Relevance Score: How well the message matches your query (0-100%)
-
Match Type:
-
Semantic- AI understanding (best) -
Keyword- Word matching (fallback) -
Exact- Exact phrase match (highest precision)
-
- Highlights: Relevant excerpts from the message
- Context: Optional before/after messages for context
To see surrounding messages:
- Hover over a search result
- Click "Show Context"
- View 2 messages before and after (configurable)
Why context matters: Understanding the conversation flow around a message helps you grasp the full meaning.
Choose how results are ordered:
| Strategy | Description | Best For |
|---|---|---|
| Relevance | Most relevant first | Finding best matches |
| Recent | Newest first | Finding latest mentions |
| Hybrid | Balance relevance (70%) + recency (30%) | Most searches (default) |
To change ranking: Click the โ๏ธ Settings icon in search โ Select ranking strategy
โ Do:
- Use natural language: "show me", "find", "what did"
- Be specific: "React performance optimization" vs "React"
- Use synonyms: Try different terms if first search doesn't work
- Combine filters: Narrow down with channel, date, user filters
- Use quotes for exact phrases: "critical production bug"
โ Avoid:
- Single-letter searches: "a", "I" (minimum 2 characters)
- Too generic: "help", "question" (too many results)
- Overly complex queries: Keep it simple for best results
Find experts:
"who knows about GraphQL?"
โ People discussing GraphQL, their messages, expertise
Track decisions:
"approved OR decided OR agreed" in:#product-planning
โ Decision-making messages in product planning
Monitor bugs:
"bug OR issue OR error" has:thread after:yesterday
โ Recent bug reports with discussion threads
Save frequent searches:
- Perform a search
- Click โญ Save Search
- Name your search (e.g., "Recent bugs in engineering")
- Access from Saved Searches dropdown
Benefits:
- Quick access to common queries
- Shared saved searches (admin feature)
- Email alerts for saved search results (coming soon)
| Shortcut | Action |
|---|---|
Cmd/Ctrl + K |
Open search |
Cmd/Ctrl + Shift + F |
Advanced search |
โ โ
|
Navigate results |
Enter |
Open selected result |
Esc |
Close search |
Cmd/Ctrl + Enter |
Open in new window |
If you see "Keyword search" badge:
This means AI-powered semantic search is not available, but you still have full keyword search functionality.
Differences:
- โ Still works for exact matches and keywords
- โ Still supports all filters and operators
โ ๏ธ Won't understand synonyms or conceptsโ ๏ธ May return more irrelevant results
Example:
- With semantic:
authentication issuesfinds login, password, session problems - Without semantic:
authentication issuesfinds only messages with those exact words
Bots are automated assistants that can:
- Respond to commands (/help, /poll, /remind)
- Answer questions based on chat history and knowledge
- Automate tasks (create polls, set reminders, fetch data)
- Monitor events (welcome new members, track reactions)
| Bot | Purpose | Commands | AI Required |
|---|---|---|---|
| HelloBot ๐ | Greetings and jokes |
/hello, /hi, /joke
|
No |
| PollBot ๐ | Create and manage polls |
/poll, /vote, /results
|
No |
| ReminderBot โฐ | Set reminders |
/remind, /reminders
|
No |
| WelcomeBot ๐ | Welcome new members |
/setwelcome, /welcomemessage
|
No |
| SearchBot ๐ | Semantic search assistant |
/search, /find
|
Optional |
| SummaryBot ๐ | Generate summaries |
/summarize, /digest
|
Optional |
Admins can add custom bots from the Bot Marketplace or build their own using the Bot SDK.
Basic format: /command [arguments]
Examples:
/hello
โ "Hi there, Alex! ๐"
/hello Alice
โ "Hello, Alice! ๐"
/joke
โ "Why do programmers prefer dark mode? Because light attracts bugs! ๐"
Get command list:
/help
โ Shows all available commands from all enabled bots
Get bot-specific help:
/help poll
โ Shows all PollBot commands and usage
Get command details:
/help /poll
โ Shows detailed usage for /poll command
Mention a bot to get its attention:
@HelloBot what can you do?
โ "I can greet people and tell programming jokes! Try /hello or /joke"
Some AI-powered bots understand natural language:
@SearchBot find discussions about authentication
โ SearchBot performs a semantic search and returns results
@SummaryBot summarize today's messages
โ SummaryBot generates a channel digest for today
Step-by-step:
- Create poll:
/poll "Should we have pizza or tacos for lunch?" "Pizza" "Tacos" --duration 30
โ PollBot creates poll with 30-minute duration
- Vote:
/vote poll-123 1
โ Vote for option 1 (Pizza)
- Check results:
/results poll-123
โ Shows current vote counts
- Close poll:
/closepoll poll-123
โ Closes poll and shows final results
Quick reminder:
/remind in 30 minutes to check deployment
โ "โฐ Reminder set! I'll remind you in 30 minutes."
Scheduled reminder:
/remind tomorrow at 9am to review pull requests
โ "โฐ Reminder set for tomorrow at 9:00 AM"
List reminders:
/reminders
โ Shows all your active reminders
Cancel reminder:
/cancel-reminder 456
โ "Reminder #456 cancelled"
Set up welcome message (Admins only):
- Enable welcome:
/setwelcome on
โ "Welcome messages enabled for this channel"
- Customize message:
/welcomemessage "Welcome {user} to {channel}! Check out our guidelines in the pinned message."
โ "Welcome message updated"
- Test it:
/testwelcome
โ Shows preview of welcome message
Placeholders:
-
{user}- New member's name -
{channel}- Channel name -
{server}- Workspace name
Bots have limited permissions to protect your data:
What bots CAN do: โ Read messages they're mentioned in โ Send messages to channels they're in โ React to messages โ Access channel member lists โ Store bot-specific data
What bots CANNOT do: โ Read messages in channels they're not in โ Access private/DM messages (unless explicitly invited) โ Modify or delete user messages โ Access user credentials or personal data โ Make changes to workspace settings
As a User:
- Go to Settings > Bots
- View all available bots
- See what bots are active in each channel
As an Admin:
- Go to Admin Panel > Bots
- Enable/disable bots workspace-wide
- Configure bot permissions
- View bot usage analytics
- Add custom bots from marketplace
Auto-moderation uses AI to automatically detect and handle problematic content:
- Toxicity Detection: Identifies insults, threats, harassment
- Spam Detection: Catches repetitive messages, excessive links
- NSFW Detection: Flags inappropriate images (if enabled)
- Profanity Filtering: Blocks or masks offensive language
Detection Process:
- Message sent โ Auto-mod scans content
- AI analysis โ Checks for toxicity, spam, profanity
- Score calculation โ Generates risk score (0-100%)
- Action determination โ Based on threshold and settings
- Action execution โ Flag, hide, warn, or mute
Analysis Methods:
- TensorFlow.js models (runs locally, no data sent to external APIs)
- Pattern matching (rule-based detection)
- Behavioral analysis (message frequency, link counts)
What it detects:
- Identity attacks
- Insults and name-calling
- Threats
- Severe toxicity
- Obscene language
Example:
โ Message: "You're an idiot and should be fired"
๐จ Detected: Toxicity (85%), Categories: Insult, Identity Attack
โก Action: Hidden, user warned
What it detects:
- Excessive capitalization
- Repetitive characters
- Too many links
- Shortened URLs (bit.ly, etc.)
- High message frequency
- Known spam phrases
Example:
โ Message: "CLICK HERE NOW!!! bit.ly/sketchy-link FREE MONEY!!!"
๐จ Detected: Spam (92%), Reasons: Excessive caps, shortened URL, spam phrases
โก Action: Message hidden
What it detects (images only):
- Pornographic content
- Sexually suggestive images
- Graphic violence
Note: NSFW detection is opt-in and must be explicitly enabled by admins.
What it does:
- Detects offensive words
- Can block, mask, or just flag
- Supports custom word lists
- Context-aware (avoids false positives)
Modes:
- Block: Message rejected, not sent
-
Mask: Offensive words replaced with
*** - Flag: Message sent but flagged for review
| Score | Risk Level | Automatic Action | User Impact |
|---|---|---|---|
| 0-49% | Low | No action | Message sent normally |
| 50-69% | Medium | Flagged | Message sent, flagged for review |
| 70-89% | High | Hidden + Warning | Message hidden, user warned |
| 90-100% | Critical | Mute user | Message deleted, user temporarily muted |
Configurable by admins - Default actions can be customized per workspace.
You'll see:
โ ๏ธ Your message may violate community guidelines
Your message was flagged for: Profanity
Options:
[Edit Message] [Appeal] [Cancel]
What you can do:
- Edit Message: Revise and resend
- Appeal: Request human review
- Cancel: Don't send the message
When Someone Else's Message Is Hidden
You'll see:
[Hidden message]
This message was hidden by auto-moderation.
Reason: Policy violation
[Show anyway (Admin only)]
Regular users: Cannot see hidden messages Moderators/Admins: Can view and restore if appropriate
Admins and moderators can review flagged content:
- Go to Admin Panel > Moderation Queue
- View all flagged messages
- For each item:
- Approve: Mark as false positive, restore message
- Delete: Confirm violation, keep hidden
- Warn User: Send warning without other action
- Mute User: Temporary or permanent mute
If you believe your message was incorrectly flagged:
- Click "Appeal" on the moderation notice
- Provide context or explanation
- Submit appeal
- Moderator review: Typically within 24 hours
- Notification: You'll be notified of the decision
Tips for successful appeals:
- Explain context (was it a quote, reference, etc.?)
- Be respectful and constructive
- Provide relevant information
AI moderation isn't perfect. Common false positives:
- Technical jargon: "Kill the process", "abort transaction"
- Quotes: Quoting someone else's problematic message
- Non-English: Some languages may be misinterpreted
- Sarcasm: AI may not understand tone
What happens:
- Appeals are reviewed by humans
- False positives are marked to improve the system
- Custom allowlists can be created (admin feature)
Admins can configure:
- Thresholds: Adjust sensitivity (stricter or more lenient)
- Actions: Choose automatic actions per risk level
- Custom word lists: Add blocked or allowed words
- Exemptions: Exclude specific channels or users
- Notifications: Configure who gets notified of violations
See: Admin Guide - AI Management for details
For AI features, we collect:
| Data Type | Purpose | Retention | Shared With |
|---|---|---|---|
| Message content | Summarization, search | Processed, not stored | AI provider (OpenAI/Anthropic) |
| Search queries | Provide search results | Not stored | AI provider (for embeddings) |
| Bot interactions | Command processing | Bot-specific data only | Not shared |
| Moderation data | Detect violations | Stored for audit | Not shared (local processing) |
When you use OpenAI-powered features:
- Messages sent to OpenAI for processing
- OpenAI's data usage policy applies
- Data is NOT used to train OpenAI's models (per enterprise agreement)
- Data is processed and discarded
When you use Anthropic-powered features:
- Messages sent to Anthropic for processing
- Anthropic's data usage policy applies
- Data is NOT used for training
- Data is processed and discarded
When using local fallbacks:
- No data sent to external services
- All processing happens on your device/server
- Complete privacy, but reduced capability
You can: โ Opt out of AI features entirely โ Request data deletion (GDPR right to erasure) โ Export your AI interaction history โ See what data is being processed โ Choose between AI providers
You cannot: โ See other users' AI interactions โ Access raw AI model data โ Opt out of auto-moderation (policy enforcement)
nself-chat is designed for GDPR compliance:
- Right to access: View your AI data in Settings
- Right to erasure: Request deletion of AI-related data
- Right to portability: Export your data in JSON format
- Data minimization: Only necessary data processed
- Consent: Explicit opt-in for optional AI features
For EU users: Data is processed per GDPR Article 6(1)(f) for legitimate interests (security, functionality) and Article 6(1)(a) for optional features (with consent).
Data in transit:
- โ TLS 1.3 encryption
- โ Certificate pinning
- โ End-to-end encryption for DMs (optional)
Data at rest:
- โ Encrypted database storage
- โ Encrypted backups
- โ Access logging and auditing
API communication:
- โ Secure API keys
- โ Rate limiting
- โ Request signing
To manage AI features for yourself:
- Go to Settings > Privacy & AI
- Configure preferences:
AI Features Preferences
Message Summarization
โ Enabled (recommended)
โ Disabled
Reason: Uses AI to help you catch up on conversations
---
Smart Search
โ Semantic search (AI-powered)
โ Keyword search only
โ Disabled
Reason: Understands meaning for better results
---
Bot Interactions
โ Allow bots to see my messages in channels
โ Allow bots to send me direct messages
โ Allow bots to see when I'm online
---
Auto-Moderation
โ Protect me from toxic content (recommended)
โ Filter profanity in messages I see
โ Strict mode (hide more content)
---
Data Usage
โ Send anonymized AI usage data to improve features
โ Allow AI processing of my messages for features
- Click "Save Preferences"
Effect:
- โ No AI-generated summaries
- โ Basic statistical summaries still available
- โ All other features work normally
You'll see: "Summarization disabled in your settings"
Effect:
- โ No semantic search
- โ Keyword search still works
- โ All filters and operators available
You'll see: "Using keyword search (semantic search disabled)"
Effect:
- โ Bots won't respond to your messages
- โ Can't use slash commands
- โ See bot messages from others
- โ All human interactions normal
Note: You CANNOT completely opt out of auto-moderation as it's a workspace policy, but you can adjust how aggressively it filters content YOU see.
Options:
- Normal: Standard filtering
- Relaxed: Less aggressive (more content visible)
- Strict: More aggressive (safer experience)
Admins can control AI features for everyone:
- Go to Admin Panel > AI Configuration
-
Enable/disable features:
- Message Summarization
- Smart Search
- Bot Platform
- Auto-Moderation
- Set defaults for new users
- Require/allow user opt-out
See: Admin Guide - AI Management
Quick disable for a session:
- Click the AI indicator in the top toolbar
- Toggle "Pause AI Features"
- AI features disabled for current session
- Re-enable anytime or automatically after session ends
Use cases:
- Privacy-sensitive conversations
- Testing non-AI functionality
- Reducing distractions
Symptoms: Greyed-out AI buttons, "Not available" messages
Causes & Solutions:
-
Workspace hasn't configured AI
- โ Contact your admin to set up AI providers
- โ Use local fallback features in the meantime
-
You've opted out
- โ Go to Settings > Privacy & AI
- โ Enable desired features
-
AI quota exceeded
- โ Wait for quota reset (usually monthly)
- โ Contact admin about upgrading plan
-
Network issues
- โ Check internet connection
- โ Try refreshing the page
- โ Check if AI provider is experiencing outages
Symptoms: Searches only match exact keywords
Causes & Solutions:
-
No OpenAI API key configured
- โน๏ธ Semantic search requires OpenAI embeddings
- โ Contact admin or use keyword search
-
Search cache full
- โ Clear cache: Settings > Advanced > Clear AI Cache
- โ Admin can increase cache size
-
Query too short
- โ Use at least 2-3 words
- โ Be more specific
Symptoms: Unhelpful or generic summaries
Causes & Solutions:
-
Using local fallback (no AI)
- โน๏ธ Check AI status indicator
- โ Ask admin to configure OpenAI/Anthropic
-
Not enough content
- โ Need at least 5-10 messages for good summaries
- โ Try different time range
-
Messages lack context
- โ AI works best with clear, substantive messages
- โน๏ธ Short "ok", "thanks" messages don't summarize well
-
Wrong summary type
- โ Try different type: Brief vs Detailed vs Bullets
- โ Adjust summary length in settings
Symptoms: Slash commands don't work, bot doesn't reply
Causes & Solutions:
-
Bot disabled
- โ Check if bot is enabled: Admin Panel > Bots
- โ Try in different channel
-
Wrong command syntax
- โ
Type
/helpto see correct syntax - โ Check for typos in command
- โ
Type
-
Bot not in channel
- โ
Invite bot:
/invite @BotName - โ Admin may need to enable bot for channel
- โ
Invite bot:
-
Rate limit hit
- โฐ Wait a few minutes and try again
- โน๏ธ Bots have rate limits to prevent abuse
Symptoms: Your message was hidden or you received a warning unfairly
Causes & Solutions:
-
False positive
- โ Click "Appeal" and explain context
- โ Moderator will review within 24 hours
-
Technical jargon misinterpreted
- โ Rephrase using different terms
- โ Report to admin to add to allowlist
-
Quote or reference
- โ
Use quote formatting:
> quoted text - โ Add context: "As mentioned earlier..."
- โ
Use quote formatting:
If issues persist:
- Check the Status Page: [status.yourworkspace.com]
- Consult documentation: This guide and FAQ
-
Contact support:
- In-app: Help > Contact Support
- Email: [email protected]
- Community: community.nself.org
Include in your support request:
- Description of the issue
- Steps to reproduce
- Screenshots (if applicable)
- Browser/app version
- AI features you're using
Q: Do I need to pay extra for AI features? A: It depends on your workspace's plan. Check with your admin. Personal API keys can be used in some configurations.
Q: Which AI provider is better: OpenAI or Anthropic? A: OpenAI is recommended for full semantic search support. Anthropic is excellent for summarization but doesn't support embeddings yet.
Q: Can I use my own AI API keys? A: Yes, in self-hosted deployments. Cloud/managed deployments use workspace-level keys only.
Q: Are AI features available offline? A: Local fallbacks work offline (keyword search, basic summaries, moderation), but AI-powered features require internet connectivity.
Q: Does nself-chat train AI models on my messages? A: No. We don't train models, and our agreements with OpenAI/Anthropic explicitly prohibit using your data for training.
Q: Can admins see my private messages if AI is enabled? A: No. AI features respect the same privacy boundaries as regular features. Admins cannot see private messages unless they're participants.
Q: Is auto-moderation watching all my messages? A: Auto-moderation scans messages for policy violations (like spam, toxicity) but doesn't store or analyze content beyond that. Think of it like a spam filter.
Q: Where is my data processed? A: Depends on the provider. OpenAI (US), Anthropic (US), or locally (for fallbacks). GDPR-compliant processing for EU users.
Q: Why does summarization sometimes take a long time? A: Large message volumes (100+ messages) take longer to process (5-10 seconds). Caching helps speed up repeated requests.
Q: Can I customize which bots are available? A: Yes, if you're an admin. Go to Admin Panel > Bots to enable/disable specific bots.
Q: How accurate is auto-moderation? A: Very accurate (95%+ for toxicity, 90%+ for spam) but not perfect. False positives are rare and can be appealed.
Q: Can I create my own bots? A: Yes! See the Bot SDK Documentation for a complete guide.
Q: What happens if I hit the AI rate limit? A: You'll see a message like "Rate limit reached. Please try again in a few minutes." Features will temporarily fall back to local implementations.
- Bot SDK Complete Guide - Build your own bots
- Smart Search Guide - Advanced search techniques
- Auto-Moderation Guide - Configure moderation settings
- AI API Documentation - For developers
- Admin Guide - AI Management - Admin controls
๐บ Coming Soon:
- Getting Started with AI Features (3 min)
- Mastering Smart Search (5 min)
- Creating Your First Bot (10 min)
- Understanding Auto-Moderation (4 min)
We're constantly improving AI features. Share your feedback:
- In-app feedback: Help > Send Feedback
- Community forum: community.nself.org/ai-features
- Feature requests: github.com/nself/nself-chat/issues
Last Updated: January 31, 2026 Version: v0.7.0 Next Review: February 28, 2026