Set up Slack notifications

Overview

In this tutorial, you'll learn how to connect your Slack workspace to Cast AI and configure alerts to be delivered to your Slack channels. This tutorial is intended for those who want to receive Cast AI notifications directly in Slack without manually configuring webhooks.

By the end of this tutorial, you'll be able to:

• Connect a Slack workspace to your Cast AI organization
• Create an alert that delivers notifications to selected Slack channels
• Test the connection to verify alerts are working
• Manage connected workspaces and troubleshoot connection issues

Background

Cast AI's native Slack integration is the recommended method for receiving cluster notifications in Slack. Unlike the webhook-based approach, which requires you to manually create and manage Slack incoming webhooks, this integration uses OAuth to connect your Slack workspace directly to Cast AI. This means you can set up notifications in a few clicks without any technical configuration in Slack.

Slack notifications include key information about cluster events, such as severity, a summary message, and a link to the Cast AI console. Full notification details remain available in the console.

Before you start

Before you begin, ensure you have:

• Access to the Cast AI console with permissions to manage notifications
• A Slack workspace where you want to receive notifications
• Permission to install apps in your Slack workspace, or access to a Slack workspace administrator who can approve app installations

Create a Slack alert

Creating a Slack alert involves configuring the alert details and connecting your Slack workspace. If you haven't connected a workspace yet, you'll do so as part of this process.

1. In the Cast AI console, click the Notifications icon in the top navigation, then click View all.

   

2. Click Manage alerts, then click Create alert.

   

3. Enter a Name for your alert.

4. Select a Category from the dropdown to specify which type of notifications trigger this alert. Categories include:

   • Reporting anomalies
   • Inventory
   • Security
   • Other

5. Under Severity, select which severity levels should trigger notifications. Options include:

   • Critical
   • Error
   • Warning
   • Success
   • Info

6. Under Delivery method, select Slack.

   If no Slack workspace is connected to your organization, the Workspace section displays a prompt to connect.

7. Click Connect to link your Slack workspace.

   This opens a Slack authorization page in a new window.

8. On the Slack authorization page, select the workspace you want to connect from the Workspace dropdown (if you have access to multiple workspaces).

   The page displays the permissions Cast AI is requesting:

   • Content and info about channels & conversations — Allows Cast AI to see which channels are available for posting notifications
   • Content and info about your workspace — Allows Cast AI to identify the workspace connection
   • Perform actions in channels & conversations — Allows Cast AI to post notification messages to channels you select

9. Click Allow to grant permissions and complete the connection:

   

   You're redirected back to the Cast AI console. What happens next depends on your Slack workspace settings:

   • If the app is automatically approved: The workspace name appears in the Workspace section, and you can proceed to select channels.

   • If admin approval is required: The Workspace section shows a Pending status with the message "Your Slack workspace admin must approve this connection. The request expires in 7 days."

   📘

   Note

   If you see the Pending status, contact your Slack workspace administrator to approve the Cast AI app. Click Retry to check if the approval has been granted.

10. Once the workspace is connected, click the Channels dropdown and select the Slack channels where you want notifications delivered.

    You can select multiple channels. Selected channels appear as tags below the dropdown.

11. Click Save to create the alert.

    

Test the connection

After saving an alert, you can send a test notification to verify that messages are delivered to your configured Slack channels.

1. In the Alerts list, click on the alert you want to test.

2. Click the Test button in the bottom-left corner of the alert details panel.

   

   Cast AI sends a test notification to all configured Slack channels for this alert.

3. Check your Slack channels to confirm the test message arrived.

If the test message doesn't appear, see Troubleshooting for common issues and solutions.

Manage connected workspaces

You can disconnect a Slack workspace from Cast AI at any time. Disconnecting a workspace removes the connection but doesn't uninstall the Cast AI app from Slack.

To disconnect a workspace:

1. Open an existing alert that uses the workspace, or create a new alert.

2. Under Delivery method, select Slack.

3. In the Workspace section, click Disconnect next to the workspace name.

The workspace is removed from your Cast AI organization. Any alerts configured to use this workspace will no longer deliver notifications to Slack until you reconnect a workspace and update the alert configuration.

Next steps

Consider exploring these related topics:

• Notifications — Learn about all notification types and severity levels available in Cast AI
• How to set up notification webhooks — Configure webhooks for external systems like PagerDuty or OpsGenie
• Webhook integration examples — See example configurations for various notification destinations

Troubleshooting

Connection shows Pending status

If your connection shows "Pending" after authorizing the Cast AI app, your Slack workspace requires administrator approval for new app installations. Contact your Slack workspace administrator and ask them to approve the Cast AI app. The approval request expires after 7 days—if it expires, you'll need to initiate the connection process again.

Test notification not received

If test notifications aren't appearing in your Slack channel:

• Verify the channel still exists and hasn't been archived
• Confirm the Cast AI app is still installed in your Slack workspace
• Check that the channel is a public channel or that the Cast AI app has been invited to the private channel
• Try disconnecting and reconnecting the workspace

Channel not appearing in the dropdown

The channel dropdown shows channels that the Cast AI app can post to. If a channel doesn't appear:

• For public channels, the channel should appear automatically
• For private channels, invite the Cast AI app to the channel first
• Refresh the page to update the channel list