# Freshservice

[<mark style="color:blue;">Freshservice</mark>](https://freshservice.com/) extends digital capabilities and delivers exceptional employee experiences with an intuitive, scalable, no code solution.

Route detailed ticket alerts from Freshservice to the right users in Squadcast.

### How to integrate Freshservice with Squadcast

### In Squadcast: Using Freshservice as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media&#x26;token=aaca6610-9d18-4dd4-9cf5-320042f326f1" alt="How to configure Freshservice integration in Squadcast for incident management" width="563"><figcaption><p>Image. How to configure Freshservice integration in Squadcast</p></figcaption></figure>

2\. Select **Freshservice**. Copy the displayed **Webhook URL** to [configure](#in-freshservice-create-a-squadcast-webhook-alert) it within **Freshservice.** Finish by clicking **Add Alert Source** -> **Done**.

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-07a0deb1666fec8fa00c71b5e8f3628d2d4a1141%2FFreshservice.png?alt=media&#x26;token=d4797e13-2bf3-4a36-9ca2-f13a12c6140d" alt="Steps to add Freshservice integration to a service in Squadcast for incident management" width="563"><figcaption><p>Image. Steps to add Freshservice integration to a service in Squadcast</p></figcaption></figure>

{% hint style="warning" %} <mark style="color:orange;">**Important**</mark>**:**

When an alert source turns <mark style="color:green;">Active</mark>, it’ll show up under Configured Alert Sources. You can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source.\
\
An Alert Source is <mark style="color:green;">active</mark> if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### In Freshservice: Create a Squadcast webhook alert

1. In the app, go to **Admin > Workflows Automator** to create the webhook

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-d2506346712b1795a98c5a3621f4052e50176d42%2Ffreshservice_2.png?alt=media&#x26;token=8c327143-c48f-4d8b-b77b-7eb5e5e2cd42" alt="Create a Squadcast webhook alert for incident management" width="375"><figcaption></figcaption></figure>

2. Click on **New Automator** and select the suitable category from the drop-down. Here, we have selected **Ticket**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-67511ae862ab3731fd2824c79f07e7e1c785ad4e%2Ffreshservice_3.png?alt=media" alt="Create Ticket under New Auntomator for incident management" width="185"><figcaption></figcaption></figure>

3. Provide a **Title** and an optional **Description**. Next, click on **Create**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-129185cd5784aaeaebe9d0eaff3a0b0764a203b4%2Ffreshservice_4.png?alt=media" alt="Add Title and Description for incident management" width="375"><figcaption></figcaption></figure>

4. In the **Events** section, you can select and add the **Events** of your choice. Here, we have added 3 Events as shown in the screenshot. Then, click on **Done**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-457d5f7b206628034720d6493eb5fa6897a8f0a2%2Ffreshservice_5.png?alt=media" alt="Adding events for raising tickets for incident management" width="375"><figcaption></figcaption></figure>

5. Drag **ACTION** from the menu on the left onto the screen

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-c74456ba926c3182d63a4c5dd1cbe1e3e3a05769%2Ffreshservice_6.png?alt=media" alt="Add actions for incident management" width="375"><figcaption></figcaption></figure>

a. From the drop-down for **Perform these actions on**, select **Ticket**

b. Then, from the next drop-down, select **Trigger Webhook**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-8b242e6e6ccf319c6009e373abbc7892c7562950%2Ffreshservice_7.png?alt=media" alt="Perform these actions to Trigger webhook for incident management" width="375"><figcaption></figcaption></figure>

c. Choose **Request Type** as `POST`

d. In **Callback URL** paste the previously copied Squadcast webhook URL here

e. Choose **Encoding** as `JSON` and `Simple`

f. In **Content**, you can select all of the available fields to send complete information as the alert to Squadcast.

As the bare minimum, please select the below:

```json
ticket_status
ticket_id
ticket_priority
ticket_subject
ticket_due_by_time
ticket_description
ticket_source
ticket_department_name
ticket_category
ticket_url
ticket_portal_url
approval_url
approval_portal_url
ticket_group_name
associated_asset_names
ticket_tags
ticket_agent_email
ticket_agent_name
ticket_requester_name
ticket_requester_email
ticket_requester_phone
```

g. Then, click on **Done**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-c19fe5885ab081e1640787d46048b4bacacac628%2Ffreshservice_8.png?alt=media&#x26;token=ee155f18-0df3-46c0-bdcd-a1f11666eed2" alt="Verify all the details" width="375"><figcaption></figcaption></figure>

{% hint style="info" %} <mark style="color:blue;">**Note**</mark>**:**

The **Test Webhook** option sends empty data on the configured **Callback URL**. As a result, since no data is available in the alert payload, no incident is created in Squadcast for it. **Please create a test ticket post configuring this webhook as indicated in this document to see a test incident created for it in Squadcast**, to ensure that the configuration is working as expected.
{% endhint %}

6. Click on **Activate**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-cfacd642c0e989e5f57eb1de2e3c2d8bc298281d%2Ffreshservice_9.png?alt=media" alt="Activate the webhook" width="274"><figcaption></figcaption></figure>

7. Do the following for sending **resolve alerts** to Squadcast:

a. Follow steps **1-3**

b. Fill in the form as shown in the screenshot below:

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-0391dbf21ca3c08fc545bb9381185875e0c7da79%2Ffreshservice_10.png?alt=media" alt="For sending resolved alerts for Squadcast" width="375"><figcaption></figcaption></figure>

c. Follow steps **5 and 6**

8. Next, to create the alert, follow the steps below:

a. Click on **➕**(plus) icon and select any of the available options in the drop-down. Here, we have selected **Incident**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-76c3f3e06aa5759787865d38ee4e99a92548325b%2Ffreshservice_11.png?alt=media&#x26;token=031ae56d-bfe8-4583-8680-33db76dd4e90" alt="To create incidents for incident management" width="375"><figcaption></figcaption></figure>

b. Fill out the form and click on **Save**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-c80b16d1d5aaa5b7e1994f5fcb1f471ba158a238%2Ffreshservice_12.png?alt=media" alt="Fill the form and Save" width="375"><figcaption></figcaption></figure>

* **Status** `Open` -> **to trigger incident at Squadcast**
* **Status** `Resolved` -> **to resolve incident at Squadcast**
* **Status** `Closed` -> **to resolve incident at Squadcast**

{% hint style="info" %}
**Note:**

If you have configured [Custom Statuses](https://support.freshservice.com/support/solutions/articles/156452-customizing-helpdesk-statuses) in Freshservice and want to use one of the configured Custom Statuses for ticket creation/resolution (in turn, triggering/resolving corresponding incidents in Squadcast), kindly reach out to <support@squadcast.com> for further details on this.
{% endhint %}

That is it, you are now good to go!

* Whenever a ticket is created with `Open` status, an incident will be created in Squadcast.
* When the ticket is either `Solved` or `Closed` in Freshservice, the corresponding incident will automatically get resolved in Squadcast as well.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*
