public class

ZendeskConnector

extends Object
java.lang.Object
   ↳ org.mule.modules.zendesk.ZendeskConnector
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

Zendesk is a customer support platform that supports more than 25,000 businesses and 60 million customers in 140 countries around the globe. Many of these businesses use the Zendesk API to automate and enhance their customer support with Zendesk.

Summary

Fields
private WebResource apiResource
private String apiUrl Zendesk API endpoint.
private Client client Jersey client
private JerseyUtil jerseyUtil
Public Constructors
ZendeskConnector()
Public Methods
void applyMacro(Long macroId)
void applyMacroToTicket(Long macroId, Long ticketId)
Apply macro to an specific ticket

Check Zendesk API documentation

Ticket bulkImportTicket(Ticket ticket)
It allows moving data from legacy systems into Zendesk.
TopicComment checkForVote(Long topicId)
Check topic for vote

Check Zendesk API documentation

void connect(String username, String password)
Connect to Zendesk
String connectionId()
Are we connected
Automation createAutomation(Automation automation)
Category createCategory(Category category)
Forum createForum(Forum forum)
ForumSubscription createForumSubscription(ForumSubscription forumSubscription)
Create forum subscription

Check Zendesk API documentation

Group createGroup(Group group)
GroupMembership createGroupMembership(GroupMembership groupMembership)
Macro createMacro(Macro macro)
Organization createOrganization(Organization organization)
Create organization

Check Zendesk API documentation

Request createRequest(Request request)
SatisfactionRating createSatisfactionRating(SatisfactionRating satisfactionRating)
Create satisfaction rating

Check Zendesk API documentation

Ticket createTicket(Ticket ticket)
Creates a new Zendesk ticket

Check Zendesk API documentation

TicketField createTicketField(TicketField ticketField)
Create a new ticket field

Check Zendesk API documentation

Topic createTopic(Topic topic)
TopicComment createTopicComment(TopicComment topicComment)
Create Topic comment

Check Zendesk API documentation

TopicSubscription createTopicSubscription(TopicSubscription topicSubscription)
Create Topic subscription

Check Zendesk API documentation

TopicVote createTopicVote(TopicVote topicVote)
Trigger createTrigger(Trigger trigger)
User createUser(User user)
UserIdentity createUserIdentity(UserIdentity userIdentity)
Create an user identity for a given user

Check Zendesk API documentation

View createView(View view)
void deleteAttachment(Long attachmentId)
void deleteCategory(Category category)
void deleteForum(Forum forum)
void deleteForumSubscription(ForumSubscription forumSubscription)
Delete forum subscription

Check Zendesk API documentation

void deleteGroup(Group group)
void deleteGroupMembership(GroupMembership groupMembership)
void deleteMacro(Macro macro)
void deleteOrganization(Organization organization)
Update organization

Check Zendesk API documentation

void deleteSuspendedTicket(Long suspendedTicketId)
Delete a suspended ticket

Check Zendesk API documentation

Ticket deleteTicket(Ticket ticket)
void deleteTopic(Topic topic)
void deleteTopicComment(TopicComment topicComment)
Delete topic comment

Check Zendesk API documentation

void deleteTopicSubscription(TopicSubscription topicSubscription)
Delete topic subscription

Check Zendesk API documentation

void deleteTopicVote(TopicVote topicVote)
void deleteUpload(String token)
User deleteUser(User user)
UserIdentity deleteUserIdentity(UserIdentity userIdentity)
Delete user identity

Check Zendesk API documentation

void disconnect()
Disconnect
ViewExecute executeView(Long viewId)
ActivityStream getActivity(Long activityId)
WebResource getApiResource()
String getApiUrl()
Attachment getAttachment(Long attachmentId)
Automation getAutomation(Long automationId)
Category getCategory(Long categoryId)
Client getClient()
Locale getCurrentLocale()
User getCurrentUser()
Returns current user information
Forum getForum(Long forumId)
ForumSubscription getForumSubscription(Long forumSubscriptionId)
Get forum subscription

Check Zendesk API documentation

Group getGroup(Long groupId)
Get group for given group id

Check Zendesk API documentation

GroupMembership getGroupMembership(Long groupMembershipId)
Get membership information

Check Zendesk API documentation

GroupMembership getGroupMembershipByUser(Long groupMembershipId, Long userId)
Get membership information

Check Zendesk API documentation

