๐ข 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/)