Check Bot Permissions:

1. Server Settings → Roles → InterChat

   • ✅ Manage Webhooks
   • ✅ Send Messages
   • ✅ Read Messages
   • ✅ Embed Links

2. Channel-Specific Permissions:

   • Right-click your channel → Edit Channel → Permissions
   • Check InterChat role has necessary permissions
   • Look for red X's that might override server permissions

Fix Steps:

1. Go to Server Settings → Roles
2. Find InterChat role
3. Enable required permissions
4. Check channel overrides
5. Test with a message

If permissions were changed:

/connection edit channel:#your-channel

This refreshes the webhook with current permissions.

Webhook Troubleshooting:

Common Webhook Problems:

• Webhook was manually deleted
• Channel was deleted and recreated

Diagnostic Steps:

1. Check channel settings for webhooks
2. Look for "InterChat" webhook
3. Verify webhook is not disabled

Fix Steps:

/connection edit channel:#your-channel

If that doesn't work:

/disconnect
/connect hub:YourHubName

Hub-Related Issues:

Check Hub Status:

1. Are other servers in the hub active?
2. Has your server been blacklisted?
3. Is the hub experiencing technical issues?

Diagnostic Commands:

/hub servers hub:YourHubName
/blacklist list hub:YourHubName

Contact Hub Moderators:

• Ask in the hub if others are having issues
• Contact hub owner or moderators directly
• Check hub announcements for known issues

If Hub is Down:

• Wait for hub owner to resolve issues
• Consider temporarily connecting to a backup hub
• Monitor hub status through other connected servers

Check Connection Status:

/connection list

If Connection is Paused:

/connection unpause channel:#your-channel

Why Connections Get Paused:

• Manual pausing for maintenance
• Automatic pausing due to errors
• Server administrator action
• Bot restart or update

Prevention:

• Avoid manual pausing unless necessary
• Monitor connection status regularly
• Set up logging to track connection changes

Channel Configuration Issues:

Check Channel Permissions:

• Can InterChat send messages in the channel?
• Are there any message filters or bots interfering?
• Is the channel set to slow mode or restricted?

Channel History:

• Was the channel recently created?
• Did you change channel permissions recently?
• Are there any Discord server boosts affecting features?

Fix Steps:

1. Verify bot can send messages manually
2. Check for conflicting bots or filters
3. Review recent permission changes
4. Test with /connection edit to refresh

Content Filtering Issues:

Hub Content Filters:

• Messages might be blocked by hub anti-swear filters
• NSFW content detection might be active
• Spam filters might be overly aggressive

Check Filter Settings:

/hub config settings hub:YourHubName
/hub config anti-swear hub:YourHubName

Test with Simple Messages:

• Try sending "test" or "hello"
• Avoid links, images, or complex formatting
• Check if specific words are being filtered

Contact Hub Moderators:

• Report potential filter issues
• Ask about recent filter changes
• Request filter adjustment if needed

"You don't have permission to use this command"

For Hub Commands:

• Check if you have the required hub role (Owner/Manager/Moderator)
• Verify you're using the correct hub name
• Confirm you're a member of the hub

For Server Commands:

• Ensure you have "Manage Server" permission
• Check if you're an administrator or have the required role
• Verify the bot recognizes your permissions

Fix Steps:

1. Check your roles in Server Settings
2. Ask a server administrator to verify your permissions
3. For hub commands, contact the hub owner

"You need [specific role] to use this command"

Hub Role Requirements:

• Hub Owner: Full control over hub
• Hub Manager: Most hub management commands
• Hub Moderator: Basic moderation commands

Getting Hub Roles:

Contact hub owner or manager to request role:
/hub moderator add hub:HubName user:@YourName position:moderator

Server Role Requirements:

• Server Administrator: Connection management
• Manage Server: Most server-related commands
• Manage Channels: Channel-specific commands

"Cannot use this command in this channel"

Channel-Specific Restrictions:

• Some commands only work in connected channels
• Others require specific channel types
• Bot may lack permissions in the current channel

Solutions:

1. Try the command in a different channel
2. Use the command in a connected channel if applicable
3. Check channel permissions for the bot
4. Ask an administrator to adjust channel settings

Discord Rate Limiting:

What Happens:

• Discord limits how fast bots can send messages
• High-traffic hubs may hit these limits
• Results in queued messages and delays

Solutions:

• This is normal for very active hubs
• Messages will eventually be delivered
• Consider splitting very large hubs
• Peak times may have longer delays

When to Worry:

• Delays longer than 30 seconds
• Messages never arriving
• Consistent issues across all times

Hub Traffic Management:

High-Traffic Symptoms:

• Delays during peak hours
• Faster delivery during quiet times
• Some servers affected more than others

Management Strategies:

• Encourage quality over quantity in messages
• Consider hub size limits (50-100 servers max)
• Implement content guidelines to reduce spam
• Monitor peak usage times

Hub Owner Actions:

• Enable spam filtering
• Set clear communication guidelines
• Consider creating specialized sub-hubs

Network and Server Issues:

Check External Factors:

• Discord server status
• Your internet connection stability
• Server hosting issues (for self-hosted instances)

Diagnostic Steps:

1. Test with other Discord bots
2. Check Discord status page
3. Try from different devices/networks
4. Monitor for patterns in delays

When to Contact Support:

• Consistent delays across all conditions
• Complete message delivery failure
• Issues affecting multiple hubs