JerseyUtil getJerseyUtil()
Locale getLocale(Integer localeId)
Macro getMacro(Long macroId)
Organization getOrganization(Long organizationId)
Get organization info

Check Zendesk API documentation

OrganizationRelated getOrganizationRelated(Long organizationId)
Get organization related information

Check Zendesk API documentation

Request getRequest(Long requestId)
Get request information

Check Zendesk API documentation

TicketComment getRequestComment(Long requestId, Long commentId)
Get a particular comment for a given request

Check Zendesk API documentation

SatisfactionRating getSatisfactionRating(Long satisfactionRatingId)
Get satisfaction rating info

Check Zendesk API documentation

SuspendedTicket getSuspendedTicket(Long suspendedTicketId)
Get suspended ticket

Check Zendesk API documentation

Ticket getTicket(Long ticketId)
TicketAudit getTicketAudit(Long ticketId, Long auditId)
TicketMetric getTicketMetrics(Long ticketId)
Collection<Ticket> getTicketsFromView(Long viewId)
Get tickets from view

Check Zendesk API documentation

Topic getTopic(Long topicId)
TopicComment getTopicComment(Long topicId, Long topicCommentId)
TopicSubscription getTopicSubscription(Long topicSubscriptionId)
Get topic subscription

Check Zendesk API documentation

Trigger getTrigger(Long triggerId)
User getUser(Long userId)
Get user information

Check Zendesk API documentation

UserIdentity getUserIdentity(Long userId, Long userIdentityId)
Get an user identity

Check Zendesk API documentation

UserRelated getUserRelated(Long userId)
Get user related information

Check Zendesk API documentation

View getView(Long viewId)
Get a view information

Check Zendesk API documentation

ViewExecute getViewCounts(List<String> viewIds)
Calculates the size of the view in terms of number of tickets the view will return

Check Zendesk API documentation

Topic importTopic(Topic topic)
Creates a topic without sending out notifications.
TopicComment importTopicComment(TopicComment topicComment)
Creates a comment without sending out notifications.
boolean isConnected()
Are we connected
Collection<Automation> listActiveAutomations()
List active automations

Check Zendesk API documentation

Collection<Macro> listActiveMacros()
Collection<Trigger> listActiveTriggers()
List active triggers

Check Zendesk API documentation

Collection<View> listActiveViews()
Collection<ActivityStream> listActivities()
Collection<Group> listAssignableGroups()
List assignable groups

Check Zendesk API documentation

Collection<Automation> listAutomations()
Collection<Category> listCategories()
Collection<View> listCompactViews()
Collection<ForumSubscription> listForumSubscriptions()
List forum subscriptions

Check Zendesk API documentation

Collection<ForumSubscription> listForumSubscriptionsByForum(Long forumId)
List forum subscriptions by forum

Check Zendesk API documentation

Collection<Forum> listForums()
Collection<Forum> listForumsByCategory(Long categoryId)
List forums by category

Check Zendesk API documentation

Collection<GroupMembership> listGroupAssignableMemberships()
List group memberships by group

Check Zendesk API documentation

Collection<GroupMembership> listGroupAssignableMembershipsByGroup(Long groupId)
List assignable memberships by group

Check Zendesk API documentation

Collection<GroupMembership> listGroupMemberships()
List group memberships

Check Zendesk API documentation

Collection<GroupMembership> listGroupMembershipsByGroup(Long groupId)
List group memberships by group

Check Zendesk API documentation

Collection<GroupMembership> listGroupMembershipsByUser(Long userId)
List group memberships by user

Check Zendesk API documentation

Collection<Group> listGroups()
Collection<Locale> listLocales()
Collection<Macro> listMacros()
Collection<Organization> listOrganizations()
Collection<SatisfactionRating> listReceivedSatisfactionRatings()
List received satisfaction ratings

Check Zendesk API documentation

Collection<TicketComment> listRequestComments(Long requestId)
List requests comments

Check Zendesk API documentation

Collection<Request> listRequests()
Collection<Request> listRequestsByStatus(String status)
List requests by status.
Collection<Request> listRequestsByUser(Long userId)
List requests by user

Check Zendesk API documentation

Collection<SatisfactionRating> listSatisfactionRatings()
List satisfaction ratings

Check Zendesk API documentation

Collection<SharingAgreement> listSharingAgreements()
List sharing agreements

Check Zendesk API documentation

