Skip to main content
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.

​
API Reference Card

DetailValue
Base URLhttps://slack.com/api/{method}
AuthOAuth 2.0 — Bot tokens (xoxb-...) or User tokens (xoxp-...)
Rate limitsTier 1: 1 req/min, Tier 2: 20 req/min, Tier 3: 50 req/min, Tier 4: 100+ req/min
Key methodsconversations.history, conversations.list, conversations.replies, users.info
Mavera basehttps://app.mavera.io/api/v1
Mavera authAuthorization: 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

1

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

Invite bot to channels

The bot must be in each channel it reads. Use /invite @your-bot in target channels.
3

Identify channel IDs

Use conversations.list or right-click a channel in Slack → “View channel details” → copy the Channel ID from the bottom.
4

Mavera API key

Get your key from Mavera dashboard.
5

Environment variables

export SLACK_BOT_TOKEN="xoxb-your-bot-token"
export MAVERA_API_KEY="mvra_live_xxxxx"

​
Jobs

#JobSlack DataMavera SurfaceOutput
1Sales Channel → Messaging Playbookconversations.historyMave Agent (Chat)Sales messaging playbook
2Support Channel → Persona Pain Pointsconversations.historyMave Agent (Chat)Pain point categorization by persona
3Product Feedback → Focus Groupconversations.historyFocus GroupsValidated feature priority list
4Competitive Intelligence → Research Briefconversations.historyMave Agent (Chat)Competitive research brief
5Win/Loss Notes → Brand Voiceconversations.historyBrand VoiceWin/loss-derived brand voice

​
Rate Limits & Production Notes

Slack MethodTierLimitStrategy
conversations.historyTier 350 req/minPaginate with 200/page; 1s delay
conversations.listTier 220 req/minCache channel list daily
conversations.repliesTier 350 req/minOnly fetch for threaded messages
users.infoTier 4100+ req/minCache user lookups
Bot tokens must be invited to each channel. Use conversations.list to discover available channels, not hardcoded IDs. Messages older than 90 days may require a Slack paid plan to access. Strip PII before sending to external APIs. The conversations.history method returns messages in reverse chronological order — sort by ts for chronological processing. Monitor Mavera credits at Dashboard.

All Integrations

Slack API Docs

Brand Voice

Focus Groups

Mave Agent

Generate