IFTTT Integration Guide

  • 2 minute(s) read
Prev Next

IFTTT lets you connect the apps and devices you use every day. It is a free web-based service that allows users to create chains of simple conditional statements, called "recipes", which are triggered based on changes to other web services.

IFTTT employs the following concepts:

  • Channels are the basic building blocks of IFTTT. They mainly describe the data that will be from a certain web service.
  • Triggers are the part of a recipe that cause an Action to occur, based on a specified condition being met.
  • Actions are the steps taken or output produced in response to a trigger.
  • Recipes are a series of Triggers and Actions intended to produce a desired result.
  • Ingredients are basic data elements made available by a Trigger.

For more information, go to https://ifttt.com

Catchpoint Integration

Catchpoint’s Alert Webhook allows Catchpoint to integrate with other tools by pushing data when a Test triggers an alert. Any tool supporting Webhooks or providing a URL to POST data can be used. Alert Webhook templates can be customized to fit a tool’s format and content-type using Macros. If a template needs modification, please contact Catchpoint Support. We are happy to assist you in creating a template meeting your requirements. Below, you will find integration guide on setting up and customizing a template for use with IFTTT. Catchpoint does its best to ensure the relevance of these guides and will be happy to assist you in implementing this integration as described.

Catchpoint - IFTTT Integration Steps

IFTTT Setup

Connect to the Maker channel.

Capture the value of your key. This will be used in the endpoint URL in Catchpoint.

Catchpoint Setup

The Alert Webhook should be used with a custom template to choose what data gets sent via the Webhook to IFTTT.

  1. Click on the API link in the Settings module.
  2. Set the status to Active and Endpoint URL to the endpoint URL below (replace IFTTT-Secret-Key with your key captured from the IFTTT Maker Channel).
    https://maker.ifttt.com/trigger/catchpoint\_\${switch(“\$(notificationLevelid)”,”0”,”warning”,”1”, ”critical”,”3”,”improved”)}/with/key/IFTTT-Secret-Key
  3. In the Alerts Webhook section select the radio button labeled Template.
  4. Click Add new in the template selection drop-down menu. (Existing templates can be edited in the menu by hovering over the template name and selecting the Edit/View Properties icon.
  5. A lightbox will pop-up where you can input a name for the template and define the contents. The content should be valid JSON (see example below).

Alert Macro Usage

The JSON or XML fields can be hardcoded, and may also include values that are set dynamically by the system at runtime, such as the test name, alert severity, conditions that triggered the alert, location of the node for which a test run caused an alert to trigger, etc.

This is accomplished using Macros. The format of a Macro is ${macroName}. At runtime, the system detects each valid macro, and replaces it with the relevant value from that specific test run before sending the JSON or XML to the destination.

A common use-case would be to provide the time when an alert was first triggered, and its severity. The timestamp can be used to link reminders and improved alerts to the original alert. It can also be used to link related alerts and prevent duplication.

In this example, the macros ${notificationLevelId}, ${testName}, and ${testId} are included and will be replaced with their respective values at runtime.

 {“value1” : “${switch(“${notificationLevelId}”,”0”,”WARNING”,”1”,”CRITICAL”,”3”,”IMPROVED ”)}”,
 ”value2” : “${testName}”,”value3” : “${testId}” }

Alert Macro Index

A full list of the available Alert Webhook Macros can be found here: https://docs.catchpoint.com/docs/Alert-Webhook-Macro-Index