โจ Updated October 2018: As we have introduced some new features, this tutorial and the code samples have been updated! All the changes from the previous version of this example, read the DIFF.md
Use a slash command and a dialog to create a helpdesk ticket in a 3rd-party system. Once it has been created, send a message to the user with information about their ticket.
- Create an app at https://api.slack.com/apps
- Add a Slash command (See Add a Slash Command section below)
- Navigate to Bot Users and click "Add a Bot User" to create one.
- Enable Interactive components (See Enable Interactive Components below)
- Navigate to the OAuth & Permissions page and add the following scopes:
commands
bot
users:read
users:read.email
chat:write:bot
- Click 'Save Changes' and install the app (You should get an OAuth access token after the installation)
- Go back to the app settings and click on Slash Commands.
- Click the 'Create New Command' button and fill in the following:
- Command:
/helpdesk
- Request URL: Your ngrok or Glitch URL +
/command
- Short description:
Create a helpdesk ticket
- Usage hint:
[the problem you're having]
- Command:
If you are using Glitch, the Request URL should look like: https://my-slash-comm-app.glitch.me/command
.
- Go back to the app settings and click on Interactive Components.
- Set the Request URL to your server (e.g.
https://yourname.ngrok.com
) or Glitch URL +/interactive
. - Save the change.
- Get the code
- Either clone this repo and run
npm install
- Or visit https://glitch.com/edit/#!/remix/slack-slash-command-and-dialogs-blueprint
- Either clone this repo and run
- Set the following environment variables to
.env
(see.env.sample
):SLACK_ACCESS_TOKEN
: Your bot token,xoxb-
(available on the OAuth & Permissions once you install the app)SLACK_SIGNING_SECRET
: Your app's Signing Secret (available on the Basic Information page)
- If you're running the app locally, run the app (
npm start
). Or if you're using Glitch, it automatically starts the app.