Aleja developer docs
Three ways to connect other software to Aleja nests:
| Incoming webhooks | Gateway bots | HTTP bots | |
|---|---|---|---|
| What it is | A secret URL that posts into one channel | An account your code signs in as | An app that receives signed events and answers over REST |
| Direction | Post only | Read, reply, react, edit, delete | Slash commands in, replies out |
| End-to-end encrypted | No. The server can read webhook posts | Yes. Keys stay on the machine running the bot | No. Interactions are labeled NOT E2EE |
| Needs code running | No. Any HTTP client works | Yes. A Node.js process using the bot SDK | Yes. Any HTTPS endpoint, in any language |
| Badge in the app | WEBHOOK | BOT | BOT, and NOT E2EE on interactions |
| Who sets it up | Anyone with Manage server in the nest | The owner registers it in the developer portal; someone with Manage server installs it | The same |
Pick a webhook when something only needs to announce events (a deploy finished, a server went down). Pick a gateway bot when it needs to read what people say or keep the conversation private. Pick an HTTP bot for slash commands answered by a stateless service.
Apps are registered and managed in the developer portal, not in the Aleja app.
Pages
- Features and technology: what Aleja does for people, how its privacy model works, and the stack it is built on.
- Limits and quality tiers: character limits by field, upload and storage rules, audio and streaming quality, and what a Goose membership or a Golden Eggs tier changes.
- Incoming webhooks: create a webhook, the request format, errors and limits.
- Bots: how bots work, how they stay end-to-end encrypted, tokens, what they can and can't do, and slash commands.
- Bot SDK reference: build a bot in Node.js. Events, methods, message objects and state storage.
- Platform reference: apps, scopes, OAuth2 installs with PKCE, webhook subscriptions, HMAC-SHA256 signing, retries with exponential backoff, slash commands over HTTP, and the data model.
- Tutorial: an HTTP bot in Rust: from an empty folder to a verified, installed bot that answers slash commands.
- Apps: Watch Together, games and the Doodle Board that people open together in a channel. The catalog, the app SDK, sandboxing, and the HTTP and WebSocket API behind them.
These pages are built into the Aleja server and served at /docs on every API host.