Frequently asked questions
What if Message Guardian flags a safe image?
Message Guardian checks images against known scam samples and watches for repeated images across channels in a short time. False positives on normal images are rare, but no matching system can eliminate them entirely.
When nekoHaru hides a message or applies a timeout, it sends a card to the configured admin channel. If the image is safe:
- Click“❌ Not a scam”on the card to send us a report.
- If a member was timed out, click“🔓 Remove timeout” to restore access immediately, without waiting.
Reports are recorded to improve detection. Repeated cases across servers get priority. Your feedback helps every server using nekoHaru.
Want to avoid false positives?When discussing scam examples, mark images as spoilers to exclude them from scam-image matching. Repeating an image across channels in a short time may still trigger spam detection.
Channel unavailable when configuring a channel
The selected channel cannot currently be used. Common reasons:
- The channel was deleted or its type is unsupported, such as selecting a voice channel.
- The bot lacks View Channel permission.
- The channel was just created or changed, but the list is out of date.
Try these steps in order:
- Grant the bot View Channel and Send Messages permissions.
- Reload the page and click Refresh next to the channel list.
- Reselect all channel fields for this feature and save,even if the same channel is already shown。
If the error persists, contact the developer.
YouTube custom-template notifications are not sentFixed
Previously, if a custom template contained@everyone or@hereand the bot lacked permission to mention @everyone, @here, and all roles, Discord rejected the entire notification.
Since September 6, 2026, nekoHaru instead retrieswithout mentions. The notification is delivered without pinging members. Grant the permissions above to enable mentions.
Error reference
Match a dashboard error's title with the table below. If it persists, contact us with the title and the steps you took.
Sign-in and authorization
- Not signed in
UNAUTHORIZED - Your session has expired. Sign in again.
- Session expired
DISCORD_OAUTH_INVALID_GRANT - Your Discord authorization has expired. Sign in and authorize again.
- Authorization expired
OAUTH_STATE_INVALID - This authorization page has expired or was already used. Start authorization again from the dashboard.
- Permission denied
FORBIDDEN - You do not have permission for this action. Check that you are a server administrator.
- Cannot manage this server
DISCORD_BOT_NOT_IN_GUILD_OR_NO_ACCESS - The bot is not in this server, or you lack management permissions. Invite the bot again or check your permissions.
Twitch authorization
- Twitch authorization required
TWITCH_AUTH_REQUIRED - Connect your Twitch account first. Previous authorization may have expired or been revoked; authorize again.
- Insufficient Twitch permissions
TWITCH_SCOPE_MISSING - Some permissions were not granted. Authorize again and allow all requested permissions.
- Twitch account mismatch
TWITCH_BINDING_MISMATCH - This Twitch account does not own the channel. Authorize using the channel owner's account.
Channel and bot permissions
- Channel unavailable
CHANNEL_FORBIDDEN - The selected channel was deleted, has an unsupported type, or is hidden from the bot. See the channel-unavailable FAQ above.
- Bot cannot access
DISCORD_BOT_MISSING_ACCESS - The bot cannot access this channel or server. Enable View Channel in its channel permissions.
- Insufficient bot permissions
DISCORD_BOT_MISSING_PERMISSIONS - The bot lacks permissions for this action. Update its role permissions.
- Resource not found
DISCORD_RESOURCE_NOT_FOUND - The channel, role, or message may have been deleted. Configure it again.
- Discord connection failed
DISCORD_API_ERROR - Discord is not responding correctly. Try again later.
Feature settings
- No channel selected
SETTING_CHANNEL_REQUIRED - Select a channel before saving this setting.
- Message too long
SETTING_TEMPLATE_TOO_LONG - Your custom message exceeds the limit. Shorten it before saving.
- Settings not found
SETTING_NOT_FOUND - These settings could not be found. Refresh the page and try again.
- Limit reached
GUILD_SOURCE_MAX_REACHED - This server has reached its notification source limit. Remove unused sources first.
- Already added
GUILD_SOURCE_ALREADY_EXISTS - This source is already added. Use its existing settings.
- Item not found
GUILD_SOURCE_NOT_FOUND - This source may have been deleted. Refresh the page.
- Resource busy
RESOURCE_LOCKED - This item is being updated. Wait a few seconds and try again.
Connection and system
- Too many requests
RATE_LIMIT - You have made too many requests. Wait a moment and try again.
- Cannot connect to server
— - Check your internet connection and try again. If it works, check our service status page.
- Server not responding
BAD_GATEWAY - The server is temporarily unavailable. Try again later.
- Server error
INTERNAL_SERVER_ERROR - Try again later. If it continues, note the steps you took and contact us.
- Invalid request / data not found / unsupported format
BAD_REQUEST and similar errors - The page data is usually out of date. Refresh and try again.
- An unexpected error occurred
— - Try again later. If it continues, note the steps you took and contact us.
Special thanks
Names are not ranked by contribution.
Homepage development
- tbk_lteaa
- imacheng
- aka_flybear
Technical support
- final_9.30_percent
- aka_flybear
Community support
- xiaorui1206
- HightPingStore
- imacheng
- tbk_lteaa
Please contact the maintainer for omissions or corrections.