Collection<SuspendedTicket> listSuspendedTickets()
List suspended tickets

Check Zendesk API documentation

Collection<TicketAudit> listTicketAudits(Long ticketId)
List Ticket audits for a given ticket

Check Zendesk API documentation

Collection<TicketField> listTicketFields()
List Ticket audits for a given ticket

Check Zendesk API documentation

Collection<TicketMetric> listTicketMetrics()
List ticket metrics

Check Zendesk API documentation

Collection<Ticket> listTickets()
Get list of tickets

Check Zendesk API documentation

Collection<TopicComment> listTopicComments(Long topicId)
List topic comments

Check Zendesk API documentation

Collection<TopicComment> listTopicCommentsByUser(Long userId)
List topic comments by user

Check Zendesk API documentation

Collection<TopicSubscription> listTopicSubscriptions()
List topic subscriptions

Check Zendesk API documentation

Collection<TopicSubscription> listTopicSubscriptionsByTopic(Long topicId)
List topic subscriptions by topic

Check Zendesk API documentation

Collection<TopicVote> listTopicVotes(Long topicId)
Collection<TopicVote> listTopicVotesByUser(Long userId)
List topic votes by user

Check Zendesk API documentation

Collection<Topic> listTopics()
Collection<Topic> listTopicsByForum(Long forumId)
List topics by forum

Check Zendesk API documentation

Collection<Topic> listTopicsByUser(Long userId)
List topics by user

Check Zendesk API documentation

Collection<Trigger> listTriggers()
Collection<UserIdentity> listUserIdentities(Long userId)
Return all user identities for a given user id

Check Zendesk API documentation

Collection<User> listUsers()
Collection<User> listUsersByGroup(Long groupId)
Get users per group id

Check Zendesk API documentation

Collection<User> listUsersByOrganization(Long organizationId)
Get users per organization id

Check Zendesk API documentation

Collection<View> listViews()
UserIdentity makeUserIdentityPrimary(UserIdentity userIdentity)
Make user identity the primary

Check Zendesk API documentation

void recoverSuspendedTicket(Long suspendedTicketId)
Recover a suspended ticket

Check Zendesk API documentation

UserIdentity requestUserIdentityVerification(UserIdentity userIdentity)
Request user id verification

Check Zendesk API documentation

Iterable search(EntityType type, String query, String sortBy, String sortOrder)
The search API is a unified search API that returns tickets, users, organizations, and forum topics.
Collection<Organization> searchOrganization(String searchTerm)
Search organization

Check Zendesk API documentation

void setApiResource(WebResource apiResource)
void setApiUrl(String apiUrl)
void setClient(Client client)
Collection<GroupMembership> setGroupMembershipAsDefault(GroupMembership groupMembership)
Set a group membership as default

Check Zendesk API documentation

void setJerseyUtil(JerseyUtil jerseyUtil)
JobStatus showJobStatus(Long jobStatusId)
Automation updateAutomation(Automation automation)
Category updateCategory(Category category)
Forum updateForum(Forum forum)
Group updateGroup(Group group)
Macro updateMacro(Macro macro)
Organization updateOrganization(Organization organization)
Update organization

Check Zendesk API documentation

Request updateRequest(Request request)
Ticket updateTicket(Ticket ticket)
TicketField updateTicketField(TicketField ticketField)
Update ticket field

Check Zendesk API documentation

Topic updateTopic(Topic topic)
TopicComment updateTopicComment(TopicComment topicComment)
Update topic comment

Check Zendesk API documentation

Trigger updateTrigger(Trigger trigger)
User updateUser(User user)
View updateView(View view)
FileUpload uploadAttachment(InputStream content, String mediaType, String filename, String token)
Upload File attachment

Check Zendesk API documentation

UserIdentity verifyUserIdentity(UserIdentity userIdentity)
Verify user identity

Check Zendesk API documentation

[Expand]
Inherited Methods
From class java.lang.Object

Fields

private WebResource apiResource

private String apiUrl

Zendesk API endpoint. E.g.: https://{subdomain}.zendesk.com/api/v2

private Client client

Jersey client

private JerseyUtil jerseyUtil

Public Constructors

public ZendeskConnector ()

Public Methods

public void applyMacro (Long macroId)

Parameters
macroId Macro to be applied

public void applyMacroToTicket (Long macroId, Long ticketId)

Apply macro to an specific ticket

