Slack Setup

Send professional notifications to your Slack workspace with status-colored attachments and action buttons.

Preview

Slack notifications include:

Status-based color coding
Direct links to workflow runs
Repository and branch details
Formatted attachments with metadata

Step-by-Step Setup

1. Create a Slack App

Go to api.slack.com/apps
Click Create New App
Select From scratch
Name your app (e.g., “Workflow Blabber” or “GitHub Notifications”)
Select your workspace from the dropdown
Click Create App

2. Enable Incoming Webhooks

In your app settings, find Incoming Webhooks in the left sidebar
Toggle Activate Incoming Webhooks to On
Scroll down and click Add New Webhook to Workspace
Select the channel where notifications should appear
Click Allow

3. Copy the Webhook URL

After authorizing, you’ll see your webhook URL. It looks like:


https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX

Copy this URL - you’ll need it for GitHub.

4. Add to GitHub Secrets

Go to your repository on GitHub
Navigate to Settings → Secrets and variables → Actions
Click New repository secret
Add your webhook:


Name: SLACK_WEBHOOK
Value: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXX

⚠️ Security Note

Never commit webhook URLs to your repository. Always use GitHub Secrets to protect sensitive credentials.

5. Use in Your Workflow

Add this step to your GitHub Actions workflow:

.github/workflows/ci.yml


name: CI Pipeline
 
on: [push, pull_request]
 
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Build
        run: npm run build
      
      - name: Notify Slack
        if: always()
        uses: michaelikoko/workflow-blabber@v1
        with:
          channels: 'slack'
          status: ${{ job.status }}
          slack_webhook_url: ${{ secrets.SLACK_WEBHOOK }}

Usage Examples

Notify Only on Failure

.github/workflows/ci.yml


- name: Alert Slack on failure
  if: failure()
  uses: michaelikoko/workflow-blabber@v1
  with:
    channels: 'slack'
    status: 'failure'
    custom_message: 'Build failed! Immediate attention required.'
    slack_webhook_url: ${{ secrets.SLACK_WEBHOOK }}

Custom Title and Message

.github/workflows/deploy.yml


- name: Deployment notification
  if: always()
  uses: michaelikoko/workflow-blabber@v1
  with:
    channels: 'slack'
    status: ${{ job.status }}
    custom_title: 'Production Deployment'
    custom_message: 'Version 2.0.0 deployed successfully to production environment.'
    slack_webhook_url: ${{ secrets.SLACK_WEBHOOK }}

Different Channels for Different Statuses

.github/workflows/ci.yml


- name: Success notification
  if: success()
  uses: michaelikoko/workflow-blabber@v1
  with:
    channels: 'slack'
    status: 'success'
    slack_webhook_url: ${{ secrets.SLACK_WEBHOOK_SUCCESS }}
 
- name: Failure notification
  if: failure()
  uses: michaelikoko/workflow-blabber@v1
  with:
    channels: 'slack'
    status: 'failure'
    custom_message: 'Critical: Build pipeline failed'
    slack_webhook_url: ${{ secrets.SLACK_WEBHOOK_ALERTS }}

Notify Multiple Workspaces

If you’re working across multiple Slack workspaces:

.github/workflows/ci.yml


- name: Notify Team A workspace
  if: always()
  uses: michaelikoko/workflow-blabber@v1
  with:
    channels: 'slack'
    status: ${{ job.status }}
    slack_webhook_url: ${{ secrets.SLACK_WEBHOOK_TEAM_A }}
 
- name: Notify Team B workspace
  if: always()
  uses: michaelikoko/workflow-blabber@v1
  with:
    channels: 'slack'
    status: ${{ job.status }}
    slack_webhook_url: ${{ secrets.SLACK_WEBHOOK_TEAM_B }}

Troubleshooting

Webhook Not Working?

Check these common issues:

Invalid webhook URL - Ensure you copied the complete URL including the token
Webhook deleted - Verify the webhook still exists in your Slack app settings
Channel archived - Make sure the target channel is active
App removed - Check if the app is still installed in your workspace
Rate limiting - Slack limits incoming webhooks to 1 message per second

Testing Your Webhook

Test your webhook with curl:

terminal


curl -X POST -H 'Content-type: application/json' \
  --data '{"text":"Test message from Workflow Blabber"}' \
  YOUR_WEBHOOK_URL

If you see “ok” in the response and a message appears in Slack, your webhook is configured correctly.

Permission Issues

If notifications aren’t appearing:

Go to your Slack workspace
Open the channel where notifications should appear
Click the channel name at the top
Select Integrations tab
Verify your app is listed under Apps

Required Input

Input	Description	Required
`slack_webhook_url`	Slack incoming webhook URL	Yes