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

Zoho Desk

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

Overview

The QwryAI Zoho Desk integration lets your AI agent open a Zoho Desk ticket when a customer needs a person, with an AI-written summary of the conversation and a link back to the full chat in QwryAI. It's for teams that already work their support queue in Zoho Desk and want the AI agent to handle routine questions first. Tickets can be created from the channels where the Escalations Action runs with Zoho Desk: 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 Zoho Desk the moment a case needs a person, with the full context already attached.

Before you start

  • A QwryAI AI agent. The connection is per AI agent, and each AI agent can connect one Zoho Desk account.
  • A Zoho Desk account you can authorize access for, with at least one department.

QwryAI works with Zoho accounts in every Zoho data center: US, EU, India, Australia, Japan, Canada, Saudi Arabia, the UK, the UAE, and Singapore. You don't pick the region. QwryAI detects it from the Zoho account you sign in with.

How to connect Zoho Desk

1. Open your QwryAI AI agent

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

2. Connect Zoho Desk

Choose Integrations, then click Connect under Zoho Desk. Sign in to Zoho and approve the request to authorize access.

Connecting Zoho Desk from the QwryAI Integrations page
Connecting Zoho Desk from the QwryAI Integrations page

3. Create the Escalations Action

Go to Build → Actions → Create Action, select Create ticket under Escalations, and choose Zoho Desk as the Ticket Platform. Zoho Desk has no extra options on the Action. Follow the Escalate to Human guide for the rest of the setup.

The Create ticket Action with Zoho Desk selected
The Create ticket Action with Zoho Desk selected

Which organization and department get the ticket

When you connect, QwryAI picks one Zoho Desk organization and one department and saves them:

  • Organization: the one marked as default in Zoho, otherwise the first one.
  • Department: that organization's default department, otherwise the first one.

There's no picker for either in QwryAI, and every ticket from this AI agent goes to that department. QwryAI reads them only when you connect, so changing your default department in Zoho Desk later doesn't move new tickets until you disconnect and connect again. Disconnecting deletes the AI agent's Zoho Desk Create ticket Actions, so recreate them afterward.

What the ticket contains

Each Zoho Desk ticket QwryAI creates has:

  • Subject: written by the AI agent from the customer's issue. The customer is never asked for it.
  • Description: a short AI-written summary of the issue in the customer's own words and language.
  • Channel: Chat.
  • Contact: the customer's email, with their full name in the last name field (the first name is left empty).
  • Department: the department chosen when you connected.
  • Private comment: a link to the full conversation in QwryAI, added right after the ticket is created.

QwryAI sets no tags, priority, or custom fields, and doesn't attach files the customer sent in the chat.

What the customer sees

The AI agent asks for the customer's email and name if it doesn't already have them, creates the ticket, and tells the customer the ticket number. On the Chat Bubble, Help Page, and Center Stage, a ticket card also shows the ticket number, its subject and description, and the customer's name and email. If creation fails, the card reads "Failed to create ticket." When Zoho Desk rejects the ticket's data (for example, a subject longer than 255 characters), the AI agent tells the customer what was wrong and offers to try again with a corrected value.

Your team replies from Zoho Desk, and those replies reach the customer the way Zoho Desk sends them, normally by email. Nothing syncs back to the QwryAI conversation, and the AI agent keeps answering in the chat.

Troubleshooting

Connecting fails with a Zoho Desk error

Errors appear as a message starting with Zoho Desk integration failed, for example "Failed to fetch Zoho Desk departments". Make sure the Zoho account you sign in with can see your organization and its departments, and that the organization has at least one department.

Tickets stopped being created, but the card still says Connected

The card shows Connected as long as a saved connection exists, even if Zoho no longer accepts it (for example, after access was revoked in Zoho). Tickets then fail and the AI agent tells the customer no ticket was created. Disconnect and connect again.

Tickets go to the wrong department

QwryAI uses the default department (or the first one) of the default organization, saved when you connected. Set the right default in Zoho Desk, then disconnect and connect again.

Frequently asked questions

Which Zoho data centers does QwryAI support?

US, EU, India, Australia, Japan, Canada, Saudi Arabia, the UK, the UAE, and Singapore. QwryAI detects the region automatically from the Zoho account you sign in with.

Can I choose which department receives tickets?

Not in QwryAI. Tickets go to the default organization's default department (or the first one), chosen when you connect. To change it, update the default in Zoho Desk and reconnect.

Do replies from Zoho Desk show up in the chat?

No. Replies reach the customer from Zoho Desk, normally by email. The only thing the chat shows is the ticket number when the ticket is created.

What happens to my Actions if I disconnect Zoho Desk?

QwryAI lists the Zoho Desk Create ticket Actions and deletes them when you confirm. Tickets already in Zoho Desk aren't affected.

Next steps