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

# Slack

> 5 production-ready jobs — sales channel mining for messaging playbooks, customer support persona pain points, product feedback focus groups, competitive intelligence research briefs, and win/loss brand voice extraction

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

| 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_...`                                                |

<Info>
  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.
</Info>

***

## Prerequisites

<Steps>
  <Step title="Slack app with bot token">Create an app at [api.slack.com/apps](https://api.slack.com/apps). Add Bot Token Scopes: `channels:history`, `channels:read`, `groups:history`, `groups:read`, `users:read`. Install to workspace.</Step>
  <Step title="Invite bot to channels">The bot must be in each channel it reads. Use `/invite @your-bot` in target channels.</Step>
  <Step title="Identify channel IDs">Use `conversations.list` or right-click a channel in Slack → "View channel details" → copy the Channel ID from the bottom.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>

  <Step title="Environment variables">
    ```bash theme={"dark"}
    export SLACK_BOT_TOKEN="xoxb-your-bot-token"
    export MAVERA_API_KEY="mvra_live_xxxxx"
    ```
  </Step>
</Steps>

***

## Jobs

| # | Job                                                                  | Slack Data            | Mavera Surface    | Output                               |
| - | -------------------------------------------------------------------- | --------------------- | ----------------- | ------------------------------------ |
| 1 | [Sales Channel → Messaging Playbook](sales-channel-playbook)         | conversations.history | Mave Agent (Chat) | Sales messaging playbook             |
| 2 | [Support Channel → Persona Pain Points](support-channel-pain-points) | conversations.history | Mave Agent (Chat) | Pain point categorization by persona |
| 3 | [Product Feedback → Focus Group](product-feedback-focus-group)       | conversations.history | Focus Groups      | Validated feature priority list      |
| 4 | [Competitive Intelligence → Research Brief](competitive-intel-brief) | conversations.history | Mave Agent (Chat) | Competitive research brief           |
| 5 | [Win/Loss Notes → Brand Voice](win-loss-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               |

<Warning>
  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](https://app.mavera.io/settings/usage).
</Warning>

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="Slack API Docs" icon="hashtag" href="https://api.slack.com/methods" />

  <Card title="Brand Voice" icon="microphone" href="/features/brand-voice" />

  <Card title="Focus Groups" icon="users" href="/features/focus-groups" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />

  <Card title="Generate" icon="pen" href="/features/generate" />
</CardGroup>