hitspec can send notifications to Slack and Microsoft Teams when tests complete. This is especially useful for CI/CD pipelines to alert teams about test failures.
Supported Services
| Service | Flag | Webhook Variable |
|---|
| Slack | --notify slack | SLACK_WEBHOOK |
| Microsoft Teams | --notify teams | TEAMS_WEBHOOK |
Quick Start
# Notify Slack on failure
hitspec run tests/ \
--notify slack \
--slack-webhook "$SLACK_WEBHOOK"
# Notify Teams on failure
hitspec run tests/ \
--notify teams \
--teams-webhook "$TEAMS_WEBHOOK"
Notification Triggers
Control when notifications are sent with --notify-on:
| Value | Description |
|---|
failure | Send only when tests fail (default) |
always | Send on every run |
success | Send only when all tests pass |
recovery | Send on failure and when tests recover from a previous failure |
# Always notify
hitspec run tests/ --notify slack --slack-webhook "$SLACK_WEBHOOK" --notify-on always
# Notify on recovery (useful for monitoring)
hitspec run tests/ --notify slack --slack-webhook "$SLACK_WEBHOOK" --notify-on recovery
Slack Configuration
| Flag | Env Var | Description |
|---|
--slack-webhook | SLACK_WEBHOOK | Slack incoming webhook URL (required) |
--slack-channel | SLACK_CHANNEL | Override the default channel |
- Pass/fail summary with test counts
- Duration
- Environment name
- Failed test details (names, files, errors)
Teams Configuration
| Flag | Env Var | Description |
|---|
--teams-webhook | TEAMS_WEBHOOK | Teams incoming webhook URL (required) |
Multiple Services
Send to both Slack and Teams simultaneously:
hitspec run tests/ \
--notify slack,teams \
--slack-webhook "$SLACK_WEBHOOK" \
--teams-webhook "$TEAMS_WEBHOOK"
CI/CD Example
# GitHub Actions
- name: Run API tests
run: |
hitspec run tests/ \
--env staging \
--output junit \
--output-file results.xml \
--notify slack \
--notify-on failure
env:
SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK }}
Store webhook URLs in environment variables or CI/CD secrets. Never commit them to your repository.
