discussion-slack-notifier
Notify GitHub Discussions events to Slack with GitHub Actions.
Development Status
This is still in alpha. This isn't production ready yet.
Motivation
You can receive the notification about GitHub Discussions to Slack with the official GitHub App.
e.g.
This integration is very useful, but you can't configure the notification flexibly.
discussion-slack-notifier supports configuring the notification flexibly.- Change notification channels according to the Discussion Labels
Feature
- Change notification channels according to the Discussion Labels
Requirement
- Slack App Bot Token
Please create a Slack App.
Slack App's permission
- chat:write
- chat:write.public (Optional)
How to use
Please set up GitHub Actions Workflow to run discussion-slack-notifier.
- Add GitHub Actions Secret
SLACK_TOKEN
- Add configuration file discussion-slack-notifier.yaml
- Add GitHub Actions workflow. e.g. notify-discuss.yaml
GitHub Token's permission
GitHub Token is required to list Discussion's labels. You can use GitHub Actions' token
github.token.- discussions: read
Environment Variables
- GITHUB_TOKEN: GitHub Access Token. This is required to list the Discussion's labels
- SLACK_TOKEN:
- GITHUB_EVENT_PATH:
Configuration
Templates
You can customize notification message.
Template Priority
- entry's
template
- entry's
template_name
templates'sdefaulttemplate
- Built in default template
Template Variables
- Title (string): Discussion title
- CategoryName (string): Discussion Category Name
- Vars (map[string]interface{}): user defined variables