Blame
|
1 | # Discord Integration |
||||||
| 2 | ||||||||
| 3 | KAEL and AeThex Bot provide related but distinct Discord capabilities. |
|||||||
| 4 | ||||||||
| 5 | | Field | Value | |
|||||||
| 6 | |---|---| |
|||||||
| 7 | | Product maturity | Live / evolving | |
|||||||
| 8 | | Documentation status | Active | |
|||||||
| 9 | | Community | [discord.gg/athx](https://discord.gg/athx) | |
|||||||
| 10 | | AeThex Bot | [aethex.bot](https://aethex.bot) | |
|||||||
| 11 | | Last verified | 2026-06-26 | |
|||||||
| 12 | ||||||||
| 13 | ## Choose the integration |
|||||||
| 14 | ||||||||
| 15 | | Surface | Use it for | |
|||||||
| 16 | |---|---| |
|||||||
| 17 | | AeThex Bot | General Discord-community automation and community-facing integrations | |
|||||||
| 18 | | KAEL Discord application | AeThex intelligence commands backed by the KAEL service | |
|||||||
| 19 | | AeThex community | Direct participation in the official AeThex Discord | |
|||||||
| 20 | ||||||||
| 21 | ## Current KAEL commands |
|||||||
| 22 | ||||||||
| 23 | The API currently implements Discord interaction handling for: |
|||||||
| 24 | ||||||||
| 25 | - `/kael` — ask KAEL using the caller’s Discord identity as session context. |
|||||||
| 26 | - `/ask` — route a question through the deeper reasoning mode. |
|||||||
| 27 | - `/status` — check the configured AeThex service set. |
|||||||
| 28 | - `/agent` — run a bounded agent goal and return the result to Discord. |
|||||||
| 29 | ||||||||
| 30 | Command availability depends on which commands are registered for the Discord application. |
|||||||
| 31 | ||||||||
| 32 | ## Interaction security |
|||||||
| 33 | ||||||||
| 34 | The Discord endpoint: |
|||||||
| 35 | ||||||||
| 36 | - Accepts Discord interaction payloads at `/discord/interactions`. |
|||||||
| 37 | - Verifies Discord’s Ed25519 request signature and timestamp. |
|||||||
| 38 | - Rejects unsigned or invalid requests. |
|||||||
| 39 | - Defers long-running commands before posting the final response. |
|||||||
| 40 | ||||||||
| 41 | Never expose the Discord bot token, application credentials, signing keys, or webhook URLs in documentation, browser code, screenshots, or issue reports. |
|||||||
| 42 | ||||||||
| 43 | ## Session behavior |
|||||||
| 44 | ||||||||
| 45 | 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. |
|||||||
| 46 | ||||||||
| 47 | ## Community installation |
|||||||
| 48 | ||||||||
| 49 | 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. |
|||||||
| 50 | ||||||||
| 51 | ## Related documentation |
|||||||
| 52 | ||||||||
| 53 | - [[KAEL]] |
|||||||
| 54 | - [[KAEL Architecture]] |
|||||||
| 55 | - [[KAEL Safety]] |
|||||||
| 56 | - [[Webhooks]] |
|||||||
| 57 | - [[Security]] |
|||||||