Install Guide

Install in SN

• Fork this repo to your own GitHub account
• Link to your PDI via Studio's Source Control
  • Ensure that you are on the Master branch in Studio.

Create App, Install into Slack

• Create new Slack app (in an instance where you are an admin, not in SNDevs) (https://api.slack.com/apps/new)
• Enable events
• Request URL = https://YOURDEVINSTANCE.service-now.com/api/x_snc_slack_points/handle_slack_events
• Subscribe to Workspace Events (message.channels, message.groups)
• Add a bot user
• Give bot permissions to post messages (chat:write:bot)
• Make a note of the "Bot User OAuth Access Token" (for ServiceNow sys_properties later on)
• Install app into your Slack channel

Connect them together

• Place token into property 'x_snc_slack_points.slack_bot_token'
• Do this outside of the scope of the Points Thing App, or else when you commit your changes, Slack will automatically disable your token when it does a scan of GitHub and sees that you accidentally placed your private token online.

Testing

• Invite your bot to a Slack channel
• Give a person (or thing) a quick ++

Troubleshooting

• Check the import table to make sure SN is receiving Slack messages
• Check 'Outbound HTTP Requests' to make sure the bot is replying to the channel