Skip to content

๐Ÿ“ข Action: Slack Notification

Send beautifully formatted test summaries, environment status, and high-fidelity alerts to your team's Slack channels.


[!NOTE] The Slack Notification action bridges the gap between CI execution and team awareness. It crafts aesthetic, color-coded payloads (Green/Red) injected with deep-links to failing runs, accelerating the time-to-resolution for pipeline blockages.

๐Ÿš€ Key Impact

  • ๐ŸŽจ High-Fidelity Layouts: Delivers rich Slack attachments with status-colored sidebars (Success: Green, Failure: Red).
  • ๐Ÿ“Š Run Intelligence: Automatically includes deep links to the specific GitHub Action run for surgical debugging.
  • ๐Ÿ› ๏ธ Configurable Summaries: Injects custom test metrics or context-specific summaries into every notification.
  • ๐Ÿฆพ Automation Focused: Designed to run in the always() hook to ensure visibility regardless of job outcome.

๐Ÿ› ๏ธ Configuration

Input Required Default Description
slack-webhook-url Yes - Your incoming Slack Webhook URL.
status Yes success Job status: success, failure, or cancelled.
test-summary No (Table) Brief text describing the execution results.
project-name No (Repo) Identifier for the project being tested.

โšก Quick Start

Drop this snippet into your workflow:

steps:
  - name: ๐Ÿ“ข Notify Slack
    uses: carlos-camara/qa-hub-actions/slack-notify@main
    if: always()
    with:
      slack-webhook-url: ${{ secrets.SLACK_WEBHOOK }}
      status: ${{ job.status }}
      test-summary: "Test Suite Results: 45 Passed, 2 Failed."

[View Full Wiki](https://carlos-camara.github.io/qa-hub-actions/actions/slack-notify/)