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

# Escalate AI agent conversations to Freshdesk

> Connect Freshdesk so your AI agent can escalate a conversation by opening a ticket for your support team

The Chatbase Freshdesk integration lets your AI agent escalate a conversation to your support team by opening a ticket in Freshdesk. It's for teams that already work their support queue in Freshdesk and want the AI agent to handle routine questions, then pass the rest on with an AI-written summary and a link to the full conversation. Tickets can be created from any channel where the [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) Action runs, such as the Chat Bubble, Help Page, WhatsApp, Instagram, Messenger, and email.

> [card] What you can do:
>
> Let the AI resolve routine questions on its own, and hand off to Freshdesk the moment a case needs a person, with the full context already attached.

**Availability:** Freshdesk needs the Chatbase Basic plan or higher. Freshdesk is one of the [conditionally HIPAA compliant integrations](https://chatbase.co/docs/user-guides/workspace/hipaa-compliance.md#conditionally-hipaa-compliant-integrations).

## Before you start

* A Chatbase account on the Basic plan or higher, with an AI agent
* Your Freshdesk **subdomain** and **API key** (see [Find your Freshdesk API key](#find-your-freshdesk-api-key))

## How to connect Freshdesk

**1. Open your Chatbase AI agent**

Log in to your [Chatbase dashboard](https://www.chatbase.co/dashboard/) and select the AI agent you want to connect.

**2. Connect Freshdesk**

Choose **Integrations**, then click **Connect** under Freshdesk.

**3. Enter your subdomain and API key**

To authorize the integration, you'll need your Freshdesk subdomain and API key. See [Find your Freshdesk API key](#find-your-freshdesk-api-key) below.

Enter only the subdomain, for example `yourcompany`. The field already sits between `https://` and `.freshdesk.com`, so don't type the full address.

**4. Create the Escalations Action**

Configure your Escalations Action to route tickets to Freshdesk. Follow the [Escalations Action guide](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) to set it up.

### Find your Freshdesk API key

1. Log in to your Freshdesk account.
2. Click your profile picture (top-right corner).
3. Select **Profile Settings**.
4. On the right-hand side, locate **Your API Key**.

![Freshdesk connection form in Chatbase with the subdomain and API key fields](https://mintcdn.com/chatbase/0LltFcp54SicR55-/user-guides/integrations/images/freshdesk/freshdesk.png?fit=max\&auto=format\&n=0LltFcp54SicR55-\&q=85\&s=526592bba421f164946fb601531578cd)

> [!TIP]
>
> Test the integration by asking your AI agent to speak to a human, and confirm a ticket appears in Freshdesk with the conversation summary attached.

The connection belongs to this AI agent only. Each AI agent connects to one Freshdesk account, so repeat these steps on every AI agent that should escalate to Freshdesk.

## Setup checklist

Use this list to go from a Freshdesk account to working escalations:

1. Make sure your Chatbase plan is Basic or higher.
2. Connect Freshdesk on the AI agent's **Integrations** page, entering only the subdomain (for example `yourcompany`), and check that the card shows **Connected**.
3. Create a **Create ticket** Action under **Escalations** with **Freshdesk** as the **Ticket Platform**, and write a clear **When to use**.
4. If your Freshdesk marks **Type** as required, set the Action's **Freshdesk ticket type** field.
5. Turn the Action on for the channels where customers should be able to escalate.
6. [Publish](https://chatbase.co/docs/user-guides/chatbot/versions.md) your changes, then ask the AI agent to speak to a human and confirm the ticket appears in Freshdesk.

## What the AI agent sends to Freshdesk

When the AI agent creates a ticket, it first asks the customer for their email and name. If the channel or contact record already has them, such as the sender's address on the email channel, those are used. The AI agent then creates the ticket with these fields:

| Freshdesk field | What Chatbase sends |
| - | - |
| **Subject** | A short subject the AI agent writes from the customer's issue. The customer isn't asked for it. |
| **Description** | An AI-written summary of the issue, from the customer's point of view and in the customer's language. |
| **Requester** | The customer's name and email. |
| **Priority** | Low, Medium, High, or Urgent. The AI agent infers it from the issue and doesn't ask the customer. |
| **Status** | Open. |
| **Type** | The value of the Action's **Freshdesk ticket type** field, only when you set one. Leave it unset to omit it. |

After the ticket is created, Chatbase adds a private note with a link to the conversation in your Chatbase dashboard, so your team can read the whole chat.

Chatbase doesn't send tags, a group, or a source, so Freshdesk's defaults apply to those. Files and images the customer sent in the chat aren't attached to the ticket.

### Example ticket

For example, a customer on the Chat Bubble writes that they were charged twice for one order and wants a refund. The AI agent asks for their name and email, then creates a ticket like this:

* **Subject:** Double charge on order, refund requested
* **Description:** I was charged twice for the same order and would like the duplicate charge refunded.
* **Requester:** Jane Doe, [jane@example.com](mailto:jane@example.com)
* **Priority:** High
* **Status:** Open
* **Private note:** conversation link in Chatbase, followed by the link to the conversation

## What the customer sees

The AI agent tells the customer the ticket was created and shares the ticket number. On the Chat Bubble and other widget channels, a **Ticket Created** card also shows the ticket number and the name and email it was submitted with. If the ticket can't be created, the card reads **Failed to create ticket**. On WhatsApp, Instagram, and email, the customer gets the AI agent's message only.

The AI agent keeps replying in the chat after the ticket is created. Your team's replies from Freshdesk reach the customer the way Freshdesk sends them, which is usually by email, and don't appear in the original chat.

Nothing syncs back from Freshdesk. Chatbase stores the ticket number on the conversation, but not the ticket's status or your team's replies.

## Troubleshooting

> [accordion] Connecting shows "Invalid API key or subdomain."
>
> Freshdesk rejected the key for that subdomain. Copy the key again from **Profile Settings** in Freshdesk, check that the subdomain belongs to the same account, and try again.

> [accordion] Connecting shows "Invalid subdomain" or "Failed to connect to Freshdesk. Please check your subdomain."
>
> The subdomain doesn't match a Freshdesk account. Enter only the part before `.freshdesk.com`, for example `yourcompany`. If you reach Freshdesk through a custom domain, use your original `freshdesk.com` subdomain instead.

> [accordion] The subdomain field says it can only contain alphanumeric characters and hyphens
>
> You entered more than the subdomain, such as `yourcompany.freshdesk.com`. Remove the dots and everything after them.

> [accordion] The customer saw "Failed to create ticket"
>
> Open the conversation in [Activity](https://chatbase.co/docs/user-guides/chatbot/activity.md) and check the **Result** of the Action call for the error Freshdesk returned. Common causes:
>
> * The API key was revoked or regenerated. The Freshdesk card still shows **Connected**, so disconnect and connect again with the current key.
> * Your Freshdesk marks **Type** as required and the Action's **Freshdesk ticket type** field is empty. The field warns you about this when you set up the Action.
> * The customer didn't give an email address. Freshdesk may reject a ticket without one.

> [accordion] Tickets aren't appearing in Freshdesk
>
> Check that the **Create ticket** Action is enabled, uses **Freshdesk** as the **Ticket Platform**, and is turned on for the channel you're testing. Check its **When to use** instructions too, because the AI agent only creates a ticket when those conditions are met. If you saved changes, click **Publish** so the live AI agent uses them.

> [!NOTE]
>
> Failed tickets don't send an email or alert. Check the conversation in **Activity** when a customer reports that escalation didn't work.

## Frequently asked questions

> [accordion] Does Freshdesk receive the full conversation?
>
> No. The ticket description is an AI-written summary, and a private note links to the full conversation in Chatbase. Attachments from the chat aren't added to the ticket.

> [accordion] Can my team reply to the customer in the chat from Freshdesk?
>
> No. Replies from Freshdesk go to the customer the way Freshdesk sends them, usually by email. They don't appear in the Chat Bubble, WhatsApp, or any other Chatbase channel.

> [accordion] Can I set the ticket type or priority?
>
> You can set a fixed ticket type in the Action's **Freshdesk ticket type** field. Priority is chosen by the AI agent for each ticket, from Low to Urgent, based on the customer's issue.

> [accordion] Can I connect more than one Freshdesk account?
>
> Each AI agent connects to one Freshdesk account. To use a different account, connect it on a different AI agent. Several AI agents can usually connect to the same Freshdesk account.

> [accordion] Does creating a ticket use extra message credits?
>
> No. The ticket itself costs nothing extra. The reply in which the AI agent creates it is charged like any reply that calls an Action. See [Credit usage](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#credit-usage).

> [accordion] What happens to my Escalations Actions if I disconnect Freshdesk?
>
> Disconnecting deletes the **Create ticket** Actions that use Freshdesk. A confirmation dialog lists them before anything is deleted.

## Next steps

> [card] [Escalations Action](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md)
>
> Configure when your AI agent escalates, which details it collects first, and which channels it can escalate from.


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