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

# Channels (Slack & WhatsApp)

> Connect your agent to Slack and WhatsApp so it responds in your team's chat tools

# Channels

Aivah's **Channels** integration (`Side nav → Integrations → Channels`, or `/integrations/channels`) lets an agent respond directly inside the chat tools your audience already uses. Two channels are supported out of the box: **Slack** and **WhatsApp**.

Each channel appears as a collapsible card. Inside every card you select:

* **Agent** – which agent will respond on that channel
* **LLM model** – the model pinned to that channel for consistent behaviour

Toggle the **Active** switch to enable or disable a channel without losing its configuration.

<Frame caption="Channels page – Slack card with Member ID / Bot Token / Signing Secret, and WhatsApp card below">
  <img src="https://mintcdn.com/opinionai/tR4nAAll3jemMkvA/images/channels-page.png?fit=max&auto=format&n=tR4nAAll3jemMkvA&q=85&s=3119a2645aa652e3d96f040b81dc2681" alt="Channels page" width="4112" height="2658" data-path="images/channels-page.png" />
</Frame>

## Slack

The Slack card includes a **Slack Setup Guide** that expands to step-by-step instructions. The configuration is a one-time exchange of three values between Slack and Aivah.

### What you'll need from Slack

| Value              | Where to find it                                                                        |
| ------------------ | --------------------------------------------------------------------------------------- |
| **Member ID**      | Your Slack profile page (under the kebab menu → *Copy member ID*)                       |
| **Bot Token**      | Slack app → *OAuth & Permissions* → *Install App* page, after installing to a workspace |
| **Signing Secret** | Slack app → *Basic Information* → *App Credentials*                                     |

### Setup steps

<Steps>
  <Step title="Create the Slack app">
    Go to <a href="https://api.slack.com/apps">[https://api.slack.com/apps](https://api.slack.com/apps)</a> and click **Create New App** → **From an app manifest**. Paste the **App Manifest** copied from the Slack card in Aivah.

    The manifest pre-configures the bot scopes, the slash command `/aivah`, event subscriptions, and the request URL that points back to Aivah.
  </Step>

  <Step title="Install the app to your workspace">
    Inside the new Slack app, open **Install App** and authorize installation. Slack issues the **Bot Token** here.
  </Step>

  <Step title="Configure Aivah">
    Back in the Slack card on the Channels page, paste:

    * **Member ID** – your Slack profile member id
    * **Bot Token** – from Slack's *Install App* page
    * **Signing Secret** – from Slack's *Basic Information → App Credentials*

    Save the configuration.
  </Step>

  <Step title="Invite the bot to a channel">
    In any Slack channel run `/invite @aivah-bot`. The bot only listens in channels it has been explicitly invited to.
  </Step>

  <Step title="Talk to the agent">
    Use `/aivah` followed by your question. The bot replies in-thread with the same intelligence as the agent in the Playground.
  </Step>

  <Step title="Toggle Active">
    Flip the **Active** switch in the Slack card. The channel is now live.
  </Step>
</Steps>

### Troubleshooting Slack

* **Bot does not respond** – confirm the bot was invited (`/invite @aivah-bot`), the **Active** toggle is on in Aivah, and the *Bot Token* / *Signing Secret* you pasted match what Slack shows. Re-install the Slack app if you regenerated tokens.
* **Manifest changes** – if you edit the manifest after install, you'll be prompted to re-install. Repeat the steps above to refresh the tokens.

## WhatsApp

WhatsApp uses **QR pairing** – there are no tokens to copy. The Aivah card walks you through the handshake:

<Steps>
  <Step title="Click Connect">
    The panel switches to *Connecting…* and renders a **QR code**.
  </Step>

  <Step title="Pair your phone">
    On your phone open **WhatsApp** → **Linked Devices** → **Link a device** → scan the QR.
  </Step>

  <Step title="Confirm pairing">
    The status flips to **Connected** and the card shows the linked phone number.
  </Step>

  <Step title="Manage the link">
    Two extra controls appear once paired:

    * **Refresh** – fetches a new QR if the current one expires
    * **Power** – disconnects the linked phone
  </Step>
</Steps>

<Tip>
  Aivah polls WhatsApp pairing every 2 seconds during the connection flow, so the status updates almost in real time. If the QR expires before you scan it, just hit **Refresh** to mint a new one.
</Tip>

### Troubleshooting WhatsApp

* **QR expired** – click **Refresh** in the WhatsApp panel; a fresh QR is generated and the status returns to *qr\_ready*.
* **Phone shows "device removed"** – use **Power** to disconnect on the Aivah side, then re-run the **Connect** flow.
* **Messages stop arriving** – verify the linked phone is online and on a recent WhatsApp version. Pairings expire if the device stays offline for a long time.

## Per-channel agent & model

Both Slack and WhatsApp cards expose:

* **Agent** – select any agent in your workspace, including knowledge-base and presenter agents.
* **LLM model** – pin a model so the channel always speaks with the same brain.

You can run different agents on different channels (for example a sales agent on WhatsApp and an internal helper on Slack) without affecting the agents themselves.

## Related guides

* [Agents](/knowledge-agent/overview)
* [Twilio Phone Setup](/integration/twilio-phone-setup) for telephony
* [MCP Tools](/integration/mcp-tools) for extending the agent with external apps