My bot isn't responding

If Onyx has stopped responding or never started, work through these checks in order.

1. Check your usage limit

Go to Dashboard → Analytics and check your current usage. If you've hit your monthly usage budget, Onyx will stop responding for the rest of the billing cycle.

You can upgrade your plan or wait for your budget to reset at the start of your next billing period.

2. Check your configured channels

Onyx only responds in channels you have explicitly added in Configuration → Support Channels. If the channel where you're testing isn't listed there, Onyx won't respond to it.

Make sure the channel you're testing is in the list and is enabled.

3. Check your trigger mode

Each channel has a trigger mode setting:

Always replies — Onyx responds to all questions in the channel.
Mentions only — Onyx only responds when directly @mentioned.

If the channel is set to Mentions only, try @mentioning the bot. If that works, the trigger mode is the cause.

4. Check the MessageContent intent

Your bot application needs the Message Content Intent enabled in the Discord Developer Portal.

Go to discord.com/developers/applications.
Select your application.
Go to Bot in the left sidebar.
Under Privileged Gateway Intents, enable Message Content Intent.
Save changes.

Without this intent, the bot receives events but cannot read message text — so it cannot classify or respond to questions.

5. Verify your bot token

If you're using a custom bot, go to Configuration → Custom Bot and check that the token is valid. Tokens expire or become invalid if you reset them in the Discord Developer Portal.

If you've recently regenerated your token in Discord, you need to update it in Onyx as well.

6. Check that the bot is in your server

Make sure your bot is still a member of your Discord server. If it was kicked or the invite link was revoked, it won't receive any events.

Re-invite the bot using the OAuth2 URL from the Discord Developer Portal if needed.

Still not working?

If none of the above resolves it, check the Onyx status page or reach out to support. Include your server ID and the channel name so the issue can be investigated quickly.