Check Zendesk API documentation

Parameters
macroId Macro to be applied
ticketId Ticket to apply the macro

public Ticket bulkImportTicket (Ticket ticket)

It allows moving data from legacy systems into Zendesk. Zendesk does not run triggers or the likes during bulk imports like these.

Check Zendesk API documentation

Parameters
ticket Ticket to be created
Returns
  • ticket created

public TopicComment checkForVote (Long topicId)

Check topic for vote

Check Zendesk API documentation

Parameters
topicId Topic id
Returns
  • topic vote information

public void connect (String username, String password)

Connect to Zendesk

Parameters
username Zendesk username
password Zendesk password
Throws
ConnectionException when the service is unreachable or the credentials are not valid

public String connectionId ()

Are we connected

public Automation createAutomation (Automation automation)

Parameters
automation Automation to be created
Returns
  • created automation info

public Category createCategory (Category category)

Parameters
category Category to be created
Returns
  • new user information

public Forum createForum (Forum forum)

Parameters
forum Forum to be created
Returns
  • created forum

public ForumSubscription createForumSubscription (ForumSubscription forumSubscription)

Create forum subscription

Check Zendesk API documentation

Parameters
forumSubscription Forum subscription to be created
Returns
  • new forum subscription

public Group createGroup (Group group)

Parameters
group Group to be created
Returns
  • Created group

public GroupMembership createGroupMembership (GroupMembership groupMembership)

Parameters
groupMembership Group membership to be created
Returns
  • created group membership

public Macro createMacro (Macro macro)

Parameters
macro Macro to be created
Returns
  • new macro info

public Organization createOrganization (Organization organization)

Create organization

Check Zendesk API documentation

Parameters
organization Organization to be created
Returns
  • new organization

public Request createRequest (Request request)

Parameters
request Request to be created
Returns
  • new request information

public SatisfactionRating createSatisfactionRating (SatisfactionRating satisfactionRating)

Create satisfaction rating

Check Zendesk API documentation

Parameters
satisfactionRating Satisfaction rating to be created
Returns
  • satisfaction ratings info

public Ticket createTicket (Ticket ticket)

Creates a new Zendesk ticket

Check Zendesk API documentation

Parameters
ticket Ticket to create
Returns
  • new Ticket

public TicketField createTicketField (TicketField ticketField)

Create a new ticket field

Check Zendesk API documentation

Parameters
ticketField Ticket Field object to create
Returns
  • tickets field

public Topic createTopic (Topic topic)

Parameters
topic Topic to be created
Returns
  • new topic

public TopicComment createTopicComment (TopicComment topicComment)

Create Topic comment

Check Zendesk API documentation

Parameters
topicComment Topic comment to be created
Returns
  • created topic comment

public TopicSubscription createTopicSubscription (TopicSubscription topicSubscription)

Create Topic subscription

Check Zendesk API documentation

Parameters
topicSubscription Topic subscription to be created
Returns
  • created topic subscription

public TopicVote createTopicVote (TopicVote topicVote)

Parameters
topicVote Topic vote to be created
Returns
  • created topic vote

public Trigger createTrigger (Trigger trigger)

Parameters
trigger Trigger to be created
Returns
  • new trigger

public User createUser (User user)

Parameters
user To be created
Returns
  • new user information

public UserIdentity createUserIdentity (UserIdentity userIdentity)

Create an user identity for a given user

Check Zendesk API documentation

Parameters
userIdentity User identity to be created
Returns
  • user identity information

public View createView (View view)

Parameters
view View to be created
Returns
  • new view

public void deleteAttachment (Long attachmentId)

Parameters
attachmentId Attachment id

public void deleteCategory (Category category)

Parameters
category Category to be deleted

public void deleteForum (Forum forum)

Parameters
forum Forum to be deleted

public void deleteForumSubscription (ForumSubscription forumSubscription)

Delete forum subscription

Check Zendesk API documentation

Parameters
forumSubscription Forum subscription to be deleted

public void deleteGroup (Group group)

Parameters
group Group to be deleted

public void deleteGroupMembership (GroupMembership groupMembership)

Parameters
groupMembership Group membership to be deleted

public void deleteMacro (Macro macro)

Parameters
macro Macro to be deleted

public void deleteOrganization (Organization organization)

Update organization

Check Zendesk API documentation

Parameters
organization Organization to be updated

