---
title: "IFTTT Integration Guide"
slug: "ifttt-integration-guide"
updated: 2023-01-06T15:49:20Z
published: 2023-01-06T15:49:19Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catchpoint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IFTTT Integration Guide

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](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.

![](https://cdn.document360.io/cb4af8f9-6751-4fd2-b39c-07aae832badb/Images/Documentation/115018197823-mceclip0.png)

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).  

![](https://cdn.document360.io/cb4af8f9-6751-4fd2-b39c-07aae832badb/Images/Documentation/115018197863-mceclip1.png)

## 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](https://docs.catchpoint.com/docs/Alert-Webhook-Macro-Index)