# Freshdesk

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

## Overview

The QwryAI 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 the Chat Bubble, Help Page, Center Stage, Email and the API.

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

## Before you start

- A QwryAI account with an AI agent
- Your Freshdesk subdomain and API key (see Find your Freshdesk API key)

## How to connect Freshdesk

#### 1. Open your QwryAI AI agent

Go to your QwryAI dashboard and select the AI agent you want to connect.

#### 2. Connect Freshdesk

Go to the Integrations tab, find Freshdesk, and click Connect.

#### 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 below.

![Freshdesk connection form in QwryAI with the subdomain and API key fields](/docs/screenshots/original/qwryai-freshdesk-connect.png)

Freshdesk connection form in QwryAI with the subdomain and API key fields

> 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 Escalate to Human guide 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.

> 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. Connect Freshdesk on the AI agent's Integrations page, entering only the subdomain (for example yourcompany), and check that the card shows Connected.
2. Create a Create ticket Action under Escalations with Freshdesk as the Ticket Platform, and write a clear When to use.
3. If your Freshdesk marks Type as required, set the Action's Freshdesk ticket type field.
4. Turn the Action on for the channels where customers should be able to escalate.
5. 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 QwryAI 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, QwryAI adds a private note with a link to the conversation in your QwryAI dashboard, so your team can read the whole chat.

QwryAI 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
- Priority: High
- Status: Open
- Private note: conversation link in QwryAI, 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, Help Page and Center Stage, a ticket card also shows the ticket number and the name and email it was submitted with. On email and the API, 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. QwryAI stores the ticket number on the conversation, but not the ticket's status or your team's replies.

## Troubleshooting

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

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

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

### The customer was told the ticket couldn't be created

Open the conversation in the Inbox and check what happened. Common causes:

- The API key was revoked or regenerated. The Freshdesk card still shows Connected, so disconnect and connect again with the current key. Disconnecting deletes the Create ticket Actions that use Freshdesk, so note their settings first and create them again after you reconnect.
- 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.

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

> Failed tickets don't send an email or alert. Check the conversation in the Inbox when a customer reports that escalation didn't work.

## Frequently asked questions

### 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 QwryAI. Attachments from the chat aren't added to the ticket.

### 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 or any other QwryAI channel.

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

### 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 connect to the same Freshdesk account.

### 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

- [Escalate to Human: configure when your AI agent escalates, which details it collects first, and which channels it can escalate from](/docs/user-guides/actions/escalate-to-human)
