Slack Integration
Table of Contents
Note: This document has been imported from the former KB and has not yet been verified.
Slack is a cool team chat app. Check them out at slack.com.
Go get a free account and your whole team can have a proper chat app with rooms, permissions, integrations, a mobile app that doesn't suck, and oh yeah — it integrates with your Syncro account.
Set up Slack Integration
- Head to Admin > App Center.
- Click the Slack app card.
- Click the Inbound Webhook link to add a webhook integration into your Slack account.
- In Slack, next to Incoming WebHooks, click Add.
- Click the Post to Channel dropdown and select which channel you want notifications to go to.
- Click Add Incoming WebHooks Integration.
- Copy the Webhook URL link they provide.
- Copy the post URL link they provide.
- Switch back to Syncro and paste that URL into the Slack Webhook URL field.
- Click Save.
- Navigate to Admin > Notification Center.
- Add a new set or edit an existing one.
- On the far right next to anything you want to show up in your Slack chatroom, check the Webhook checkbox.
- Click Create Notification Set or Update Notification Set.
- Optionally, you can setup notifications in Slack for a specific room too, so these could give you push notifications and desktop notifications for some actions.
Set Up Slack Bot integration
First, go add a "slash command" here.
https://my.slack.com/services/new/slash-commands
Set it up like this:
URL: https://admin.syncromsp.com/api/v1/slack/seattle
Token: Slack generates it. Copy it and paste it into your Slack app card settings page.
It should get put here in Admin > App Center > Slack app card.
These are the slash commands that we currently support:
Message Formatting
Here is a tip shared by a pro user to get the links to your ticket notifications.
If you would like to customize your messages you can try using some of the steps inside Slack's knowledge base article: Formatting text for app surfaces
How to escape characters
There are three characters you must convert to HTML entities and only three: &, <, and >.
- Replace the ampersand, &, with &
- Replace the less-than sign, < with <
- Replace the greater-than sign, > with >
Slack will take care of the rest.
Variables
Some messages contain special words with extra behavior. For these, we use the format <!foo>, where foo is a special command. Currently defined commands are !channel, !here, and !everyone. These indicate an @channel, @here, or @everyone message, and should cause a notification to be displayed by the client.
Note that to display @here on older mobile clients you will need to specify a label with the <!here> command (eg. <!here|here>).