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

# Slack

> Post real-time Orato alerts to a Slack channel: campaign reports, qualified leads, meeting bookings, low credits, and system errors.

The Slack integration posts Orato events to a channel in your Slack workspace, so your team hears about qualified leads, new meetings, and low credits the moment they happen.

> [!NOTE]
>
> Only Owners and Admins can connect integrations. See [Team and roles](https://docs.tryorato.com/account/team-and-roles.md).

## Connect Slack

**1. Link workspace**

Go to **Integrations**, find **Slack**, and click **Connect**. Sign in to Slack and approve access for your workspace.

**2. Configure channels**

Back in Orato, click **Configure Feeds** on the Slack card to open **Slack Workspace Configuration**. Choose a **Default notification channel**. All enabled notifications are posted there.

**3. Choose notifications**

Turn on the events you want under **Notification preferences**, then click **Save preferences**. Changes take effect immediately.

A progress bar at the top shows the three stages: **Link workspace**, **Configure channels**, and **Complete**.

## Notification preferences

![Slack configuration](https://mintcdn.com/oratoinc/_v09achgY1-wJkWh/images/app/slack-config.jpg?fit=max\&auto=format\&n=_v09achgY1-wJkWh\&q=85\&s=82d18b7aa1d9d0a01d1e006e776d9432)

The counter (for example **3 / 8 active**) shows how many events are on.

| Notification | Posts when |
| - | - |
| **Low credits alert** | Your wallet balance runs low |
| **System errors** | A critical runtime error occurs |
| **Campaign reports** | A campaign finishes, with summary stats |
| **Qualified leads** | A high-value lead matches your criteria |
| **New meetings booked** | An appointment or consultation is booked |
| **Meeting booking failed** | A requested slot couldn't be booked after the call |
| **Campaign started** | A campaign goes live and begins calling |
| **Campaign stopped** | A campaign is stopped manually or cancelled |

### Low credits threshold

Set the **USD remaining** at which the low-credits alert fires, for example `10`. Pick a value that gives you time to [top up](https://docs.tryorato.com/account/billing.md#add-funds) before campaigns stop.

Click **Discard changes** to undo edits you haven't saved.

## Permissions

Orato requests only these Slack permissions:

| Scope | Why |
| - | - |
| `chat:write` | Post messages to your channel |
| `channels:read` | List channels so you can pick one |
| `channels:join` | Join the channel you choose |

OAuth tokens are encrypted and stored in a secure credentials vault.

## Disconnect

Click **Disconnect workspace** on the configuration page, or **Disconnect** on the Slack card in **Integrations**. Orato stops posting immediately.

> [!TIP]
>
> Create a dedicated channel such as `#orato-alerts` so notifications don't get lost in busy conversations.


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