https://github.com/k2tzumi/choice-slash-command
https://github.com/k2tzumi/choice-slash-command
gas hacktoberfest slack-bot
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/k2tzumi/choice-slash-command
- Owner: k2tzumi
- Created: 2021-01-31T06:16:37.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-08-13T02:00:03.000Z (almost 4 years ago)
- Last Synced: 2025-02-10T03:26:04.613Z (4 months ago)
- Topics: gas, hacktoberfest, slack-bot
- Language: TypeScript
- Homepage:
- Size: 684 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/google/clasp)
What is this?
==============================
This bot will run the slack slash command and select a few words that are specified.
This bot runs as a web app within a Google app script.
You can make this bot work by registering it as a request URL for the [Slack API](https://api.slack.com/apps) slash command.
Slack slash command
--------------------
* When you let them choose a word
```
/choice keyword1 keyword2 keyword3
```
REQUIREMENTS
--------------------
- `npm`
- [clasp](https://github.com/google/clasp)
`npm install -g @google/clasp`
- [apps-script-jobqueue](https://github.com/k2tzumi/apps-script-jobqueue)
- `make`
- GAS Library
- [OAuth2](https://github.com/googleworkspace/apps-script-oauth2)
- [JobBroker](https://github.com/k2tzumi/apps-script-jobqueue)
USAGE
--------------------
To use it, you need to set up Google apps scripts, and Slack API.
### Install Google apps scripts
1. Enable Google Apps Script API
https://script.google.com/home/usersettings
2. make push
3. make deploy
4. Grant the necessary privileges
make open
Publish > Deploy as web app.. > Update
Grant access
The URL of the current web app after deployment will be used as the request URL for the OAuth authentication screen and Slack message action.
### Register with the Slack API
* Create New App
https://api.slack.com/apps
Please make a note of `App Credentials` displayed after registration.
### Setting Script properties
In order to run the application and change its behavior, you need to set the following Google Apps scripts property.
|Property name|Required|Setting Value|Description|
|--|--|--|--|
|VERIFICATION_TOKEN|○|Basic Information > App Credentials > Verification Token|A token that easily authenticates the source of a hooked request|
|CLIENT_ID|○|Basic Information > App Credentials > Client ID|Use with OAuth|
|CLIENT_SECRET|○|Basic Information > App Credentials > Client Secret|Use with OAuth|
1. Open Project
`$ make open`
2. Add Scirpt properties
File > Project properties > Scirpt properties > Add row
Setting Property & Value
### OAuth Authentication
#### Settings OAuth & Permissions
* Redirect URLs
`Add New Redirect URL` > Add Redirect URL > `Save URLs`
ex) https://script.google.com/macros/s/miserarenaiyo/usercallback
You can check the Redirect URL in the following way. The `RedirectUri` of the displayed page.
`$ make application`
* Bot Token Scopes
Click `Add an OAuth Scope` to select the following permissions
* [commands](https://api.slack.com/scopes/commands)
* [users:read](https://api.slack.com/scopes/users:read)
* Install App to Workspace
You must specify a destination channel that bot can post to as an app.
### Install App to Workspace
1. Open web application
`$ make application`
The browser will be launched with the following URL:
example) https://script.google.com/macros/s/miserarenaiyo/exec
2. Click `Authorize.`
You must specify a destination channel that bot can post to as an app.
3. Click `Allow`
The following message is displayed when OAuth authentication is successful
```
Success!
Setting EventSubscriptions
Setting Slash Commands
Setting Interactivity & Shortcuts
```
When prompted, click the `Setting Slash Commands` to set up an Slash Commands.
### Settings Slash Commands
* Create New Command
Setting Request URL.
For example) https://script.google.com/macros/s/miserarenaiyo/exec