🐛 Bot not receiving mention events - Check Bot visibility settings

[IvyGain]

Description

Even with correct permissions configured, the bot may not receive messages because of Bot visibility or capability settings in Lark Open Platform.

Checklist

Please verify the following settings in Lark Open Platform Console:

1. Bot Capability (ボット機能)

• Go to: App Features → Bot
• Ensure "Enable Bot" is turned ON
• Bot card message sending must be enabled

2. Bot Visibility (可用範囲)

• Go to: Security Settings → Availability
• Ensure the bot is visible to:
  • All users in organization
  • OR specific users/departments that include you

3. Event Subscription URL

• Go to: Events & Callbacks → Event Configuration
• Request URL should be: `https://larkmastermcp-production.up.railway.app/webhook/event\`
• Status should show "Verified" ✅

4. Required Events

Ensure these events are subscribed:

• `im.message.receive_v1` - Receive messages
• `im.chat.member.bot.added_v1` - Bot added to chat (optional)

5. Permission Scopes

Required scopes:

• `im:message` - Read messages
• `im:message:send_as_bot` - Send messages as bot
• `im:chat:readonly` - Read chat info

6. App Status

• The app must be Published or have proper Test user settings
• Go to: App Release → Version Management
• Ensure the app version is published/available

Debugging Steps

1. Check Railway logs for incoming webhook requests:

   railway logs
   

2. If no webhooks are being received:

   • The Lark console configuration is wrong
   • The bot is not visible to the user
   • The app is not published

3. If webhooks are received but bot doesn't respond:

   • Check for AttributeError (see Issue 🐛 CRITICAL: LarkRemoteMCPServer missing minutes_handler attribute #5)
   • Check API response codes in logs

Priority

HIGH - Main user issue