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