The Zendesk meshlet supports the following configuration directives listed below in additional to the general configurations supported by all ServiceBond meshlets For questions, contact Perspectium Support.
NOTE: Default values refer to the configuration's value if the configuration is not specified in the meshlet configuration file.
Directive | Default Value | Required | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
apiTokenAuth | false | No | Indicates whether you want to authenticate your Zendesk connection with an API token instead of basic authentication. perspectium: zendesk: apiTokenAuth: true | ||||||||
urlBase | Yes | The base portion of the Zendesk API URL. Since Zendesk includes the resources being interacted with as part of the URL (i.e. tickets.json, users.json, etc.), we separate the URL so we can easily add the different resources below. perspectium: zendesk: urlBase: https://subdomain.zendesk.com/api/v2/ | |||||||||
urlSuffix | Yes | The ending (suffix) for the Zendesk API URL. Usually this is .json for API URLs such as https://subdomain.zendesk.com/api/v2/tickets.json perspectium: zendesk: urlSuffix: .json | |||||||||
urlResources | Yes | The resources being interacted with through the API. Each resource should be listed out with a - and contain the following properties:
perspectium: zendesk: urlResources: - name: ticket url: tickets - name: attachment url: uploads parameters: ?filename=%s | |||||||||
defaultCreateDescription | New ticket from integration | No | Since Zendesk requires a description to be the first comment added, a default description to use if no description is specified when the meshlet receives a message from the other ITSM app like ServiceNow. This way the ticket is created successfully since it uses the default description. perspectium: zendesk: defaultCreateDescription: New ticket from integration | ||||||||
defaultAttachmentComment | Attachment added to ticket | No | Zendesk requires attachments be added as part of a comment to the ticket. By default, the attachment is added with a comment Attachment added to ticket but you can use your own comment for when attachments are added into Zendesk by setting this configuration. perspectium: zendesk: defaultAttachmentComment: Attachment added to ticket | ||||||||
defaultCorrelateResponse | No | For when you configure ServiceNow to send back a .correlate message to Zendesk, this message can appear as a comment on the Zendesk ticket so those looking at the ticket in Zendesk will know the ticket was created in ServiceNow. perspectium: zendesk: defaultCorrelateResponse: Ticket created successfully in ServiceNow | |||||||||
correlationFieldId | Yes | The Zendesk Field ID of the Correlation ID custom field in Zendesk that holds the unique identifier in the other ITSM app being integrated with Zendesk i.e. the sys_id in ServiceNow. This field should be created as detailed here. perspectium: zendesk: correlationFieldId: 7655609750043 | |||||||||
correlationDisplayFieldId | No | The Zendesk Field ID of the Correlation Display custom field in Zendesk that holds the customer-facing identifier in the other ITSM app being integrated with Zendesk i.e. the number in ServiceNow. This field should be created as detailed here. perspectium: zendesk: correlationFieldId: 7655609750043 | |||||||||
startTime | Yes | The start time when the meshlet first runs to query for ticket changes from. That is, it looks for any tickets that have been changed (updated or inserted) since this time on first start. After the first run using this start time, the meshlet will only query for changes since the last time it ran. This value should be entered in epoch time format in UTC/GMT time. See https://www.epochconverter.com/ if needed to translate into this format. If this value is blank, it will query for all ticket changes when the meshlet first runs. This will query for changes to tickets the first time the meshlet runs: perspectium: zendesk: startTime: This will query for all changes to tickets since 2022-08-09 1:38:42 AM (2022-08-08 6:38:42 PDT) the first time the meshlet runs: perspectium: zendesk: startTime: 1660009122 | |||||||||
userId | Yes | The Zendesk ID for the user entered in perspectium.auth.username. This field will be used to check for any updates in Zendesk made by this user ID so they can be skipped to avoid looping updates back and forth between Zendesk and other ITSM app being integrated. perspectium: zendesk: userId: 7603423341591 | |||||||||
historicalComments | true | No | For when a ticket in Zendesk triggers being integrated and whether or not we should get all the comments previously entered prior to the ticket triggering the integration. If true, all comments will be sent. If false, comments entered prior to the integration being triggered will not be sent. perspectium: zendesk: historicalComments: true | ||||||||
ticketPageSize | 1000 | No | The number of tickets to query at a time. This value is to control performance so as to not slow down the meshlet and/or your Zendesk environment so as to notquery for too many records at one time. If there are more tickets than the value specified here, it will grab it the next time when it queries for the next "page" (batch). 1000 is the maximum value allowed. perspectium: zendesk: ticketPageSize: 100 | ||||||||
defaultErrorMessage | Perspectium Error | No | The error message to display when creating a new ticket in Zendesk due to an error with Perspectium to trigger a notification. See notifications in Zendesk for more information. perspectium: zendesk: defaultErrorMessage: Perspectium Error | ||||||||
ticketSleepTimer | 60000 | No | The time for the meshlet to wait ("sleep") in between querying for new changes in Zendesk. This value is in milliseconds i.e. 60000 = 60 seconds. perspectium: zendesk: ticketSleepTimer: 60000 |