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

# Use Backstage from Slack or iMessage

> Connect Backstage to Slack or iMessage to ask about your Chatbase AI agent, approve changes, and get audit reports without opening the dashboard.

You can talk to your AI agent's Backstage from a Slack DM or a text message, without opening the Chatbase dashboard. Ask questions, review analytics, change your AI agent, and approve changes from the apps you already use. Each person connects their own Slack or iMessage account from the **Controllers** dialog on the Backstage page.

This is separate from deploying your AI agent to customers on Slack. For that, see [Slack](https://chatbase.co/docs/user-guides/integrations/slack.md).

## What you can do from a DM or a text

> [card] Analyze your AI agent
>
> Ask questions like **"How did my AI agent do this week?"** or **"What did users ask about most?"** Charts and reports are delivered in the conversation.

> [card] Update your AI agent
>
> Change models, instructions, chat interface, branding, and other settings in plain language. Changes need your approval unless [auto mode](https://chatbase.co/docs/user-guides/chatbot/backstage/approvals-and-auto-mode.md#auto-mode) covers them.

> [card] Manage sources and Actions
>
> Inspect, update, and retrain knowledge sources, and manage Actions without opening the dashboard.

> [card] Approve safely
>
> Review exactly what's changing before approving. Outside of auto mode, nothing is applied without your explicit confirmation.

> [card] Analyze files (Slack)
>
> Upload a CSV or other supported file and ask questions about its contents from Slack.

> [card] Continue anywhere
>
> Start on Slack or iMessage and continue the same Backstage session on the web with full history, richer approvals, and interactive charts.

[Scheduled audit](https://chatbase.co/docs/user-guides/chatbot/backstage/scheduled-audits.md) reports are delivered to Slack or iMessage once you've connected one.

## Connect Slack

1. Open your **Dashboard**.
2. Select your AI agent.
3. Open **Backstage**.
4. Click **Controllers** in the top-right corner.
5. Expand **Slack**.
6. Click **Add to Slack**. You only need to do this once per Slack workspace.
7. Copy the generated link message.
8. Send it as a DM to the **Backstage** Slack app.
9. Once you receive **Connected ✓**, you're ready to chat.

> [!NOTE]
>
> Each Slack thread is its own Backstage session. If your Slack account has access to multiple AI agents, starting a new thread asks which AI agent you'd like to use.

## Connect iMessage

1. Open **Controllers** from the Backstage page.
2. Expand **iMessage**.
3. Text the generated link message to the displayed phone number, or scan the QR code to open Messages with the number and message pre-filled.
4. Once you receive **Connected ✓**, you can start chatting.

> [!NOTE]
>
> Your phone keeps one active conversation. To switch AI agents, send another AI agent's generated link message. This starts a new Backstage session for that AI agent.

## Approving changes

Every change Backstage proposes needs your explicit approval, unless [auto mode](https://chatbase.co/docs/user-guides/chatbot/backstage/approvals-and-auto-mode.md#auto-mode) covers it.

> [tab] Slack
>
> Review the proposed changes and approve or reject them in Slack. Each proposal includes:
>
> <ul>
>   <li>A detailed diff of what will change</li>
>   <li>**Approve** and **Reject** controls for every change</li>
> </ul>

> [tab] iMessage
>
> React with:
>
> <ul>
>   <li>👍 to approve</li>
>   <li>👎 to reject</li>
> </ul>

You can also reply with messages like **"yes"**, **"approve"**, **"no"**, or **"reject"**, or equivalent phrases in any language.

> [!NOTE]
>
> If you send another request while an approval is pending, the previous proposal is superseded, so you can't accidentally approve an outdated change.

On Slack, replying **"stop"** cancels a running [improvement](https://chatbase.co/docs/user-guides/chatbot/backstage/approvals-and-auto-mode.md#how-backstage-fixes-a-problem). When Backstage [builds a Custom Action](https://chatbase.co/docs/user-guides/chatbot/backstage/build-actions-with-backstage.md), the **Run** button for the test works in the Slack thread, and entering an API key opens Backstage on the web.

## Example: a quick check from your phone

> **Jane (iMessage):** How did my AI agent do this week?
>
> **Backstage:** Replies with a summary and a link to the session on the web for the interactive chart.
>
> **Jane:** Add a Q\&A saying we ship to Canada in 5 to 7 business days.
>
> **Backstage:** Shows the Q\&A it will add. Jane reacts with 👍, and Backstage adds it.

## Good to know

* **Link messages** are single-use and expire after **10 minutes**.
* **Connections are personal.** They inherit your Chatbase permissions and can be revoked at any time from the **Controllers** dialog.
* **Attachments:** Slack supports uploading files for analysis. Backstage can't read attachments sent over iMessage. It replies that it can't open the file, and still answers any text you sent with it. A message that's only an attachment doesn't count toward your daily limit.
* **Web experience:** large analyses, interactive charts, and long approval flows include a link back to the matching Backstage session in the dashboard.
* **Daily limit:** messages from Slack and iMessage count toward the same daily Backstage limit as the web. See [Backstage limits and credits](https://chatbase.co/docs/user-guides/chatbot/backstage/limits-and-credits.md).

> [!WARNING]
>
> Nothing is changed without your explicit approval, except changes you've allowed in [auto mode](https://chatbase.co/docs/user-guides/chatbot/backstage/approvals-and-auto-mode.md#auto-mode).

## Frequently asked questions

> [accordion] Can I send files to Backstage over iMessage?
>
> No. Backstage can't read iMessage attachments. It tells you it can't open the file and answers any text you sent with it. Use Backstage on the web or in Slack to share a file.

> [accordion] How do I switch AI agents on iMessage?
>
> Send the generated link message for the other AI agent. It starts a new Backstage session for that AI agent.

> [accordion] How do I switch AI agents on Slack?
>
> Start a new thread. If your Slack account has access to more than one AI agent, Backstage asks which one to use.

> [accordion] My link message stopped working. Why?
>
> Link messages are single-use and expire after 10 minutes. Generate a new one from **Controllers**.

> [accordion] How do I disconnect Slack or iMessage?
>
> Revoke the connection from the **Controllers** dialog on the Backstage page.

> [accordion] Do Slack and iMessage messages count toward the daily limit?
>
> Yes. The daily limit is shared across the web, Slack, and iMessage for each AI agent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.