Slack channels are living archives of how your organization talks about customers, competitors, products, and wins. These five jobs pull conversation history from Slack’s Web API into Mavera’s surfaces (Mave Agent, Personas, Focus Groups, Brand Voice, Generate) to mine sales channels for messaging playbooks, categorize support pain points by persona, validate product feedback with synthetic focus groups, enrich competitive intelligence, and extract brand voice from win/loss narratives.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.
API Reference Card
| Detail | Value |
|---|---|
| Base URL | https://slack.com/api/{method} |
| Auth | OAuth 2.0 — Bot tokens (xoxb-...) or User tokens (xoxp-...) |
| Rate limits | Tier 1: 1 req/min, Tier 2: 20 req/min, Tier 3: 50 req/min, Tier 4: 100+ req/min |
| Key methods | conversations.history, conversations.list, conversations.replies, users.info |
| Mavera base | https://app.mavera.io/api/v1 |
| Mavera auth | Authorization: Bearer mvra_live_... |
All examples use
SLACK_BOT_TOKEN (a bot token with channels:history, channels:read, users:read scopes) and MAVERA_API_KEY. Bot tokens require the bot to be invited to each channel. User tokens access all channels the user belongs to.Prerequisites
Slack app with bot token
Create an app at api.slack.com/apps. Add Bot Token Scopes:
channels:history, channels:read, groups:history, groups:read, users:read. Install to workspace.Invite bot to channels
The bot must be in each channel it reads. Use
/invite @your-bot in target channels.Identify channel IDs
Use
conversations.list or right-click a channel in Slack → “View channel details” → copy the Channel ID from the bottom.Mavera API key
Get your key from Mavera dashboard.
Jobs
| # | Job | Slack Data | Mavera Surface | Output |
|---|---|---|---|---|
| 1 | Sales Channel → Messaging Playbook | conversations.history | Mave Agent (Chat) | Sales messaging playbook |
| 2 | Support Channel → Persona Pain Points | conversations.history | Mave Agent (Chat) | Pain point categorization by persona |
| 3 | Product Feedback → Focus Group | conversations.history | Focus Groups | Validated feature priority list |
| 4 | Competitive Intelligence → Research Brief | conversations.history | Mave Agent (Chat) | Competitive research brief |
| 5 | Win/Loss Notes → Brand Voice | conversations.history | Brand Voice | Win/loss-derived brand voice |
Rate Limits & Production Notes
| Slack Method | Tier | Limit | Strategy |
|---|---|---|---|
conversations.history | Tier 3 | 50 req/min | Paginate with 200/page; 1s delay |
conversations.list | Tier 2 | 20 req/min | Cache channel list daily |
conversations.replies | Tier 3 | 50 req/min | Only fetch for threaded messages |
users.info | Tier 4 | 100+ req/min | Cache user lookups |