Skip to main content
Zoho Desk is a cloud-based help desk platform used to manage customer support tickets, workflows, and automation. The ZohoHelpDeskHandler provides a structured interface for interacting with the Zoho Desk REST API, enabling agent-driven and automated ticket management. This handler supports secure OAuth-based authentication and exposes tool-enabled methods to retrieve, update, and transition tickets across statuses, process stages, and blueprint workflows.

​
Example

​
Initialize ZohoHelpDeskHandler

Create the handler using explicit parameters. 
from superagentx_handlers.zoho.helpdesk import ZohoHelpDeskHandler

zoho_handler = ZohoHelpDeskHandler(
    org_id="123456789",
    auth_token="your_oauth_access_token"
)

​
Get Ticket

Retrieve a Ticket by ID:
Fetches full ticket details including status, fields, and metadata. 
ticket = zoho_handler.get_ticket("987654321")
print(ticket["subject"], ticket["status"])

​
Update Ticket

Update Ticket Fields:
Allows updating any mutable ticket field such as priority, description, or custom fields. 
updated_ticket = zoho_handler.update_ticket(
    ticket_id="987654321",
    fields={
        "priority": "High",
        "description": "Issue escalated for immediate attention"
    }
)
print(updated_ticket)

​
Change Ticket Status

Update Ticket Status:
Transitions a ticket between standard statuses like Open, In Progress, or Closed. 
zoho_handler.change_status(
    ticket_id="987654321",
    status="In Progress"
)

​
Change Process Stage

Move Ticket to Custom Process Stage:
Updates a custom field representing internal workflow stages. 
zoho_handler.change_process_stage(
    ticket_id="987654321",
    stage_name="L2 Review"
)

​
Trigger Blueprint Transition

Execute a Blueprint Transition:
Triggers a Zoho Blueprint workflow transition using a transition ID. 
response = zoho_handler.trigger_blueprint_transition(
    ticket_id="987654321",
    transition_id="456789012"
)
print(response)
)