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

# Freshchat Webhook Setup Guide

> Configure Freshchat to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](https://docs.stackone.com/connectors/freshchat.md#getting-started) on the Freshchat connector page.

## Connect Freshchat webhooks

Freshchat sends conversation events to the single webhook URL saved under **Conversation Webhooks**.

**1. Retrieve StackOne Native Webhook URL**

The **Native Webhook URL** is generated once an account has been linked.

<ul>
  <li>Open the linked account in StackOne.</li>
  <li>Copy the value from **Native Webhook URL**.</li>
</ul>

**2. Enable the events in StackOne**

Turn on the Freshchat events you want to receive and route them to your StackOne webhook.

<ul>
  <li>Open the connector profile.</li>
  <li>Open the **Events** tab.</li>
  <li>Toggle on each event you want to handle and select the StackOne Webhook to deliver it to.</li>
</ul>

**3. Open Admin Settings**

Sign in to your [Freshworks account](https://www.freshworks.com/freshchat/login/) with an admin user.

<ul>
  <li>In the left navigation, hover over the settings icon.</li>
  <li>Click **Admin Settings**.</li>
</ul>

![The Freshchat settings menu with Admin Settings highlighted](https://mintcdn.com/stackone-60/BKTgK3dvBertfGy4/connectors/freshchat/images/events-admin-settings.png?fit=max\&auto=format\&n=BKTgK3dvBertfGy4\&q=85\&s=ec95ce3446c9b53722a86af9b01fec01)

**4. Open Conversation Webhooks**

In **Admin Settings**, select **Marketplace and Integrations**.

<ul>
  <li>Under **API**, click **Conversation Webhooks**.</li>
</ul>

![The Marketplace and Integrations settings with the Conversation Webhooks tile highlighted](https://mintcdn.com/stackone-60/BKTgK3dvBertfGy4/connectors/freshchat/images/events-conversation-webhooks.png?fit=max\&auto=format\&n=BKTgK3dvBertfGy4\&q=85\&s=a88317a4eebb599512a5d7a3ada44c8a)

**5. Enable the webhook**

On the **Webhooks** page, switch the toggle from **Disabled** to **Enabled**.

![The Webhooks page with the Disabled and Enabled toggle highlighted](https://mintcdn.com/stackone-60/BKTgK3dvBertfGy4/connectors/freshchat/images/events-enable-webhook.png?fit=max\&auto=format\&n=BKTgK3dvBertfGy4\&q=85\&s=6be94bbd2df6e28032fb1363e995d60c)

**6. Paste the Native Webhook URL**

Paste the StackOne Native Webhook URL into the **Webhook** field.

![The Webhook URL field highlighted on the Freshchat Webhooks page](https://mintcdn.com/stackone-60/BKTgK3dvBertfGy4/connectors/freshchat/images/events-webhook-url.png?fit=max\&auto=format\&n=BKTgK3dvBertfGy4\&q=85\&s=5dca666b650f4d2e7a4f2bdcfd98f917)

**7. Save the webhook**

Click **Save**. Freshchat starts sending conversation events to StackOne right away.

![The Save button highlighted at the bottom of the Freshchat Webhooks page](https://mintcdn.com/stackone-60/BKTgK3dvBertfGy4/connectors/freshchat/images/events-save.png?fit=max\&auto=format\&n=BKTgK3dvBertfGy4\&q=85\&s=6c369c850dbea3b7c7a7623932ed8405)

## Available webhook events

The following Freshchat events can be enabled.

**1. Message events**

Events related to messages in a conversation.

<ul>
  <li>**Message Created** (`message_create`) — Fired when a user, an agent or the system posts a message in a conversation, including agent private notes</li>
</ul>

**2. Conversation events**

Events related to the conversation lifecycle.

<ul>
  <li>**Conversation Assigned** (`conversation_assignment`) — Fired when a conversation is assigned or reassigned to an agent or a group</li>
  <li>**Conversation Resolved** (`conversation_resolution`) — Fired when a conversation is resolved</li>
  <li>**Conversation Reopened** (`conversation_reopen`) — Fired when a resolved conversation is reopened by a user or an agent</li>
</ul>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.