public void deleteSuspendedTicket (Long suspendedTicketId)

Delete a suspended ticket

Check Zendesk API documentation

Parameters
suspendedTicketId Suspended ticket id

public Ticket deleteTicket (Ticket ticket)

Parameters
ticket Ticket to delete
Returns
  • deleted ticket

public void deleteTopic (Topic topic)

Parameters
topic Topic to be deleted

public void deleteTopicComment (TopicComment topicComment)

Delete topic comment

Check Zendesk API documentation

Parameters
topicComment Topic comment to be deleted

public void deleteTopicSubscription (TopicSubscription topicSubscription)

Delete topic subscription

Check Zendesk API documentation

Parameters
topicSubscription Topic subscription to be deleted

public void deleteTopicVote (TopicVote topicVote)

Parameters
topicVote Topic vote to be deleted

public void deleteUpload (String token)

Parameters
token Token for the attachment

public User deleteUser (User user)

Parameters
user To be deleted
Returns
  • deleted user information

public UserIdentity deleteUserIdentity (UserIdentity userIdentity)

Delete user identity

Check Zendesk API documentation

Parameters
userIdentity User identity to be deleted
Returns
  • user identity information

public void disconnect ()

Disconnect

public ViewExecute executeView (Long viewId)

Parameters
viewId View id to be executed
Returns
  • view execution response

public ActivityStream getActivity (Long activityId)

Parameters
activityId Activity id
Returns
  • activity information

public WebResource getApiResource ()

public String getApiUrl ()

public Attachment getAttachment (Long attachmentId)

Parameters
attachmentId Attachment id
Returns
  • attachment information

public Automation getAutomation (Long automationId)

Parameters
automationId Automation id
Returns
  • automation info

public Category getCategory (Long categoryId)

Parameters
categoryId Category id
Returns
  • category information

public Client getClient ()

public Locale getCurrentLocale ()

Returns
  • current locale information

public User getCurrentUser ()

Returns current user information

Returns
  • current user

public Forum getForum (Long forumId)

Parameters
forumId Forum id
Returns
  • list of forums

public ForumSubscription getForumSubscription (Long forumSubscriptionId)

Get forum subscription

Check Zendesk API documentation

Parameters
forumSubscriptionId Forum id
Returns
  • list of forum subscriptions

public Group getGroup (Long groupId)

Get group for given group id

Check Zendesk API documentation

Parameters
groupId Group id
Returns
  • group information

public GroupMembership getGroupMembership (Long groupMembershipId)

Get membership information

Check Zendesk API documentation

Parameters
groupMembershipId Group membership id
Returns
  • group memberships information

public GroupMembership getGroupMembershipByUser (Long groupMembershipId, Long userId)

Get membership information

Check Zendesk API documentation

Parameters
groupMembershipId Group membership
userId User
Returns
  • group memberships information

public JerseyUtil getJerseyUtil ()

public Locale getLocale (Integer localeId)

Parameters
localeId Locale id
Returns
  • locale information

public Macro getMacro (Long macroId)

Parameters
macroId Macro id
Returns
  • macros information

public Organization getOrganization (Long organizationId)

Get organization info

Check Zendesk API documentation

Parameters
organizationId Organization id
Returns
  • organization information

public OrganizationRelated getOrganizationRelated (Long organizationId)

Get organization related information

Check Zendesk API documentation

Parameters
organizationId Organization id
Returns
  • organization related information

public Request getRequest (Long requestId)

Get request information

Check Zendesk API documentation

Parameters
requestId Request id
Returns
  • list of requests

public TicketComment getRequestComment (Long requestId, Long commentId)

Get a particular comment for a given request

Check Zendesk API documentation

Parameters
requestId Request id
commentId CommentId
Returns
  • request comment information

public SatisfactionRating getSatisfactionRating (Long satisfactionRatingId)

Get satisfaction rating info

Check Zendesk API documentation

Parameters
satisfactionRatingId Satisfaction rating id
Returns
  • satisfaction ratings list

public SuspendedTicket getSuspendedTicket (Long suspendedTicketId)

Get suspended ticket

Check Zendesk API documentation

Parameters
suspendedTicketId Suspended ticket id
Returns
  • suspended ticket info

public Ticket getTicket (Long ticketId)

Parameters
ticketId Ticket id
Returns
  • ticket information

public TicketAudit getTicketAudit (Long ticketId, Long auditId)

