Connect Discord (bot: DMs and server)
Add a Discord bot to Omnifox to handle direct messages and interactions from your server.
This channel connects a Discord bot to Omnifox so the interactions it receives — direct messages and slash commands within your server — land in the Inbox like any other conversation. Setup has two parts: an OAuth authorization to add the bot to your server, and a manual credentials step, since Discord doesn't hand those over through OAuth.
Requirements
- An application created at discord.com/developers
- Admin permissions on the Discord server you're adding the bot to
- That application's Bot Token, Application ID, and Public Key (Ed25519)
Steps to connect
- In Omnifox, go to Channels → Connect New Channel, pick Discord, and click the OAuth connect button.
- Choose the Discord server you want to add the bot to and authorize the requested permissions.
- Discord sends you back to Omnifox with a notice: the bot is now on your server, but the channel still needs its credentials to activate.
- In the Discord developer portal, go to your app → Bot → Reset Token, and copy the Bot Token.
- Also copy the Application ID and, under General Information, the Public Key (hex).
- Paste all three values into Omnifox and save to activate the channel.
Configuration
- Bot Token: authenticates the bot's outbound messages.
- Application ID: identifies your Discord application.
- Public Key (Ed25519, hex): verifies the signature on inbound interactions Discord sends to your webhook.
Example
A user sends your bot a DM asking about the status of a request. That interaction arrives in the Omnifox Inbox as a Discord conversation, ready for an agent to reply.
Tips
- The first request Discord sends your webhook is a verification PING; if the channel doesn't respond, Discord disables the integration.
- Guard the Bot Token carefully — if you regenerate it in Discord, update it in Omnifox too.
Troubleshooting
- The bot shows up on the server but no messages arrive: confirm you pasted the correct Bot Token, Application ID, and Public Key — all three are required to activate the channel.
- Interactions fail signature verification: check that the Public Key you copied belongs to the right app — each app has its own.
Related articles
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
How to connect WhatsApp
Connect your WhatsApp number in minutes with Meta embedded signup, and keep using the phone app thanks to Coexistence.
-
How to connect Email as a shared inbox
Turn your support mailbox into a shared inbox inside Omnifox so your whole team can reply from one place.
-
How to connect SMS
Enable the SMS channel in Omnifox to send and receive text messages from your unified inbox.
-
Connect Instagram, Messenger & Webchat
Add Instagram and Messenger from Meta and install the webchat widget on your website to handle everyone in one place.