/bot-workplace-ops

Primary LanguageTypeScript

Workplace Operations Slack App

The app is composed of two serverless functions command.js and interactive.js

Skills

  • create jira service desk tickets
    • thumbsup
    • computer issue

Local Development

One-time setup

  1. Set up ngrok.

    • Download ngrok and add it to your classpath.
    • Sign up for a free ngrok account and follow the instructions to add your auth token to your local configuration. This allows your ngrok tunnels to run indefinitely.
    • Go to your ngrok dashboard to reserve a dedicated domain. This allows you to use the same domain across ngrok tunnel restarts.

  2. Create a Slack app on https://api.slack.com/apps named LaunchDarkly ($YOURNAME dev) (insert your name).

  3. Fully configure your Slack app.

    • The settings on all of the sub-pages under "Features" should be identical to the configuration of the LaunchDarkly staging app except for the following items. Ask a team member if you don't have access to view the staging app configuration.
    • All app URLs should be based from your ngrok-provided URL (e.g. https://<ngrok-url>.ngrok.io/slack/events) instead of the hosted staging app URL .
    • All slash commands should be namespaced in the form of /launchdarklyYOUR_INFIX (e.g. /launchdarklymc).

  5. Copy .env.template in the root directory of this repository to .env. In this file you will provide your application with the configuration details we specified above. Follow the instructions in that file.

  6. Run yarn

Starting your local app

  1. ngrok http 3000 -subdomain=YOURSUBDOMAIN. This will start ngrok for your desired port and subdomain.
  2. now dev. This will start your database and the node app.
  3. Go to https://YOURSUBDOMAIN.ngrok.io/,
  4. In Slack, type /servicedesk to use your app!

Local changes should be picked up automatically without needing to restart the app.

Add secrets

now secret add

Future exploration

[ ] notify_on_cancel: true, error messaging [ ] add labels [ ] callback_id [ ] response_url [ ] channel [ ] add hmac [ ] remove this link: https://files.readme.io/9e0ee9d-small-logo.png from interactive messages [ ] Migrate to Blocks(when blocks supports colored bars)