Parameters
ticketId Ticket id
auditId Audit id
Returns
  • ticket audit information

public TicketMetric getTicketMetrics (Long ticketId)

Parameters
ticketId Ticket to get metrics
Returns
  • ticket metrics

public Collection<Ticket> getTicketsFromView (Long viewId)

Get tickets from view

Check Zendesk API documentation

Parameters
viewId View to get tickets from
Returns
  • list of tickets

public Topic getTopic (Long topicId)

Parameters
topicId Topic id
Returns
  • topic info

public TopicComment getTopicComment (Long topicId, Long topicCommentId)

Parameters
topicId Topic id
topicCommentId Topic comment id
Returns
  • topic comment information

public TopicSubscription getTopicSubscription (Long topicSubscriptionId)

Get topic subscription

Check Zendesk API documentation

Parameters
topicSubscriptionId Topic comment id
Returns
  • topic comment information

public Trigger getTrigger (Long triggerId)

Parameters
triggerId Trigger id
Returns
  • trigger information

public User getUser (Long userId)

Get user information

Check Zendesk API documentation

Parameters
userId To get retrieved
Returns
  • user information

public UserIdentity getUserIdentity (Long userId, Long userIdentityId)

Get an user identity

Check Zendesk API documentation

Parameters
userId User id
userIdentityId User identity id
Returns
  • user identity information

public UserRelated getUserRelated (Long userId)

Get user related information

Check Zendesk API documentation

Parameters
userId To get information
Returns
  • user related information

public View getView (Long viewId)

Get a view information

Check Zendesk API documentation

Parameters
viewId View information to be retrieved
Returns
  • view information

public ViewExecute getViewCounts (List<String> viewIds)

Calculates the size of the view in terms of number of tickets the view will return

Check Zendesk API documentation

Parameters
viewIds List of view ids
Returns
  • view count response

public Topic importTopic (Topic topic)

Creates a topic without sending out notifications. Allows setting created_at and updated_at.

Check Zendesk API documentation

Parameters
topic Topic to be created
Returns
  • new topic

public TopicComment importTopicComment (TopicComment topicComment)

Creates a comment without sending out notifications. Allows setting created_at and updated_at.

Check Zendesk API documentation

Parameters
topicComment Topic comment to be created
Returns
  • created topic comment

public boolean isConnected ()

Are we connected

public Collection<Automation> listActiveAutomations ()

List active automations

Check Zendesk API documentation

Returns
  • list of active automations

public Collection<Macro> listActiveMacros ()

Returns
  • active macros list

public Collection<Trigger> listActiveTriggers ()

List active triggers

Check Zendesk API documentation

Returns
  • list of active triggers

public Collection<View> listActiveViews ()

Returns
  • active views

public Collection<ActivityStream> listActivities ()

Returns
  • list of activities

public Collection<Group> listAssignableGroups ()

List assignable groups

Check Zendesk API documentation

Returns
  • assignable groups

public Collection<Automation> listAutomations ()

Returns
  • list of automations

public Collection<Category> listCategories ()

Returns
  • list of categories

public Collection<View> listCompactViews ()

Returns
  • A compacted list of shared and personal views available to the current user

public Collection<ForumSubscription> listForumSubscriptions ()

List forum subscriptions

Check Zendesk API documentation

Returns
  • list of forum subscriptions

public Collection<ForumSubscription> listForumSubscriptionsByForum (Long forumId)

List forum subscriptions by forum

Check Zendesk API documentation

Parameters
forumId Forum id
Returns
  • list of forum subscriptions

public Collection<Forum> listForums ()

Returns
  • list of forums

public Collection<Forum> listForumsByCategory (Long categoryId)

List forums by category

Check Zendesk API documentation

Parameters
categoryId Category id
Returns
  • list of forums

public Collection<GroupMembership> listGroupAssignableMemberships ()

List group memberships by group

Check Zendesk API documentation

Returns
  • group memberships list

public Collection<GroupMembership> listGroupAssignableMembershipsByGroup (Long groupId)

List assignable memberships by group

Check Zendesk API documentation

Parameters
groupId User id
Returns
  • group memberships list

public Collection<GroupMembership> listGroupMemberships ()

List group memberships

Check Zendesk API documentation

Returns
  • group memberships list

public Collection<GroupMembership> listGroupMembershipsByGroup (Long groupId)

List group memberships by group

Check Zendesk API documentation

