API Reference Card
| Detail | Value |
|---|---|
| Base URL | https://discord.com/api/v10 |
| Auth | Bot Token (Bot {token}) or OAuth 2.0 Bearer |
| Rate limits | 50 req/sec global; per-route limits vary (see headers) |
| Key endpoints | /channels/{id}/messages, /guilds/{id}/channels, /users/@me |
| Mavera base | https://app.mavera.io/api/v1 |
| Mavera auth | Authorization: Bearer mvra_live_... |
All examples use
DISCORD_BOT_TOKEN (a bot token with MESSAGE_CONTENT intent enabled) and MAVERA_API_KEY. Bot must be added to the guild with Read Message History and Read Messages/View Channels permissions. Enable the Message Content Intent in your app’s settings at discord.com/developers.Prerequisites
Discord bot application
Create a bot at discord.com/developers/applications. Under “Bot”, enable
MESSAGE CONTENT INTENT and copy the bot token.Bot permissions
When generating the invite URL, select:
Read Messages/View Channels, Read Message History. For voice transcripts (Job 2), you’ll need a separate transcription service.Guild and Channel IDs
Enable Developer Mode in Discord (Settings → Advanced → Developer Mode). Right-click channels/guilds to copy IDs.
Mavera API key
Get your key from Mavera dashboard.
Jobs
| # | Job | Discord Data | Mavera Surface | Output |
|---|---|---|---|---|
| 1 | Community Sentiment Analysis | Channel messages | Mave Agent (Chat) | Weekly sentiment report |
| 2 | Voice Transcript → Persona Language | Transcripts (external) | Brand Voice | Community-authentic brand voice |
| 3 | Community Questions → FAQ Generation | Channel messages | Mave Agent + Generate | Auto-generated FAQ |
| 4 | Feature Request Mining → Product Focus Group | Channel messages | Focus Groups | Ranked feature priority list |
Rate Limits & Production Notes
| Discord Endpoint | Limit | Strategy |
|---|---|---|
GET /channels/{id}/messages | 50 req/sec global; 5 req/sec per route | 500ms delay; handle 429 with retry_after |
GET /guilds/{id}/channels | 50 req/sec global | Cache channel list daily |
GET /guilds/{id}/members | 10 req/sec | Cache member data; batch lookups |