https://github.com/k1low/backslack
Bridge between Backlog and Slack
https://github.com/k1low/backslack
aws-lambda backlog slack
Last synced: about 1 year ago
JSON representation
Bridge between Backlog and Slack
- Host: GitHub
- URL: https://github.com/k1low/backslack
- Owner: k1LoW
- Created: 2017-03-01T03:49:05.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-03-09T21:48:40.000Z (over 1 year ago)
- Last Synced: 2025-03-29T05:41:35.877Z (about 1 year ago)
- Topics: aws-lambda, backlog, slack
- Language: JavaScript
- Homepage:
- Size: 503 KB
- Stars: 5
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# backslack
Bridge between [Backlog](http://www.backlog.jp/help/adminsguide/webhook-setting/userguide2493.html) and [Slack](https://api.slack.com/incoming-webhooks)

## Usage
### 1. Deploy backslack
```
$ yarn
$ AWS_PROFILE=XXxxxxX $(npm bin)/sls deploy
```
### 2. Get backslack endpoint URL
```
$ AWS_PROFILE=XXxxxxX $(npm bin)/sls info
...
Service Information
service: backslack
stage: v0
region: ap-northeast-1
api keys:
None
endpoints:
POST - https://x0x1x2x3x.execute-api.ap-northeast-1.amazonaws.com/v0/hook # <- Use this URL
functions:
backslack-v0-hook
```
| | Value |
| ------------------ |:---------------------------------------------------------------------|
| backslack endpoint | `https://x0x1x2x3x.execute-api.ap-northeast-1.amazonaws.com/v0/hook` |
### 3. Get Slack incoming webhook URL
https://api.slack.com/incoming-webhooks
`https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX`
| | Value |
| -------------------------- |:--------------------------------------------------------------------------------|
| Slack incoming webhook URL | `https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX` |
### 4. Add Backlog webhook
http://www.backlog.jp/help/adminsguide/webhook-setting/userguide2496.html
Webhook URL: `https://x0x1x2x3x.execute-api.ap-northeast-1.amazonaws.com/v0/hook?space=myspace&webhook_url=https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX&channel=general`
#### URL Query Parameters
| Key | Value | Example |
| -----------------------|:---------------------------|:---------------------------|
| space (required) | [Backlog space id](http://www.backlog.jp/faq/service/what-id.html) | `myspace` |
| webhook_url (required) | Slack incoming webhook URL | `https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX` |
| channel | Slack channel | `general` |
## Architecture
