Chattr Developer Platform
Chattr apps come in four kinds:
- Webhooks: post messages into one text channel with a URL.
- Integrations: use Bearer tokens to manage server members.
- Widgets: push pre-defined counter/status rows to a pinned sidebar tile.
- OAuth apps: identify Chattr users on external sites.
Quick map
- Start with Webhooks if you only need to send messages.
- Use Integrations if you need to sync roles, nicknames, or moderation state.
- Use Widgets to surface monitoring numbers (online count, build status, uptime) at a glance.
- Add OAuth if your website needs to know which Chattr account is connected.
Who can create and manage apps
| App type | Who can create | Who can manage |
|---|---|---|
| Webhook | Any member with manage_server permission |
Same — manage_server on that server |
| Integration | Any member with manage_server permission |
Same — manage_server on that server |
| Widget | Any member with manage_server permission |
Same — manage_server on that server |
| OAuth | Any phone-verified user | Only the app owner |
The manage_server permission is automatically granted to server owners and administrators. It can also be assigned to any custom role.
Security model
- Server-scoped actions are granted explicitly by server managers.
- Third-party OAuth is identity-only.
- Only the first-party Chattr developer portal receives user access tokens.
URLs
- Public OAuth authorization:
/oauth/authorize - OAuth token exchange:
/oauth/token - Runtime webhook posts:
/webhooks/:appId/:token - Runtime widget posts:
/widgets/:appId/:token - Management APIs:
/api/apps/*