Slack

The Slack integration allows you to create a Slack channel from an SR, pull Slack data into SysAid, post to a Slack channel from SysAid, send direct messages in Slack from SysAid, approve/deny pending action items from Slack, and more.
For further information, see Use the Slack Integration.

Set up the Slack integration

1. In Slack, login as the the primary owner of the Slack team you want to sync with SysAid.
2. Click your team name in the top-right corner of the page.
   
3. Click the Team's profile menu and select Administration > Manage apps.
   
4. Click Build.
   
5. Click Start Building.
   
6. Enter the name of your app. We recommend that you enter "SysAid" here.
7. Select the Slack team that you are creating this app for.
8. Click Create App.
   
9. (Optional) Upload an image such as the SysAid icon to visually represent this app in Slack:
   1. On the sidebar, select Basic Information.
   2. In the Display Information area, click Add App Icon.
   3. Select an image and click Open.
   4. On the bottom of the screen, click Save Changes.
10. (Optional) Add a Short Description field:
    1. If you have not already done so, On the sidebar, select Basic Information.
    2. In the Short Description field describe what the app does. For example, "Syncs Slack data with SysAid."
    3. On the bottom of the screen, click Save Changes.
       
11. Add scopes

    1. On the sidebar, select OAuth & Permissions.

    2. In the Scopes area under the Bot Token Scopes, click Add an Oauth Scope.

    3. Locate and select the following scopes

       • channels:history
       • channels:manage
       • channels:read
       • chat:write
       • commands
       • files:read
       • files:write
       • groups:history
       • groups:read
       • groups:write
       • im:read
       • incoming-webhook
       • mpim:write
       • users:read
       • users.profile:read
       • users:read.email

    4. Under the User Token scopes, click Add an Oauth Scope.

       • channels:history
       • channels:read
       • channels:write
       • chat:write
       • groups:history
       • groups:read
       • groups:write
       • im:read
       • mpim:read
       • usergroups:read
       • user:read
       • users:write
       • users:read.email
12. Obtain the Slack Add-on from the SysAid Marketplace.
13. In SysAid, on the main My Apps page, in the Slack icon, click .
14. In the Account Name field, enter the application name.
15. Get the client ID, client secret, and verification token:
    1. On the Sidebar, select Basic Information.
    2. Copy the contents of the the Client ID, Client Secret and Verification Token fields and paste the contents into their corresponding fields in SysAid's Slack integration screen.
       
16. (Optional) In SysAid, in the New Channel Prefix field, enter a prefix for new channel names created from SysAid.
17. In the Visible to All Admins field, enter a value of Y (Yes) or N (No) to determine if the integration is visible for all admins. If you enter N, you can set which admins can view the integration from the Admin Groups form.
18. In the Enabled field, enter a value of Y (Yes) or N (No) to determine if the integration is enabled for that account.
19. Click Save Changes.
20. Click Generate Token.
21. Copy the generated token for later use.
22. Back in Slack, from the sidebar, clickOAuth & Permissions.
23. Click Add a new Redirect URL.
24. In the Redirect URL field, enter the following URL:
    https://<SysAid URL>/addonsConsume/slack?accessToken=<token>

25. Click Add.
26. Click Save URLs.
27. (Optional) Create Slash Commands to allow for creating SRs or Linking to SRs from Slack:
    1. Back in Slack, from the sidebar, click Slash Commands.
    2. Click Create New Command.
       
    3. In the Command field, enter the command name.
       Available commands

       Command Name	Description
       /sysaid_create_sr	Create a new SysAid service record and link it to this channel
       /sysaid_link_to_sr	Link this channel to an existing SysAid service record
       /sysaid_my_approvals	Retrieve Approve/Deny workflow notifications (Available in updated Slack Add-on - in SysAid Cloud)

    4. In the Request URL, enter the following URL (same as the redirect URL you entered previously:
       https://<SysAid URL>/addonsConsume/slack?accessToken=<token>
    5. In the Short description enter a summary of what the command does (see the Available Commands table above).
    6. Click Save.
       
28. In SysAid, if the Slack Main Access Token field is populated, follow the following steps to revoke the token:
    1. In Slack, on the Oauth and Permissions page click Revoke Tokens.
    2. When prompted click Yes, I'm sure.
    3. From the side menu, click Select Install app.
    4. Click Reinstall to Workspace.
29. Generate the Main Access Token:
    1. Copy the contents of the Client ID field. Paste the Client ID in notepad or somewhere else for use in the next step.
    2. Open a new browser tab and go the authorization page at the following URL:
       https://slack.com/oauth/authorize?scope=channels:read,commands,groups:history,groups:read,groups:write,im:read,im:write,mpim:read,mpim:write,team:read,users:read,users:read.email,channels:history,channels:write,usergroups:read,users.profile:read,chat:write:user&state=<App Name>-!!-accountToken&client_id=<Client ID>
       Important:

       In the URL above, replace <CLIENT_ID> with the client ID that you just copied and <appname> with the name you've given to this app in Slack.

    3. Click Authorize.
    4. In SysAid, refresh the Slack integration page. The Slack Main Access Token field should populate.
       

30. (Optional) The following features are enabled by default. To disable any of these features clear their corresponding check boxes:

• Automatically add the request user and assigned to admin in newly created channel - When this feature is enabled, whenever you create a private Slack channel from a SysAid ticket, the ticket's request user and assigned admin are automatically added to the Slack channel. This ensures that the relevant parties receive updates regarding this ticket. It also allows them to receive direct messages from this ticket.
• Show deactivated users in service record - When this feature is enabled, users who are deactivated in Slack, still can be selected in the Slack tab in the SysAid ticket.
• Show archived channels in service record - When this feature is enabled, all channels, even archived ones, are displayed in the Slack Channels drop-down in the ticket form.
• Enforce a title when creating service record from slash command - When this feature is enabled, user who create a SysAid ticket from the /sysaid_create_sr will have to add a title to the ticket in the slash command. Entering the slash command without a title generates an error message informing the user that they must include a title for their ticket.

31. Click the Activate Integration slider.
32. Click Save Changes.
33. Repeat this process for up to three Slack accounts that you want to integrate with SysAid.

34. If you have an enterprise grid in slack, you'll need to authorize the new token for each organization once the app has been approved for the first organization.
    

Related Content

Use the Slack Integration