README.md

Yokoso

• Slack とビル来客システム https://srd-gate.com/03/login.cgi を連携させるツール
• 概要は SmartHR Tech Blog

全体像

セットアップ

サーバサイド

前提

• 以下を使っています
  • Heroku
  • Redis
• 以下の環境変数は後で設定するので空で大丈夫です
  • SLACK_TOKEN
  • MAIL_ADDRESS_WEBHOOK

起動

サーバ実行の場合

• 環境変数を設定してデプロイする
• リソース割り当て
  • 

ローカル実行の場合

• sample.env -> .env に名前変更して、環境変数を設定する
• localhost:5000 で起動するのでグローバルからローカルに通信をフォワーディングする
  • 参考: Using ngrok to develop locally for Slack
  • 参考: FORWARD

heroku local -e .env

Slack App 作成

• Slack App を新規作成して各種設定をする
• https://api.slack.com/apps
• 

Interactive Components

• 設定をオンにしてサーバのアドレスを入力する
• https://{{server_url}}/app/interactive
• 

Slash Commands

• スラッシュコマンドの設定を追加する
• https://{{server_url}}/app/dialog
• 

OAuth & Permissions

• 権限を追加する
  • channels:history
  • chat:write:bot
  • users:read
  • commands
    • スラッシュコマンドを設定していれば自動で追加されているはず
  • 
• Token は後でサーバサイド環境変数へセットする
  • 

App Install

• ワークスペースへのインストールを忘れずに実施

Email Webhook

• メール受信 -> Webhook を作成
• 受信したメール本文を json 形式の body 要素として post すれば OK
• webhook アドレスは https://{{server_url}}/app/notification
• サービスは何でも良い
  • zapier なら コチラ
  • 参考:
• Webhook 用メールアドレスは後でサーバサイド環境変数へセットする

サーバーサイド環境変数の再設定

• 以下の環境変数を設定する
  • SLACK_TOKEN
  • MAIL_ADDRESS_WEBHOOK

Code of Conduct

Everyone interacting in the yokoso project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

License

The gem is available as open source under the terms of the Apache License 2.0.