Zoho Desk

Integrate Zoho Desk to create, update, search, and comment on tickets within Lodol.

Adds a public or private comment to a Zoho Desk ticket.

Parameters

Parameter	Type	Required	Description
`ticket_id`	string	No	Zoho Desk ticket ID to update.
`content`	string	No	Comment content to add to the ticket.
`is_public`	boolean	No	Whether the comment is public (true) or internal (false).

Response

{
  "comment_id": "67890",
  "ticket_id": "12345"
}

Creates a Zoho Desk ticket with subject, department, optional contact email, description, priority, and status.

Parameters

Parameter	Type	Required	Description
`subject`	string	No	Ticket subject summarizing the request.
`department_id`	string	No	Zoho Desk department identifier for the ticket.
`contact_email`	string	No	Email address for the requester (optional).
`description`	string	No	Detailed description of the issue.
`priority`	string	No	Optional priority such as Low, High, or Urgent.
`status`	string	No	Optional initial status for the ticket.

Response

{
  "created_time": "2024-01-01T00:00:00Z",
  "status": "Open",
  "ticket_id": "12345"
}

Retrieves details for a specific Zoho Desk ticket.

Parameters

Parameter	Type	Required	Description
`ticket_id`	string	No	Zoho Desk ticket ID to fetch.

Response

{
  "departmentId": "dept1",
  "id": "12345",
  "status": "Open",
  "subject": "Test ticket"
}

Lists Zoho Desk tickets with optional department and status filters.

Parameters

Parameter	Type	Required	Description
`limit`	number	No	Maximum number of tickets to return.
`department_id`	string	No	Optional department ID to filter tickets.
`status`	string	No	Optional status filter for tickets.

Response

{
  "count": 1,
  "data": [
    {
      "id": "12345",
      "subject": "Test"
    }
  ]
}

Searches Zoho Desk tickets with a free-form query string.

Parameters

Parameter	Type	Required	Description
`search_str`	string	No	Search term or criteria to query tickets.
`limit`	number	No	Optional limit for the number of tickets returned.

Response

{
  "count": 1,
  "data": [
    {
      "id": "12345",
      "subject": "Test"
    }
  ]
}

Updates the status of an existing Zoho Desk ticket.

Parameters

Parameter	Type	Required	Description
`ticket_id`	string	No	Zoho Desk ticket ID to update.
`status`	string	No	New status for the ticket.

Response

{
  "modified_time": "2024-01-01T00:00:00Z",
  "status": "Closed",
  "ticket_id": "12345"
}