PingPlotter Cloud Manual

Alert Integrations


Alert Integrations connect PingPlotter Cloud to the apps your team already uses. Once a Slack workspace or Microsoft Teams team is connected, any Alert can post a rich alert card to its channels, with the alert's details, a picture of the timeline graph, and a button that takes you straight to the data. You can also add email addresses that aren't users on your account, like a NOC or help desk inbox, for email alerts.

To open it, go to Manage --> Alert Integrations. You'll need the User Management permission to see this page and connect or remove integrations. Anyone who can edit Alerts can use the integrations once they're connected.

The Alert Integrations page with a Slack workspace, a Teams team, and an email address connected.

Add an Integration

Click + Add Integration in the upper-right and choose one:

  • Slack - post alert cards to the channels you choose in a Slack workspace.
  • Microsoft Teams - post alert cards to the channels you choose in a Microsoft Teams team.
  • Email - send alert emails to any verified address that isn't a user on your account, like a NOC or help desk inbox.
  • Something Else - tell us which app you'd like alerts sent to.

You can connect as many workspaces, teams, and email addresses as you need.

Slack

You'll need permission to add apps to your Slack workspace.

  1. Click + Add Integration, then Slack. If nothing is connected yet, you can click Add to Slack instead.
  2. Slack opens. Pick your workspace, review the permissions, and click Allow.
  3. You're returned to PingPlotter Cloud, and the Alert channels window opens. Check the channels Alerts can post to and click Save.

Now add a Send to Slack action to any Alert. See Send Alerts to Slack or Teams. The same workspace can be connected to more than one PingPlotter Cloud account.

