# Squadcast

## Overview <a href="#overview" id="overview"></a>

Squadcast is an incident management platform built on DevOps & SRE best practices to help you adopt the same to simplify incident management, get meaningful notifications, and enable faster incident resolution in collaboration.

## Use Cases <a href="#use-cases" id="use-cases"></a>

The integration between Fylamynt and Squadcast lets you:

* Trigger Fylamynt workflow on a Squadcast incident
* Acknowledge a Squadcast incident
* Resolve a Squadcast incident

## Configure Squadcast in Fylamynt

* Navigate to **Settings** > **Integrations** > **Squadcast**
* Configure a new integration instance

Details needed to set up **Squadcast instance** in **Fylamynt**:

| **Parameter**          | **Description**                                      |
| ---------------------- | ---------------------------------------------------- |
| Squadcast API Token    | API Token obtained from Squadcast                    |
| Fylamynt API Key name  | Fylamynt API Key name                                |
| Fylamynt API Key value | Fylamynt API Key value                               |
| Fylamynt Webhook URL   | Fylamynt Webhook URL to be used by Squadcast service |

**Instructions to setup Squadcast Integration**

* Login to your Squadcast account.&#x20;
* Navigate to your **profile** settings and copy the **API Refresh Token**
* Paste the copied **API Refresh Token** to the **Squadcast API Token** field in the Authorize Fylamynt card on the Squadcast Integration settings page.
* Configure the Fylamynt webhook in Squadcast&#x20;
  * Navigate to Settings -> Webhooks
  * Click **+** to add a new webhook
  * Enter the webhook name
  * Click Create
* Complete the webhook configuration&#x20;
  * *URL:*&#x20;
  * Select **POST** Method
  * Copy the **Squadcast Webhook URL** from the Authorize Fylamynt card and paste it into the **URL** field next to POST.&#x20;
  * *Additional headers:*&#x20;
  * Enter **x-api-key** as the **header key**
  * From the Authorize Fylamynt card, choose one of the Webhook API Key Name from the dropdown, and the corresponding Webhook API Key Value should be shown
    * If no options are available for the Webhook API Key Name, first go to **Settings --> Resources -> API Keys** to create a New API Key
  * Copy the **Webhook API Key Value** and paste it into the **header value** field
  * *Filters :*
  * **Do not** configure or add any Filters to this webhook
  * Click **Update**

## Integration Actions

You can add the following actions in the Fylamynt workflow builder, as part of your workflow.

1. [Squadcast Acknowledge Incident](#squadcast-acknowledge-incident)
2. [Squadcast Alert Trigger](#squadcast-alert-trigger)
3. [Squadcast Resolve Incident](#squadcast-resolve-incident)

### **Squadcast Acknowledge Incident**

Acknowledge a Squadcast incident

**Input**

| **Parameter Name**    | **Description**                                | **Required** |
| --------------------- | ---------------------------------------------- | ------------ |
| Squadcast Incident Id | The ‘id’ of Squadcast incident to acknowledge. | True         |

**Output**

| **Parameter Name** | **Type** | **Description** |
| ------------------ | -------- | --------------- |

| **Parameter Name** | **Type** | **Description**                                           |
| ------------------ | -------- | --------------------------------------------------------- |
| incident\_id       | String   | The ‘id’ of Squadcast incident successfully acknowledged. |

**Action Example**

![](https://2168485084-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXYvxfYq9m2JdKqaCdk%2Fuploads%2Fr2fCT2ieHFj9hzYqbp4w%2FScreenshot%202022-01-12%20at%201.39.01%20PM.png?alt=media\&token=5b93c672-065e-49ec-9d69-43682017cdf6)

### **Squadcast Alert Trigger**

The integration node triggers the automatic execution of a workflow from a selected **Squadcast Service**. &#x20;

When creating a workflow, you are presented with a wizard to select the trigger type to use.

* On the workflow page, select **New Workflow**
* Enter the name of the Workflow.
* Select the **Squadcast** trigger type.
* Click **Create Workflow**
* ![](https://2168485084-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXYvxfYq9m2JdKqaCdk%2Fuploads%2FT3wLPVGYC6tkJirHUrVT%2Fimage.png?alt=media\&token=5868e665-dd39-4844-8ac2-ef84daca135f)

#### Configure the automatic execution of a workflow <a href="#fylamynt-task-management" id="fylamynt-task-management"></a>

To automatically run workflows with the Squadcast alert trigger, the incident type and assignment need to be configured. Follow the step-by-step instructions provided on the[ Incident Management - Automatic workflow execution](https://docs.fylamynt.com/getting-started-1/7.-incident-management-automatic-workflow-execution) page.

### **Squadcast Resolve Incident**

Resolve a Squadcast incident

**Input**

| **Parameter Name**    | **Description**                            | **Required** |
| --------------------- | ------------------------------------------ | ------------ |
| Squadcast Incident Id | The ‘id’ of Squadcast incident to resolve. | True         |

**Output**

| **Parameter Name** | **Type** | **Description**                                       |
| ------------------ | -------- | ----------------------------------------------------- |
| incident\_id       | String   | The ‘id’ of Squadcast incident successfully resolved. |

**Action Example**

![](https://2168485084-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXYvxfYq9m2JdKqaCdk%2Fuploads%2FK50TiMtuWbBIdqpko3j5%2FScreenshot%202022-01-12%20at%201.40.37%20PM.png?alt=media\&token=b01c5976-1f12-4ef8-99f5-97f79a802012)