Parameters
groupId User id
Returns
  • group memberships list

public Collection<GroupMembership> listGroupMembershipsByUser (Long userId)

List group memberships by user

Check Zendesk API documentation

Parameters
userId User id
Returns
  • group memberships list

public Collection<Group> listGroups ()

Returns
  • available groups

public Collection<Locale> listLocales ()

Returns
  • locale list

public Collection<Macro> listMacros ()

Returns
  • macros list

public Collection<Organization> listOrganizations ()

Returns
  • operation results

public Collection<SatisfactionRating> listReceivedSatisfactionRatings ()

List received satisfaction ratings

Check Zendesk API documentation

Returns
  • satisfaction ratings list

public Collection<TicketComment> listRequestComments (Long requestId)

List requests comments

Check Zendesk API documentation

Parameters
requestId Request id
Returns
  • list of comments for the given request

public Collection<Request> listRequests ()

Returns
  • list of requests

public Collection<Request> listRequestsByStatus (String status)

List requests by status. Available values are ccd, open, solved.

Check Zendesk API documentation

Parameters
status Request status. Available values are ccd, open, solved.
Returns
  • list of requests

public Collection<Request> listRequestsByUser (Long userId)

List requests by user

Check Zendesk API documentation

Parameters
userId User id
Returns
  • list of requests

public Collection<SatisfactionRating> listSatisfactionRatings ()

List satisfaction ratings

Check Zendesk API documentation

Returns
  • satisfaction ratings list

public Collection<SharingAgreement> listSharingAgreements ()

List sharing agreements

Check Zendesk API documentation

Returns
  • sharing agreements list

public Collection<SuspendedTicket> listSuspendedTickets ()

List suspended tickets

Check Zendesk API documentation

Returns
  • suspended tickets list

public Collection<TicketAudit> listTicketAudits (Long ticketId)

List Ticket audits for a given ticket

Check Zendesk API documentation

Parameters
ticketId Ticket id
Returns
  • tickets audits list

public Collection<TicketField> listTicketFields ()

List Ticket audits for a given ticket

Check Zendesk API documentation

Returns
  • tickets fields list

public Collection<TicketMetric> listTicketMetrics ()

List ticket metrics

Check Zendesk API documentation

Returns
  • ticket metrics list

public Collection<Ticket> listTickets ()

Get list of tickets

Check Zendesk API documentation

Returns
  • list of tickets

public Collection<TopicComment> listTopicComments (Long topicId)

List topic comments

Check Zendesk API documentation

Parameters
topicId Topic id
Returns
  • list of topic comments

public Collection<TopicComment> listTopicCommentsByUser (Long userId)

List topic comments by user

Check Zendesk API documentation

Parameters
userId User id
Returns
  • list of topic comments

public Collection<TopicSubscription> listTopicSubscriptions ()

List topic subscriptions

Check Zendesk API documentation

Returns
  • list of topic subscriptions

public Collection<TopicSubscription> listTopicSubscriptionsByTopic (Long topicId)

List topic subscriptions by topic

Check Zendesk API documentation

Parameters
topicId Topic id
Returns
  • list of topic subscriptions

public Collection<TopicVote> listTopicVotes (Long topicId)

Parameters
topicId Topic id
Returns
  • list of topic votes

public Collection<TopicVote> listTopicVotesByUser (Long userId)

List topic votes by user

Check Zendesk API documentation

Parameters
userId User id
Returns
  • list of topic votes

public Collection<Topic> listTopics ()

Returns
  • list of topics

public Collection<Topic> listTopicsByForum (Long forumId)

List topics by forum

Check Zendesk API documentation

Parameters
forumId Forum Id
Returns
  • list of topics

public Collection<Topic> listTopicsByUser (Long userId)

List topics by user

Check Zendesk API documentation

Parameters
userId User Id
Returns
  • list of topics

public Collection<Trigger> listTriggers ()

Returns
  • list of triggers

public Collection<UserIdentity> listUserIdentities (Long userId)

Return all user identities for a given user id

Check Zendesk API documentation

Parameters
userId User id
Returns
  • list of user identities

public Collection<User> listUsers ()

Returns
  • list of users

public Collection<User> listUsersByGroup (Long groupId)

Get users per group id

Check Zendesk API documentation

Parameters
groupId Group id
Returns
  • user information

public Collection<User> listUsersByOrganization (Long organizationId)

