{"id":15714306,"url":"https://github.com/slack-samples/javascript-actionable-notifications","last_synced_at":"2025-07-22T11:07:22.235Z","repository":{"id":25110457,"uuid":"94123224","full_name":"slackapi/template-actionable-notifications","owner":"slackapi","description":"Sample Slack app to illustrate how incoming webhooks and interactive messages can be used to build a helpdesk integration","archived":false,"fork":false,"pushed_at":"2023-11-10T05:20:57.000Z","size":212,"stargazers_count":36,"open_issues_count":13,"forks_count":17,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-01-30T14:22:42.590Z","etag":null,"topics":["slack-api","slack-blueprint","slack-tutorial","slack-workflow-sample"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slackapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-12T17:36:30.000Z","updated_at":"2024-10-12T02:07:36.000Z","dependencies_parsed_at":"2023-01-14T07:00:45.725Z","dependency_job_id":null,"html_url":"https://github.com/slackapi/template-actionable-notifications","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slackapi%2Ftemplate-actionable-notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slackapi%2Ftemplate-actionable-notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slackapi%2Ftemplate-actionable-notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slackapi%2Ftemplate-actionable-notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slackapi","download_url":"https://codeload.github.com/slackapi/template-actionable-notifications/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237261575,"owners_count":19281265,"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":["slack-api","slack-blueprint","slack-tutorial","slack-workflow-sample"],"created_at":"2024-10-03T21:35:54.094Z","updated_at":"2025-07-22T11:07:20.376Z","avatar_url":"https://github.com/slackapi.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Actionable notifications template\n\n\u003e :sparkles: *Updated January 2020: As we have introduced some new features, this tutorial and the code samples have been updated!*\n\nRead [diff.md](diff.md) for more info!\n\n---\n\nWhen a helpdesk ticket is created in a 3rd party system, send an actionable notification in Slack that allows the user to claim the ticket or apply a label.\n\n![Screenshot of template application](https://raw.githubusercontent.com/slackapi/template-actionable-notifications/master/screenshot.png)\n\n## Setup\n\n#### Create a Slack app\n\n1. Create an app at api.slack.com/apps\n1. Activate Incoming Webhooks from the Features \u003e **Incoming Webhooks** then click 'Add New Webhook to Workspace', install the app and select a channel\n1. Navigate to the **OAuth \u0026 Permissions** page and add the following **bot** scopes:\n    * `incoming-webhook` (This should be pre-selected)\n    * `chat:write` (to send messages)\n    * `im:write` (to open a DM channel between your bot and a user)\n  \n\n#### Run the app\n\nClone this repo to run locally or \n[![Remix on Glitch](https://cdn.glitch.com/2703baf2-b643-4da7-ab91-7ee2a2d00b5b%2Fremix-button.svg)](https://glitch.com/edit/#!/remix/slack-actionable-notification-blueprint)\n\n1. Get the code\n    * Either clone this repo and run `npm install`\n    * Or visit https://glitch.com/edit/#!/remix/slack-actionable-notification-blueprint\n1. Set the following environment variables to `.env` (see `.env.sample`):\n    * `SLACK_TOKEN`: Your app's `xoxb-` token (available on the **OAuth \u0026 Permissions**)\n    * `SLACK_WEBHOOK`: The webhook URL that you copied off the **Incoming Webhook**\n    * `SLACK_SIGNING_SECRET`: Your app's Signing secret (available on the **Basic Information**)\n1. If you're running the app locally:\n    1. Start the app (`npm start`)\n    1. In another window, start ngrok on the same port as your webserver (`ngrok http $PORT`)\n\n#### Enable Interactive Components\n1. Go back to the app settings and click on Interactive Components.\n1. Set the Request URL to your ngrok URL (or Glitch URL) + `/interactive-message` (such as `https://my-project.glitch.me/interactive-message`)\n1. Save\n\n#### Send a mock new ticket notification\n\nPost the mock ticket JSON to the `/incoming` endpoint:\n\n``curl -X POST -H 'Content-type: application/json' --data \"`cat ./ticket.json`\" \u003cYour app server URL + /incoming\u003e``\n\nExample:\n``curl -X POST -H 'Content-type: application/json' --data \"`cat ./ticket.json`\" https://slack-actionable-notification-blueprint.glitch.me/incoming``\n\n*You need the ticket.json file in the same directory where you are sending the curl command!*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslack-samples%2Fjavascript-actionable-notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslack-samples%2Fjavascript-actionable-notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslack-samples%2Fjavascript-actionable-notifications/lists"}