Skip to content
QwryAI
Documentation

Explore the documentation

Quick StartWelcome to QwryAI

Get started with QwryAI and discover how to build an AI support assistant trained on your business data.

Quick StartBuild Your First AI Agent

Create a support agent from your website, review its knowledge, and publish it to your site.

Quick StartBest Practices

Use these practices to improve answer quality, reduce failed handoffs, and keep your chatbot useful over time.

Quick StartResponse Quality

Improve how accurately and helpfully your chatbot answers customers.

AI Agent ManagementPlayground

Test and optimize your chatbot before deployment.

AI Agent ManagementData Sources

Add, train, and maintain the knowledge your agent uses to answer customer questions.

AI Agent ManagementDeploy

Add your chatbot to a website or ecommerce storefront.

AI Agent ManagementSettings

Choose the Copilot model, set a rate limit, and block spam and countries.

AI Agent ManagementEmail Settings

Configure email handoff and reply behavior for chatbot support workflows.

AI Agent ManagementLead Forms

Collect customer details directly inside the chat experience.

AI Agent ManagementIntegrations

Connect QwryAI with external platforms and business tools.

AI Agent ManagementDeveloper & Agent Access

Connect QwryAI to external AI tools, MCP clients, scripts, and CLI workflows.

AI Agent ManagementBackstage

Ask questions about your agent and workspace in a dedicated internal conversation.

AI Agent ManagementInstructions

Define your agent's behavior, guardrails, model, and response style.

AI Agent ManagementProcedures

Write a repeatable customer process with instructions, conditions, and actions.

AI Agent ManagementAction approvals

Review the exact input before an action performs a business write.

Pages

Integrations

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
Freshdesk connection form in QwryAI with the subdomain and API key fields

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.

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 fieldWhat QwryAI sends
SubjectA short subject the AI agent writes from the customer's issue. The customer isn't asked for it.
DescriptionAn AI-written summary of the issue, from the customer's point of view and in the customer's language.
RequesterThe customer's name and email.
PriorityLow, Medium, High, or Urgent. The AI agent infers it from the issue and doesn't ask the customer.
StatusOpen.
TypeThe 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.

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