{"id":16684415,"url":"https://github.com/leopic/gh-action-event-notifier","last_synced_at":"2025-04-05T03:23:10.591Z","repository":{"id":42663320,"uuid":"243622781","full_name":"leopic/gh-action-event-notifier","owner":"leopic","description":"Translates GitHub's events into human readable messages in Slack.","archived":false,"fork":false,"pushed_at":"2023-02-11T11:50:31.000Z","size":6256,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-01T19:55:29.503Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leopic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-27T21:42:30.000Z","updated_at":"2022-02-27T11:45:25.000Z","dependencies_parsed_at":"2024-10-12T14:43:47.692Z","dependency_job_id":"1e79cf5d-fdee-4c74-bb50-e6183e6d27ec","html_url":"https://github.com/leopic/gh-action-event-notifier","commit_stats":{"total_commits":40,"total_committers":2,"mean_commits":20.0,"dds":"0.30000000000000004","last_synced_commit":"9a877a8d61945462a8a65f0abd011c89a6f1884f"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leopic%2Fgh-action-event-notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leopic%2Fgh-action-event-notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leopic%2Fgh-action-event-notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leopic%2Fgh-action-event-notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leopic","download_url":"https://codeload.github.com/leopic/gh-action-event-notifier/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247281780,"owners_count":20913233,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-12T14:43:42.184Z","updated_at":"2025-04-05T03:23:10.569Z","avatar_url":"https://github.com/leopic.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![CI](https://github.com/leopic/gh-action-event-slack-parser/workflows/CI/badge.svg)\n\n# GitHub Action Event Slack Notifier\nTranslates GitHub's events into human readable messages in Slack.\n\n## Setup\nTo use this GitHub Action you'll first need to create a Slack App and install it to your workspace.\n\n### Creating a Slack App\n1. **Create a Slack App**. Go to [Slack's developer site](https://api.slack.com/apps) then click \"Create an app\".\nName the app \"GitHub Action\" (you can change this later) and make sure your team's Slack workspace is selected under\n\"Development Slack Workspace\".\n2. **Add a Bot user**. Browse to the \"Bot users\" page listed in the sidebar. Name your bot \"GitHub Action\" (you can\nchange this later) and leave the other default settings as-is.\n3. **Set an icon for your bot.** Browse to the \"Basic information\" page listed in the sidebar. Scroll down to the\nsection titled \"Display information\" to set an icon.\n4. **Install your app to your workspace.** At the top of the \"Basic information\" page you can find a section titled\n\"Install your app to your workspace\". Click on it, then use the button to complete the installation.\n\n## Usage example\n\nTo use this GitHub Action, you'll need to set the following inputs:\n- `slackbot-token` to get your Slack bot token, browse to the \"OAuth \u0026 Permissions\" page listed in Slack and copy the\n \"Bot User OAuth Access Token\" beginning in `xoxb-`.\n- `slack-conversation-id` read below\n- `github-token` needed to authenticate to GitHub's API\n- `run-id` a unique number for each workflow run within a repository, you'll get this\n- `job-status` the current status of the job.\n\nHere is how this looks inside a workflow:\n```yaml\nname: GitHub Event Notifier\n\non:\n  pull_request:\n    branches:\n      - master\n\njobs:\n  run:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Notify Slack\n        if: always()\n        uses: leopic/gh-action-event-notifier@v1.0.0\n        with:\n          github-token: ${{ secrets.GITHUB_TOKEN }}\n          job-status: ${{ job.status }}\n          run-id: ${{ github.run_id }}\n          slack-conversation-id: ${{ secrets.SLACK_CHANNEL_ID }}\n          slackbot-token: ${{ secrets.SLACK_BOT_TOKEN }}\n\n```\n\n### Slack Conversation ID\n\nA Slack Conversation ID (channel ID) can be:\n- The ID of a channel\n- The ID of a private group, or user you would like to post a\n- The ID of a user that will receive your messages\n \nYour bot can message any user in your Slack workspace but needs to be invited into channels and private groups before\nit can post to them.\n\nIf you open Slack in your web browser, you can find channel IDs at the end of the URL when viewing channels and private\ngroups. _Note that this doesn't work for direct messages._\n\n```\nhttps://myworkspace.slack.com/messages/CHANNEL_ID/\n```\n\nYou can also find channel IDs using the Slack API. Get a list of channels that your bot is a member of via Slack's\n[users.conversations](https://api.slack.com/methods/users.conversations) endpoint. Get user IDs for direct messages\nusing Slack's [users.lookupByEmail](https://api.slack.com/methods/users.lookupByEmail) endpoint.\n\nIf the channel is private, you'll need to install the App in that channel.\n\n### Output examples\n![Push to special branch](https://cldup.com/WVCqixwNqa.png)\n![Pull request](https://cldup.com/_rHgXb_aus.png)\n\n#### Special thanks\n- [Post Slack messages](https://github.com/marketplace/actions/post-slack-message) for the\n inspiration and borrowed instructions\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleopic%2Fgh-action-event-notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleopic%2Fgh-action-event-notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleopic%2Fgh-action-event-notifier/lists"}