Docs

Documentation

Full documentation is in progress. In the meantime, find FAQs and dashboard troubleshooting here.

On this page Frequently asked questions

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:

  1. Grant the bot View Channel and Send Messages permissions.
  2. Reload the page and click Refresh next to the channel list.
  3. 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 inUNAUTHORIZED
Your session has expired. Sign in again.
Session expiredDISCORD_OAUTH_INVALID_GRANT
Your Discord authorization has expired. Sign in and authorize again.
Authorization expiredOAUTH_STATE_INVALID
This authorization page has expired or was already used. Start authorization again from the dashboard.
Permission deniedFORBIDDEN
You do not have permission for this action. Check that you are a server administrator.
Cannot manage this serverDISCORD_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 requiredTWITCH_AUTH_REQUIRED
Connect your Twitch account first. Previous authorization may have expired or been revoked; authorize again.
Insufficient Twitch permissionsTWITCH_SCOPE_MISSING
Some permissions were not granted. Authorize again and allow all requested permissions.
Twitch account mismatchTWITCH_BINDING_MISMATCH
This Twitch account does not own the channel. Authorize using the channel owner's account.

Channel and bot permissions

Channel unavailableCHANNEL_FORBIDDEN
The selected channel was deleted, has an unsupported type, or is hidden from the bot. See the channel-unavailable FAQ above.
Bot cannot accessDISCORD_BOT_MISSING_ACCESS
The bot cannot access this channel or server. Enable View Channel in its channel permissions.
Insufficient bot permissionsDISCORD_BOT_MISSING_PERMISSIONS
The bot lacks permissions for this action. Update its role permissions.
Resource not foundDISCORD_RESOURCE_NOT_FOUND
The channel, role, or message may have been deleted. Configure it again.
Discord connection failedDISCORD_API_ERROR
Discord is not responding correctly. Try again later.

Feature settings

No channel selectedSETTING_CHANNEL_REQUIRED
Select a channel before saving this setting.
Message too longSETTING_TEMPLATE_TOO_LONG
Your custom message exceeds the limit. Shorten it before saving.
Settings not foundSETTING_NOT_FOUND
These settings could not be found. Refresh the page and try again.
Limit reachedGUILD_SOURCE_MAX_REACHED
This server has reached its notification source limit. Remove unused sources first.
Already addedGUILD_SOURCE_ALREADY_EXISTS
This source is already added. Use its existing settings.
Item not foundGUILD_SOURCE_NOT_FOUND
This source may have been deleted. Refresh the page.
Resource busyRESOURCE_LOCKED
This item is being updated. Wait a few seconds and try again.

Connection and system

Too many requestsRATE_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 respondingBAD_GATEWAY
The server is temporarily unavailable. Try again later.
Server errorINTERNAL_SERVER_ERROR
Try again later. If it continues, note the steps you took and contact us.
Invalid request / data not found / unsupported formatBAD_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

Design team

  • .josh0324
  • tbk_lteaa

Technical support

  • final_9.30_percent
  • aka_flybear

Community contributions

  • lulumi_0930
  • hi90865

Community support

  • xiaorui1206
  • HightPingStore
  • imacheng
  • tbk_lteaa

Please contact the maintainer for omissions or corrections.