Get users per organization id

Check Zendesk API documentation

Parameters
organizationId Organization id
Returns
  • list of users

public Collection<View> listViews ()

Returns
  • available views

public UserIdentity makeUserIdentityPrimary (UserIdentity userIdentity)

Make user identity the primary

Check Zendesk API documentation

Parameters
userIdentity User identity to be set as primary
Returns
  • user identity information

public void recoverSuspendedTicket (Long suspendedTicketId)

Recover a suspended ticket

Check Zendesk API documentation

Parameters
suspendedTicketId Suspended ticket id

public UserIdentity requestUserIdentityVerification (UserIdentity userIdentity)

Request user id verification

Check Zendesk API documentation

Parameters
userIdentity User identity
Returns
  • user identity information

public Iterable search (EntityType type, String query, String sortBy, String sortOrder)

The search API is a unified search API that returns tickets, users, organizations, and forum topics. Define filters to narrow your search results according to result type, date attributes, and object attributes such as ticket requester or tag.

Important: This operation only returns one type of object at the time. If you query more than one type you'll get a ZendeskException

Check Zendesk API documentation

Parameters
type Entity type. It has to be the same as the entity queried
query String
sortBy Possible values are 'updated_at', 'created_at', 'priority', 'status', and 'ticket_type'
sortOrder One of 'relevance', 'asc', 'desc'. Defaults to 'relevance' when no 'order' criteria is requested.
Returns
  • updated trigger

public Collection<Organization> searchOrganization (String searchTerm)

Search organization

Check Zendesk API documentation

Parameters
searchTerm Search term
Returns
  • list of organizations

public void setApiResource (WebResource apiResource)

Parameters
apiResource

public void setApiUrl (String apiUrl)

Parameters
apiUrl

public void setClient (Client client)

Parameters
client

public Collection<GroupMembership> setGroupMembershipAsDefault (GroupMembership groupMembership)

Set a group membership as default

Check Zendesk API documentation

Parameters
groupMembership Group membership to be set as default
Returns
  • operation results

public void setJerseyUtil (JerseyUtil jerseyUtil)

Parameters
jerseyUtil

public JobStatus showJobStatus (Long jobStatusId)

Parameters
jobStatusId Job status id
Returns
  • job status info

public Automation updateAutomation (Automation automation)

Parameters
automation Automation to be updated
Returns
  • updated automation info

public Category updateCategory (Category category)

Parameters
category Category to be updated
Returns
  • updated category information

public Forum updateForum (Forum forum)

Parameters
forum Forum to be updated
Returns
  • updated forum

public Group updateGroup (Group group)

Parameters
group Group to be update
Returns
  • Updated group

public Macro updateMacro (Macro macro)

Parameters
macro Macro to be updated
Returns
  • updated macro info

public Organization updateOrganization (Organization organization)

Update organization

Check Zendesk API documentation

Parameters
organization Organization to be updated
Returns
  • updated organization

public Request updateRequest (Request request)

Parameters
request Request to be updated
Returns
  • updated request information

public Ticket updateTicket (Ticket ticket)

Parameters
ticket Ticket to update
Returns
  • updated ticket

public TicketField updateTicketField (TicketField ticketField)

Update ticket field

Check Zendesk API documentation

Parameters
ticketField Ticket Field to be updated
Returns
  • tickets field

public Topic updateTopic (Topic topic)

Parameters
topic Topic to be updated
Returns
  • update topic

public TopicComment updateTopicComment (TopicComment topicComment)

Update topic comment

Check Zendesk API documentation

Parameters
topicComment Topic comment to be updated
Returns
  • updated topic comment

public Trigger updateTrigger (Trigger trigger)

Parameters
trigger Trigger to be updated
Returns
  • updated trigger

public User updateUser (User user)

Parameters
user To be updated
Returns
  • updated user information

public View updateView (View view)

Parameters
view View to be updated
Returns
  • updated view

public FileUpload uploadAttachment (InputStream content, String mediaType, String filename, String token)

Upload File attachment

Check Zendesk API documentation

Parameters
content File to upload
mediaType File media type. E.g.: application/octet-stream
filename Filename
token Optional token
Returns
  • upload information

public UserIdentity verifyUserIdentity (UserIdentity userIdentity)

Verify user identity

Check Zendesk API documentation

Parameters
userIdentity User identity to be verified
Returns
  • user identity information