Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mavera.io/llms.txt

Use this file to discover all available pages before exploring further.

Discord communities are where your most engaged users live — sharing feedback, asking questions, reporting bugs, and requesting features in real time. These four jobs pull messages from Discord’s REST API into Mavera’s surfaces (Mave Agent, Brand Voice, Generate, Focus Groups) to analyze community sentiment, extract persona-authentic language from voice transcripts, auto-generate FAQs from community questions, and mine feature requests for product focus groups.

API Reference Card

DetailValue
Base URLhttps://discord.com/api/v10
AuthBot Token (Bot {token}) or OAuth 2.0 Bearer
Rate limits50 req/sec global; per-route limits vary (see headers)
Key endpoints/channels/{id}/messages, /guilds/{id}/channels, /users/@me
Mavera basehttps://app.mavera.io/api/v1
Mavera authAuthorization: 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

1

Discord bot application

Create a bot at discord.com/developers/applications. Under “Bot”, enable MESSAGE CONTENT INTENT and copy the bot token.
2

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.
3

Guild and Channel IDs

Enable Developer Mode in Discord (Settings → Advanced → Developer Mode). Right-click channels/guilds to copy IDs.
4

Mavera API key

Get your key from Mavera dashboard.
5

Environment variables

export DISCORD_BOT_TOKEN="your-bot-token"
export DISCORD_GUILD_ID="your-guild-id"
export MAVERA_API_KEY="mvra_live_xxxxx"

Jobs

#JobDiscord DataMavera SurfaceOutput
1Community Sentiment AnalysisChannel messagesMave Agent (Chat)Weekly sentiment report
2Voice Transcript → Persona LanguageTranscripts (external)Brand VoiceCommunity-authentic brand voice
3Community Questions → FAQ GenerationChannel messagesMave Agent + GenerateAuto-generated FAQ
4Feature Request Mining → Product Focus GroupChannel messagesFocus GroupsRanked feature priority list

Rate Limits & Production Notes

Discord EndpointLimitStrategy
GET /channels/{id}/messages50 req/sec global; 5 req/sec per route500ms delay; handle 429 with retry_after
GET /guilds/{id}/channels50 req/sec globalCache channel list daily
GET /guilds/{id}/members10 req/secCache member data; batch lookups
Discord enforces rate limits per-route with global cap of 50 req/sec. Always check for 429 responses and respect retry_after. The MESSAGE_CONTENT intent is required for reading message content in guilds with 100+ members — enable it in the Developer Portal or you’ll get empty strings. Bot must be a guild member with Read Message History permission. Store bot tokens in env vars. Monitor Mavera credits at Dashboard.

All Integrations

Discord API Docs

Brand Voice

Focus Groups

Mave Agent

Generate