Skip to page content
Docs
Make Agent Fast documentation

Discord

Add a signed /ask interaction to a Discord application and server.

At a glance

Add a signed /ask interaction to a Discord application and server.

Connector routingOne agent, many channels, shared knowledge and inbox
Agent + knowledgeConnector router
Telegram
WhatsApp
Messenger
Discord
KakaoTalk

Create the Discord application#

Follow Discord's official app quick start and interactions overview. Create an application in the Discord Developer Portal and collect:

Make Agent Fast fieldDiscord locationPurpose
Application IDGeneral InformationIdentifies the application and command
Public KeyGeneral InformationVerifies Ed25519-signed interactions; exactly 64 hexadecimal characters
Bot tokenBot pageValidates the application and registers /ask; keep secret

Resetting a bot token invalidates the previous one immediately. The Public Key is not secret, but it must belong to the same application as the bot token.

Connect and register /ask#

Open the site's Connectors page, choose Discord, enter the three values, and select Connect.

Make Agent Fast validates the bot token against Discord's application endpoint and rejects a Public Key that does not match the application. It normalizes a mistyped Application ID to the authenticated application's real ID, then creates or updates the global /ask question command without deleting other application commands.

After saving, copy the displayed Interactions Endpoint URL into General Information → Interactions Endpoint URL in Discord and save. Discord sends a signed PING; Make Agent Fast validates the signature and returns the required PONG.

Install and test#

Use the Discord installation settings to authorize the app in a test server with the permissions required for application commands. Global command propagation can take time.

Run /ask, fill the required question option, and submit. Make Agent Fast acknowledges the interaction before the short Discord deadline, runs the agent, then edits the deferred original response. Conversation history is scoped per Discord user so later /ask requests can retain context.

The current connector is text-only. It does not read voice channels, attachments, ordinary channel messages, or direct messages; only the registered /ask interaction enters the agent.

Rotate or disconnect#

If the bot token is exposed, reset it in Discord, update the connector, and verify /ask again. If the application itself changes, update all three values and the Interactions Endpoint URL for that application.

Disabling or removing the connector does not delete Discord's application or global command. Remove the app from servers and delete obsolete provider credentials separately when decommissioning it.

Troubleshooting#

SymptomFix
Connector rejects the fieldsUse the bot token and 64-character Public Key from the same application
Discord rejects the endpointConfirm public HTTPS, paste the generated endpoint, and re-save credentials before retrying
/ask is missingConfirm command installation/authorization, wait for global propagation, and reconnect to register again
Interaction says the app did not respondCheck the connector is enabled and inspect Make Agent Fast/Discord errors; endpoint signature validation must succeed
Other chat messages are ignoredExpected; the integration handles /ask only
Reply is truncatedDiscord message responses are limited to 2,000 characters

Never expose the bot token in client code, repositories, logs, or screenshots.