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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.squadcast.com/integrations/alert-source-integrations-native/freshservice.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
