Skip to main content

troubleshooting.md

Troubleshooting

Common issues and solutions when using Danbot.

🔧 Common Issues

Bot Not Responding

Symptoms: Danbot doesn't reply to messages

Solutions:

  1. Check bot has proper admin permissions
  2. Verify you're using trigger words (who, what, when, where, why, how, hey, dan)
  3. Try /help to test basic functionality
  4. Check if topic is in silent mode (/listmodes)

Commands Not Working

Symptoms: Commands return errors or no response

Solutions:

  1. Verify you have admin permissions (for admin commands)
  2. Check command syntax
  3. Ensure bot has necessary permissions
  4. Try commands in private chat first

Scam Detection Issues

Symptoms: False positives or missed scams

Solutions:

  1. Adjust sensitivity with /scam warn or /scam mute
  2. Monitor detection patterns
  3. Report false positives to support
  4. Fine-tune based on community needs

Knowledge Base Problems

Symptoms: Poor answers or no responses in support mode

Solutions:

  1. Verify documents uploaded correctly with /loadkb
  2. Check topic is set to support mode (/mode support)
  3. Ensure questions relate to uploaded content
  4. Try rephrasing questions

🆘 Getting Help

Community Support

Before Contacting Support

  1. Check this troubleshooting guide
  2. Try commands in a test environment
  3. Note exact error messages
  4. Provide chat/thread IDs if relevant
  5. Describe steps to reproduce the issue

What to Include in Support Requests

  • Bot version: Check footer of /help output
  • Platform: Telegram or Discord
  • Chat type: Private, group, or supergroup
  • Error messages: Exact text of any errors
  • Steps to reproduce: What you did before the issue
  • Expected behavior: What should have happened