Setup instructions

These are some brief instructions on how to set up your own instance of SlackCommander to use with your Slack team.

Infrastructure

1. Get a Microsoft Azure account. The current version of SlackCommander uses Azure Storage for persisting todo items, so if you don't want to implement your own storage provider this is a requirement. (If you do want to roll your own, have a look at ITodoService.)
2. Create an Azure Storage account from the Azure portal. Call it whatever your like. Note the primary access key under Keys.
3. Create an Azure Website. The free hosting plan is fine. Call it whatever you like. Note the website url under Properties (I recommend using https). It should look like https://[yourslackcommander].azurewebsites.net if you're using the free plan.
4. Open the Site settings for your Azure Website and scroll down to App settings. Add the following setting:
   • todo:azureStorageConnectionString : DefaultEndpointsProtocol=https;AccountName=[your Azure Storage account name];AccountKey=[your Azure Storage primary access key]

Slack integration settings

1. Go to the Service Integrations page for your Slack team.
2. Add an Incoming Webhook integration.
3. Choose @slackbot as the channel.
4. Save the integration.
5. Copy the token displayed in the right column.
6. Open the Site settings for your Azure Website and scroll down to App settings. Add the following settings:
   • slackMessage:responseToken : [your token]
   • slackMessage:responseBaseUrl : https://[your-team-subdomain].slack.com
7. Add a Slash Commands integration.
8. Choose /todo as command name.
9. Save the integration.
10. Under Integration Settings:
    • Set URL to https://[yourslackcommander].azurewebsites.net/todo
    • Set Method to POST.
11. Save the integration settings.
12. Copy the token displayed in the right column.
13. Open the Site settings for your Azure Website and scroll down to App Settings. Add the following setting:
    • todo:slackSlashCommandToken : [your token]

Deployment

There are several options for deploying the SlackCommander app to your Azure Website, all described in detail in the Azure documentation. If you are familiar with Git and want to customize/extend the SlackCommander source code, Git deployment is probably the most convenient option. Otherwise, just go with publishing from VisualStudio (WebDeploy) or S/FTP.