# Discord Integration

KAEL and AeThex Bot provide related but distinct Discord capabilities.

| Field | Value |
|---|---|
| Product maturity | Live / evolving |
| Documentation status | Active |
| Community | [discord.gg/athx](https://discord.gg/athx) |
| AeThex Bot | [aethex.bot](https://aethex.bot) |
| Last verified | 2026-06-26 |

## Choose the integration

| Surface | Use it for |
|---|---|
| AeThex Bot | General Discord-community automation and community-facing integrations |
| KAEL Discord application | AeThex intelligence commands backed by the KAEL service |
| AeThex community | Direct participation in the official AeThex Discord |

## Current KAEL commands

The API currently implements Discord interaction handling for:

- `/kael` — ask KAEL using the caller’s Discord identity as session context.
- `/ask` — route a question through the deeper reasoning mode.
- `/status` — check the configured AeThex service set.
- `/agent` — run a bounded agent goal and return the result to Discord.

Command availability depends on which commands are registered for the Discord application.

## Interaction security

The Discord endpoint:

- Accepts Discord interaction payloads at `/discord/interactions`.
- Verifies Discord’s Ed25519 request signature and timestamp.
- Rejects unsigned or invalid requests.
- Defers long-running commands before posting the final response.

Never expose the Discord bot token, application credentials, signing keys, or webhook URLs in documentation, browser code, screenshots, or issue reports.

## Session behavior

KAEL derives a Discord session identifier from the Discord user ID. Recent messages may be retained as conversational history for that session. Discord responses are truncated to fit Discord message limits.

## Community installation

Public self-service installation behavior should be documented on [aethex.bot](https://aethex.bot). Do not assume the KAEL Discord application is available for arbitrary third-party installation unless the application’s installation flow explicitly offers it.

## Related documentation

- [[KAEL]]
- [[KAEL Architecture]]
- [[KAEL Safety]]
- [[Webhooks]]
- [[Security]]