Notification channels

Notification channels tell your team, in Telegram or Slack, when there's work waiting. Add channels once for the organisation under Organisation › Notifications. Then each platform chooses which channels hear about what, under its Settings › Notifications.

Only owners and admins can add, test or change channels.

What gets sent#

A platform can send these kinds of message:

Each message shows only:

• what happened and the platform's name;
• the ticket's subject;
• who sent it (not for failures);
• an Open in Cerberius Agents button.

It never includes the agent's findings, code, logs or the reply text. Those stay in Cerberius Agents.

The button opens the right page on the right platform. If you're signed out, you sign in first and then land on that page.

Add a Telegram chat#

1. Create a bot#

1. 1

   In Telegram, open a chat with @BotFather.

2. 2

   Send /newbot.

3. 3

   Give the bot a display name, such as Acme Support Alerts.

4. 4

   Give it a username that ends in bot, such as acme_support_alerts_bot.

5. 5

   BotFather replies with a token that looks like 123456789:ABC…. Copy it.

2. Let the bot see your chat#

Telegram bots can't message you until you message them.

• Just you: open your new bot in Telegram and send it any message, such as "hi".
• A team group: add the bot to the group, then write any message in the group.

3. Add the channel#

1. 1

   Go to Organisation › Notifications.

2. 2

   Click Add channel.

3. 3

   In the pop-up, choose Telegram under Where to send. The pop-up repeats the steps above in short.

4. 4

   Give it a Name, such as Support team chat.

5. 5

   Paste the token into Bot token.

6. 6

   Click Find my chat. Click your chat in the list. This fills in Chat id.

7. 7

   Click Save channel.

8. 8

   Open the new channel's ⋯ menu, click Send test, and check your chat.

If Find my chat says No chats yet, the bot hasn't seen a message. Send it one (or write in the group), then click Find my chat again.

Add a Slack channel#

1. Get a webhook address#

1. 1

   Go to api.slack.com/apps and click Create New App. Choose From scratch, name it (such as Cerberius Agents) and pick your workspace.

2. 2

   In the app's settings, open Incoming Webhooks and switch Activate Incoming Webhooks on.

3. 3

   Click Add New Webhook to Workspace, pick the channel, and click Allow.

4. 4

   Copy the Webhook URL. It starts with https://hooks.slack.com/services/.

If your workspace already has an incoming-webhook app, you can add a new webhook from it instead.

2. Add the channel#

1. 1

   Go to Organisation › Notifications.

2. 2

   Click Add channel.

3. 3

   In the pop-up, choose Slack under Where to send.

4. 4

   Give it a Name, such as #support-alerts.

5. 5

   Paste the address into Webhook address.

6. 6

   Click Save channel. Then open the channel's ⋯ menu and click Send test.

Choose what each platform sends#

A new channel gets nothing until a platform switches it on.

1. 1

   Switch to the platform.

2. 2

   Go to Settings › Notifications.

3. 3

   For each channel, switch on Reply ready, Change to approve, Investigation failed, Article ideas and Article ready as you like.

4. 4

   Click Save.

See Platform notifications for more.

Manage channels#

The channels are one table. Each row shows:

• Channel: an icon for Telegram or Slack, the name, and a line under it with the kind and the last four characters of the bot token or webhook address;
• Used by: one chip for each platform that sends to it. Not used means no platform does yet;
• Updated: when it was last changed;
• ⋯: Send test, Rename or replace… and Delete.

What each does:

• Send test sends "Test message from Cerberius Agents". Under the name you'll see Test message sent. Check your chat., or why it failed, in plain words.
• Rename or replace… lets you change the name, the Telegram Chat id, or paste a New bot token or New webhook address. Leave the new value empty to keep the saved one. With a new Telegram token, Find my chat shows again.
• Delete removes the channel, after you confirm with Delete channel. The confirmation names the platforms that stop sending to it.

Your phones#

Under the channels, Your phones lists the phones signed in to the Cerberius Agents app as you. It only shows once you've connected a phone. Each row shows the phone's name, whether its notifications are On or Off, when it was connected and when it was last used.

Lost a phone? Open its ⋯ menu, click Sign out, then confirm with Sign out phone. The app on that phone stops working until someone signs in again, and it gets no more notifications.

If the test fails#