Prerequisites
The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the Zoho Desk connector page.How Zoho Desk webhooks are set up
There is nothing to configure in Zoho Desk and no URL to copy. When the account is connected, StackOne creates one Zoho Desk webhook named StackOne Integration that covers every event below, and deletes it when the account is disconnected.
- No callback URL to paste. Zoho Desk checks the StackOne address when the webhook is created, and StackOne answers that check for you.
- Zoho Desk sends every supported event to StackOne. Only the events you enable in StackOne are delivered to your webhooks.
- The webhook counts toward your edition’s limit on enabled webhooks (5 on Professional, 10 on Enterprise, 20 on Ultimate).
- The Webhook permission is set per profile under Setup > Users and Control > Permissions > Profiles.
Available webhook events
The following Zoho Desk events can be enabled. Only events selected in StackOne are delivered.
Ticket events
Events on the lifecycle of a ticket. Ticket events also include changes made by time-based Supervise Rules.
- Ticket Created (
Ticket_Add) — Fired when a ticket is created - Ticket Updated (
Ticket_Update) — Fired when a ticket changes, including when it is moved to the Recycle Bin. The payload includes the ticket’s previous state - Ticket Deleted (
Ticket_Delete) — Fired when a ticket is permanently deleted from the Recycle Bin
Ticket activity events
Events on comments, conversations and attachments within a ticket.
- Ticket Comment Added (
Ticket_Comment_Add) — Fired when a comment is added to a ticket - Ticket Comment Updated (
Ticket_Comment_Update) — Fired when a comment on a ticket is edited - Ticket Thread Added (
Ticket_Thread_Add) — Fired when a reply is sent or a message arrives on a ticket, including automatic bounce messages - Ticket Attachment Added (
Ticket_Attachment_Add) — Fired when a file is attached to a ticket - Ticket Attachment Deleted (
Ticket_Attachment_Delete) — Fired when a ticket attachment is permanently deleted from the Recycle Bin
Contact events
Events on contacts, the customers who raise tickets.
- Contact Created (
Contact_Add) — Fired when a contact is created, including one created automatically with a new ticket - Contact Updated (
Contact_Update) — Fired when a contact changes, including when it is moved to the Recycle Bin - Contact Deleted (
Contact_Delete) — Fired when a contact is permanently deleted from the Recycle Bin
Account events
Events on accounts, the customer companies that contacts belong to.
- Account Created (
Account_Add) — Fired when an account is created - Account Updated (
Account_Update) — Fired when an account changes, including when it is moved to the Recycle Bin - Account Deleted (
Account_Delete) — Fired when an account is permanently deleted from the Recycle Bin
Department events
Events on help desk departments. Zoho Desk has no event for a deleted department.
- Department Created (
Department_Add) — Fired when a department is created - Department Updated (
Department_Update) — Fired when a department changes, such as its name
Agent events
Events on agents, the help desk staff. Moving an agent to another department also counts as an update.
- Agent Created (
Agent_Add) — Fired when an agent is invited to the help desk - Agent Updated (
Agent_Update) — Fired when an agent changes, such as their departments - Agent Deleted (
Agent_Delete) — Fired when an agent is deleted
Webhook check event
Emitted while the webhook is being set up, not by help desk activity.
- Active Check (
Webhook_Validation) — Fired when Zoho Desk checks the StackOne address, which happens when the webhook is created or its address changes. It carries no help desk record