> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valyu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Bot Integration

> Install the hosted Valyu Slack bot to run scheduled deep research reports and chat-driven research in Slack

## Overview

The Valyu Slack AI agent lets your team run DeepResearch directly inside Slack. You can schedule recurring reports, deliver them to channels or DMs, and chat with the bot for on-demand research.

Hosted app URL: `https://slack.valyu.ai`

<Note>
  Each Slack workspace brings its own Valyu API key from
  [platform.valyu.ai](https://platform.valyu.ai), so usage stays scoped to that
  workspace. You can add it to as many workspaces as you like!
</Note>

## What you get

* Scheduled deep research reports per channel or DM
* Multiple reports per workspace with separate prompts and schedules
* App Home dashboard to add, edit, pause, resume, and delete reports
* Interactive bot replies in DMs and when mentioned in channels
* Research modes: `fast`, `standard`, `heavy`, and `max`

## Quick install

<Steps>
  <Step title="Install the app in Slack">
    Open <a href="https://slack.valyu.ai/api/slack/install">Add to Slack</a> and approve access for your workspace.
  </Step>

  <Step title="Configure your API key">
    In Slack, open the app's <strong>Home</strong> tab, click <strong>Configure Valyu API Key</strong>, and save your key.
  </Step>

  <Step title="Create your first report">
    Click <strong>Add Report</strong> and set destination, query, mode, schedule time, and timezone.
  </Step>

  <Step title="Invite bot to destination channels">
    In each target channel, run <code>/invite @your-bot-name</code> so the bot can post report updates.
  </Step>

  <Step title="Preview before schedule (optional)">
    Use <strong>Preview now</strong> from the Home tab to validate output and delivery.
  </Step>
</Steps>

## Report configuration

| Field             | Description                                       |
| ----------------- | ------------------------------------------------- |
| Destination       | Channel or DM for report delivery                 |
| Research prompt   | The deep research query/instructions              |
| Mode              | `fast`, `standard`, `heavy`, or `max`             |
| Daily report time | Time in `HH:MM` format                            |
| Timezone          | IANA timezone, or use your Slack profile timezone |

## Chat with the bot

After installation, you can use the bot in two ways:

* Mention it in channels for thread-based research help
* Send a DM for direct back-and-forth research support

## Resources

<CardGroup cols={2}>
  <Card title="Hosted app" icon="globe" href="https://slack.valyu.ai/">
    Open the Slack bot landing page
  </Card>

  <Card title="Add to Slack" icon="slack" href="https://slack.valyu.ai/api/slack/install">
    Install the bot to your workspace
  </Card>

  <Card title="Get Valyu API key" icon="key" href="https://platform.valyu.ai">
    Create or manage workspace API keys
  </Card>

  <Card title="Support" icon="book" href="https://slack.valyu.ai/support">
    Contact support for installation help
  </Card>
</CardGroup>