https://github.com/spoqa/slack-translator
You can translate your chat using slack translator.
https://github.com/spoqa/slack-translator
Last synced: about 1 year ago
JSON representation
You can translate your chat using slack translator.
- Host: GitHub
- URL: https://github.com/spoqa/slack-translator
- Owner: spoqa
- Created: 2015-10-11T14:45:25.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2021-04-21T01:23:54.000Z (over 5 years ago)
- Last Synced: 2025-04-07T12:52:02.531Z (over 1 year ago)
- Language: Python
- Size: 30.3 KB
- Stars: 52
- Watchers: 6
- Forks: 18
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Slack Translator
[](https://heroku.com/deploy) [](https://travis-ci.org/spoqa/slack-translator) [](https://coveralls.io/github/spoqa/slack-translator)
You can translate your chat using slack translator.
## How to Setup
You need to setup the following [environment variables][2] to integrate
with [Slack][1]:
- `SLACK_API_TOKEN`: You can get the API Token from [Slack Web API](https://api.slack.com/web)
- `SLACK_WEBHOOK_URL`: You can get the Incoming Webhook URL from [here](https://services/new/incoming-webhook)
Also, you need to choose a translator vendor to use:
- `TRANSLATE_ENGINE`: The handle name of the translator vendor. Currently only support `google` and `naver`. `google` by default.
### Google translator
If you choose `google` as your `TRANSLATE_ENGINE`, you need to add one more
environment variable for [Google Translate API][3] as well:
- `GOOGLE_API_KEY`: You can get the API Key from [Google Developers Console](https://console.developers.google.com/)
### Naver translator
If you choose `naver` as your `TRANSLATE_ENGINE`, you need to add two more
environment variable for [Naver Translator API][4] as well:
- `NAVER_CLIENT_ID`/ `NAVER_CLIENT_SECRET` : You can get the API Key from [Naver Developer Website](https://developers.naver.com/register?defaultScope=translate)
Then you can add [Slash Commands](https://api.slack.com/slash-commands) to use
translator.
1. **Commands:** `/[target language]`
2. **URL**: `https://[host]/[source language]/[target language]`
3. **Method**: `POST`
For example, if you are using Korean, and you want to add Korean->Japanese
translation command, try to add Slash command like this.
1. **Commands:** `/ja`
2. **URL**: `https://[host]/ko/ja`
3. **Method**: `POST`
## Meeting mode
Translate every messages in a channel without the need to type in commands with "Meeting Mode". This feature makes uninterrupted flow of communication possible, and integrates into normal conversation smoothly.
To use this feature additional setup is required.
### Installation
You'll need to set up a [Slack App](https://api.slack.com/slack-apps) **in addition to** to setting up slash commands above.
1. Create a [Slack App](https://api.slack.com/apps/)
1. Set up [Event Subscriptions](https://api.slack.com/events-api)
- Verify url by setting up `Request URL` to `http://[host]/meeting_mode`
- example) http://your-app.herokuapp.com/meeting_mode
- Subscribe to [message.channels](https://api.slack.com/events/message.channels) event.
1. Add [Slack Commands](https://api.slack.com/slash-commands) for starting meeting mode.
- example) Command to translate every japanese in this channel to korean.
- **Commands:** `/会議開始`
- **URL:** `http://your-app.herokuapp.com/start_meeting_mode/ja/ko`
- example) Command to stop meeting mode in this channel.
- **Commands:** `/会議終了`
- **URL:** `http://your-app.herokuapp.com/stop_meeting_mode/`
[1]: https://www.slack.com/
[2]: https://en.wikipedia.org/wiki/Environment_variable
[3]: https://cloud.google.com/translate/docs
[4]: https://developers.naver.com/products/translator