The PingPlotter app only posts alerts. It asks Slack for permission to post messages (including in public channels it hasn't been invited to), see the names of public channels and private channels it's been invited to, and upload timeline graph images. It can't read messages in your channels.

Private Slack channels

PingPlotter can post to any public channel without being invited. Private channels only show up in the channel list once @PingPlotter has been invited to them. In the private channel, type /invite @PingPlotter, then click the pencil icon on the workspace's card and check it.

Microsoft Teams

Connecting a team takes two parts: adding the PingPlotter app to the team in Microsoft Teams, then confirming the connection in PingPlotter Cloud.

1. Add the PingPlotter app to a team

  1. Download the PingPlotter app for Teams from PingPlotter Cloud. Don't unzip it.
  2. In Microsoft Teams, click Apps --> Manage your apps --> Upload an app --> Upload a custom app, and choose the file you downloaded.
  3. Click Add to a team, then pick the team you want alerts in.

Don't see Upload a custom app?

Your organization may not allow custom apps. Ask your Microsoft Teams administrator to upload the app for you, or to allow custom apps in the Teams admin center.

2. Connect the team in PingPlotter Cloud

Once it's added, the PingPlotter app posts a Connect this team to PingPlotter Cloud card in the team.

  1. Click Connect in PingPlotter Cloud on the card. Anyone can share the card, but the person who clicks it needs the User Management permission.
  2. Sign in to PingPlotter Cloud if you're asked to. Check the team's name, then click Connect.
  3. The Alert channels window opens. Check the channels Alerts can post to and click Save.

The app posts Connected to PingPlotter Cloud in the team to let everyone know. Now add a Send to Teams action to any Alert. See Send Alerts to Slack or Teams.

The connection code on the card works for 15 minutes. If it's expired, remove the PingPlotter app from the team and add it again to get a new one. Each team is connected separately, and the app only works in teams, not in chats.

Private Teams channels

Before Alerts can post to a private channel, the PingPlotter app has to be added to that channel too. Open the channel in Teams, click Manage channel --> Apps, and add PingPlotter.

Send Alerts to Slack or Teams

Once a workspace or team is connected, two new action types appear in the Actions section of the Alert editor: Send to Slack and Send to Teams.

A Send to Slack action in the Alert editor.

  1. Choose Send to Slack or Send to Teams from the Action dropdown.
  2. Pick the Workspace or Team. If you've only connected one, it's picked for you.
  3. Pick the Channel. Only channels enabled by an administrator are listed.
  4. Click Test to post a sample card to the channel right away.

Send to Slack and Send to Teams work for both Per target and Combined actions, and for groups and tiers. They also have these options:

  • Attach a timegraph image - include a picture of the target's timeline graph. On by default. Only available for Per target actions.
  • Mention - Slack only. Choose @here (people who are active in the channel) or @channel (everyone in the channel) to notify people. Set to None by default.
  • Customize Message - change the card's Headline and Body. See Customize the Message.

Tip: If you haven't connected anything yet and you have the User Management permission, an Integrations button appears next to the Action dropdown. It opens Alert Integrations in a new tab.

The Alert Card

An alert card posted to Slack.

Each card includes:

  • A headline - e.g. 🔴 Poor VoIP triggered, or 🟢 Poor VoIP recovered after 12 minutes.
  • The details - the Target, Agent, and Quality by default. Combined actions show the threshold and how many targets are triggered, and list up to 10 of them.
  • When it happened - the Triggered, Retriggered, and Recovered times, plus how long it lasted. Times are shown in each reader's own time zone.
  • A timegraph image - the 30 minutes leading up to the problem, or the whole incident when it recovers. Very large images are left off Teams cards.
  • View in PingPlotter Cloud - opens the target zoomed in on the incident, so it still shows the right data days later.

Threads and Recovery

Each incident stays in one conversation. Reminders from Retrigger while active are posted as replies under the original card. When the problem recovers, PingPlotter Cloud posts a reply and turns the original card green, so you can tell at a glance which problems are over.

This only works when the recovery action posts to the same channel as the trigger action. When you check Notify when recovered, pick the same channel again.

Customize the Message

Click Customize Message to change the card. The Headline replaces the default headline, including the 🔴 and 🟢. In the Body, put one item on each line. A line like Site: Main Office shows as a labeled detail, and other lines show as text. The times and the View in PingPlotter Cloud button are always added below.

Both can use variables. For example, Agent: {{AgentName}}. Click Restore Default Message to undo your changes.

Delivery

If a message can't be posted, PingPlotter Cloud tries again every minute. While it's retrying, new messages from the same action are skipped so they don't pile up. Every message, and any problem posting it, shows up in the Alert Log.

Manage Your Integrations

Each integration has its own card on the page showing who connected it and when, and its Status:

  • Connected - Alerts can send to it.
  • Needs attention - something changed on the Slack or Teams side, like the PingPlotter app being removed. The reason is shown below the status. Click the Reconnect icon to fix it.
  • Verified or Pending verification - for email addresses. See Verified Email Addresses.

Slack and Teams cards also list their Alert Channels. Use the icons in the upper-right of a card to Edit alert channels (pencil), Reconnect, or Disconnect (trash).

Disconnect

Click the trash icon on a card to disconnect it. Alert actions that send to it will fail. Connecting it again later makes a new connection, so pick the workspace or team and channel again in any Alerts that used it. To fix one that says Needs attention, use Reconnect instead, which keeps your Alerts as they are.

  • Slack - PingPlotter Cloud also removes the PingPlotter app from your workspace, unless another PingPlotter Cloud account is still using it.
  • Microsoft Teams - this only disconnects the team from PingPlotter Cloud. To remove the app itself, uninstall it from the team in Teams. To connect the team again, remove the app and add it back to get a new connection code.
  • Email - see Remove an Address.

Request an Integration

Need alerts in an app we don't connect to yet? Click Request an Integration at the bottom of the page, or choose Something Else under + Add Integration. Tell us which app would help, and optionally what you're trying to accomplish, then click Send Request. Your request goes to our support team, and we'll let you know when it's available.

In the meantime, you can usually reach other apps with the Make an HTTP Request action.