Knowledge Base

Webhook Integration examples for PingPlotter REST API alerts


Microsoft Teams:

  1. (Skip steps 1-6 if you already have an account)
  2. Click here to sign up for MS Teams
  3. Sign up your account for work / organization
  4. You'll get a message saying something like "Setting up Teams"
  5. Download the Windows app or use your browser
  6. (The following instructions are for the Windows app)
  7. After installation, sign in to Microsoft Teams in the Windows app
  8. Create your PingPlotter Alerts channel by clicking the "..." next to your team and clicking Add Channel
  9. Give it a name!
  10. In the bottom left of your screen, click on Apps → Incoming Webhooks → Add to team → Choose your channel
  11. Click the "Set up a Connector" button and give it a name like PingPlotter Webhook → Create
  12. Copy the URL and paste it into the REST Address of PingPlotter. Click Done
  13. In PingPlotter, change the Method to POST and the Content (Data) Type to JSON
  14. Change the Body to look something like this:

    {"text":"Hello, World!"}
    or,
    {"text":"{{Host.HostName}} is experiencing high latency!"}
Use this link for more content: https://www.pingplotter.com/manual/variable_substitution.html


Discord:

  1. Open your Discord app or log in via your browser
  2. Right-click your server avatar on the left pane and select Server Settings → Webhooks
  3. Click Create Webhook. Give it a Name, assign it to a channel, upload an image (may I suggest the PingPlotter logo...?), copy the URL, and hit Save
  4. In PingPlotter, click on a target and open the Alerts sidebar
  5. Select Execute REST Call and give it some parameters
  6. In the REST Address field, paste the URL you copied earlier in step 3
  7. Change the Method to show POST and the Content (Data) Type to show JSON
  8. Using these JSON Params, see these common examples to post PingPlotter data to your Discord channel via the Webhook (in the Body field):

    {"content":"Hello, World!"}
    or,
    {"content":"{{Host.HostName}} is experiencing high latency!"}

    Note: Clicking the "Test" button in PingPlotter will show a message saying "Success: Returned with HTTP status code 204: No Content". You can ignore this message, as it's to be expected from Discord.


Slack:

  1. Log in to Slack in your web browser
  2. Navigate to https://api.slack.com/authentication/basics 3. Build a Slack app
  3. Click Incoming Webhooks → Activate
  4. Scroll down and click Add New Webhook to Workspace
  5. Choose a Channel  Allow
  6. Copy the Webhook URL and paste it into the REST Address in the PingPlotter app (click on a target → click the Alerts sidebar → select Execute REST Call → give it some parameters → REST Address)
  7. Change the REST Method to POST and change the Content (Data) Type to JSON
  8. Change the Body to look something like this:

    {"text":"Hello, World!"}
    or,
    {"text":"{{Host.HostName}} is experiencing high latency!"}


Twist:

  1. Create a specific Twist thread
  2. Click the "..." button and choose Add Integration
  3. Build a Thread integration
  4. Install the integration into your thread
  5. Once installed, you'll see a status comment pop up in the thread that will look something like this: "Austin installed the Austin's webhook integration on this thread"
  6. Click on the title of your webhook to redirect to the settings of that webhook for your thread
  7. Copy the URL on the following page and append "hooks" to the beginning of the URL like this:

    https://hooks.twist.com/api/v3/integration_incoming/post_data?install_id=XXXXX&install_token=XXXXX

  8. Paste the entire URL into the REST Address of your PingPlotter alert
  9. In PingPlotter, change the Method to POST and the Content (Data) Type to JSON
  10. Change the Body to look something like this:

  11. {"content":"Hello, World!"}
    or,
    {"content":"{{Host.HostName}} is experiencing high latency!"}



Article Rating (No Votes)

Rate this article


Article Info

Article Number: 149 | Last Updated: July 20, 2020

This article has been viewed 378 times since July 20, 2020

Filed Under: Alerts

Attachments

There are no attachments for this article.