> ## Documentation Index
> Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Demo Slack Notification Setup
> Learn to configure Slack notifications in Jenkins for automated build alerts by installing the Slack Notification plugin and integrating it with secure credentials.
Learn how to configure Slack notifications in Jenkins by installing the Slack Notification plugin, creating a Slack channel and app, and integrating them with secure credentials. By the end, you’ll have automated build alerts in your Slack workspace.
## Installing the Slack Notification Plugin
Jenkins offers a dedicated Slack Notification plugin to send build statuses, messages, and files directly to Slack channels.
1. In Jenkins, navigate to **Manage Jenkins > Manage Plugins**.
2. Open the **Available** tab, search for **Slack Notification**, select it, and click **Install without restart**.
3. Monitor the download progress under **Plugin Manager**. You’ll see statuses like "Pending," "Downloading," and "Installed."
4. Once installation completes, restart Jenkins to activate the plugin.
Restarting Jenkins ensures the Slack plugin is loaded and all dependencies are ready.
## Reviewing the Plugin Documentation
While Jenkins restarts, review the official plugin documentation to explore advanced features and configuration options:
* [Slack Notification Plugin for Jenkins](https://plugins.jenkins.io/slack/)
## Creating a Slack Channel
Define a Slack channel to receive Jenkins build notifications:
1. In Slack, click **Add channels > Create a channel**.
2. Name it `dasher-notifications` (or your preferred identifier).
3. Choose **Public** or **Private**, then click **Create**.
When the channel opens, you’ll see a welcome prompt and an option to enable notifications.
## Creating a Slack App via Manifest
Grant Jenkins permission to post messages by creating a Slack App with a bot user.
1. In Slack, go to **Apps > Build**, choose **From an app manifest**, and select your workspace.
2. Paste the YAML manifest below to define the bot and its scopes:
```yaml theme={null}
display_information:
name: Jenkins
features:
bot_user:
display_name: Jenkins
always_online: true
oauth_config:
scopes:
bot:
- channels:read
- chat:write
- chat:write.customize
- files:write
- reactions:write
- users:read
- users:read.email
- groups:read
settings:
org_deploy_enabled: false
socket_mode_enabled: false
token_rotation_enabled: false
```
3. Click **Next**, review permissions, then **Create App**.
4. Under **OAuth & Permissions**, click **Install to Workspace** and authorize the app.
5. Copy the **Bot User OAuth Access Token** from **Installed App Settings**. You’ll use this as a Jenkins credential.
### Slack Bot Scopes Reference
| Scope | Purpose |
| -------------------- | ---------------------------- |
| channels:read | Read public channel info |
| chat:write | Post messages in channels |
| chat:write.customize | Customize message appearance |
| files:write | Upload files |
| reactions:write | Add reactions to messages |
| users:read | Read user profiles |
| users:read.email | Access user email addresses |
| groups:read | Read private channel info |
## Configuring Jenkins with Slack Credentials
1. After Jenkins restarts, go to **Manage Jenkins > Configure System**.
2. Scroll to the **Slack** section.
3. For **Workspace**, enter `Jenkins`.
4. Under **Credentials**, click **Add > Jenkins > Secret text**.
5. In the dialog:
* **Kind**: Secret text
* **Secret**: Bot User OAuth token
* **ID**: `slack-bot-token`
* Click **Add**.
6. Back in the Slack section, select **Credentials** → `slack-bot-token`.
7. Set **Default Channel / Member ID** to `#dasher-notifications`.
8. Click **Test Connection**, then **Save**.
If Jenkins reports that the bot isn’t in the channel, invite it before retesting:
```text theme={null}
/invite @Jenkins
```
## Verifying the Integration
Once the connection succeeds, the Jenkins app will join the channel and post a confirmation message.
You’ve successfully set up Slack notifications for Jenkins. Next, configure your pipelines to send alerts on build successes, failures, and more!
## Links and References
* [Slack Notification Plugin for Jenkins](https://plugins.jenkins.io/slack/)
* [Jenkins Documentation](https://www.jenkins.io/doc/)
* [Slack API Documentation](https://api.slack.com/)