PAT HelpdeskAdvanced
PAT Helpdesk Advanced Pack.#
This Integration is part of theSupported versions
Supported Cortex XSOAR versions: 6.9.0 and later.
Improve the effectiveness of your service provision and resources, and the quality of your IT department. This integration was integrated and tested with version 11.2.3 of PATHelpdeskAdvanced.
#
Configure PAT HelpdeskAdvanced in CortexParameter | Required |
---|---|
PAT Helpdesk URL | True |
Username | True |
Password | True |
Trust any certificate (not secure) | False |
Use system proxy settings | False |
#
CommandsYou can execute these commands from the CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.
#
hda-create-ticketCreate a new ticket.
#
Base Commandhda-create-ticket
#
InputArgument Name | Description | Required |
---|---|---|
object_type_id | The object type ID for the ticket. | Required |
ticket_status_id | The status ID for the ticket. Use hda-list-ticket-statuses to get a list of status IDs. | Required |
ticket_priority_id | The priority ID for the ticket. Use hda-list-ticket-priorities to get a list of priority IDs. | Required |
object_description | The description of the object. | Optional |
ticket_classification_id | The classification ID for the ticket. | Optional |
ticket_type_id | The type ID for the ticket. | Optional |
contact_id | The contact ID for the ticket. | Optional |
subject | The subject for the ticket. | Optional |
problem | The problem description for the ticket. | Optional |
site | The site for the ticket. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
HelpdeskAdvanced.Ticket.AccountID | string | The account ID of the ticket. |
HelpdeskAdvanced.Ticket.AssetCategoryID | string | The asset category ID of the ticket. |
HelpdeskAdvanced.Ticket.AssetID | string | The asset ID of the ticket. |
HelpdeskAdvanced.Ticket.AssignedUserGroupID | string | The assigned user group ID of the ticket. |
HelpdeskAdvanced.Ticket.AssignedUserID | string | The assigned user ID of the ticket. |
HelpdeskAdvanced.Ticket.AssignedUserOrGroupID | string | The assigned user or group ID of the ticket. |
HelpdeskAdvanced.Ticket.BilledTokens | string | The billed tokens of the ticket. |
HelpdeskAdvanced.Ticket.BusinessFunctionID | string | The business function ID of the ticket. |
HelpdeskAdvanced.Ticket.C12 | string | The C12 field of the ticket. |
HelpdeskAdvanced.Ticket.C13 | string | The C13 field of the ticket. |
HelpdeskAdvanced.Ticket.C134C | string | The C134C field of the ticket. |
HelpdeskAdvanced.Ticket.C14 | string | The C14 field of the ticket. |
HelpdeskAdvanced.Ticket.C15 | string | The C15 field of the ticket. |
HelpdeskAdvanced.Ticket.CalendarID | string | The calendar ID of the ticket. |
HelpdeskAdvanced.Ticket.ClosedByUserID | string | The ID of the user who closed the ticket. |
HelpdeskAdvanced.Ticket.ClosureDate | string | The closure date of the ticket. |
HelpdeskAdvanced.Ticket.ContactID | string | The contact ID of the ticket. |
HelpdeskAdvanced.Ticket.CostCenterID | string | The cost center ID of the ticket. |
HelpdeskAdvanced.Ticket.CustomerContractID | string | The customer contract ID of the ticket. |
HelpdeskAdvanced.Ticket.Date | date | The date of the ticket. |
HelpdeskAdvanced.Ticket.DefaultSolutionID | string | The default solution ID of the ticket. |
HelpdeskAdvanced.Ticket.EstimatedTaskDuration | string | The estimated task duration of the ticket. |
HelpdeskAdvanced.Ticket.EstimatedTaskStartDate | string | The estimated task start date of the ticket. |
HelpdeskAdvanced.Ticket.ExpirationDate | date | The expiration date of the ticket. |
HelpdeskAdvanced.Ticket.FirstUpdateUserID | string | The ID of the user who first updated the ticket. |
HelpdeskAdvanced.Ticket.FullText | string | The full text of the ticket. |
HelpdeskAdvanced.Ticket.ID | string | The ID of the ticket. |
HelpdeskAdvanced.Ticket.ImpactID | string | The impact ID of the ticket. |
HelpdeskAdvanced.Ticket.IsNew | boolean | Whether the ticket is new or not. |
HelpdeskAdvanced.Ticket.KnownIssue | string | The known issue field of the ticket. |
HelpdeskAdvanced.Ticket.LanguageID | string | The language ID of the ticket. |
HelpdeskAdvanced.Ticket.LastExpirationDate | date | The last expiration date of the ticket. |
HelpdeskAdvanced.Ticket.LastExpirationID | string | The last expiration ID of the ticket. |
HelpdeskAdvanced.Ticket.LocationID | string | The location ID of the ticket. |
HelpdeskAdvanced.Ticket.MailBoxID | string | The mailbox ID of the ticket. |
HelpdeskAdvanced.Ticket.NextExpirationDate | string | The next expiration date of the ticket. |
HelpdeskAdvanced.Ticket.NextExpirationID | string | The next expiration ID of the ticket. |
HelpdeskAdvanced.Ticket.ObjectDescription | string | The object description of the ticket. |
HelpdeskAdvanced.Ticket.ObjectEntity | string | The object entity of the ticket. |
HelpdeskAdvanced.Ticket.ObjectTypeID | string | The object type ID of the ticket. |
HelpdeskAdvanced.Ticket.OwnerUserGroupID | string | The owner user group ID of the ticket. |
HelpdeskAdvanced.Ticket.OwnerUserID | string | The owner user ID of the ticket. |
HelpdeskAdvanced.Ticket.ParentRecurringTicketID | string | The parent recurring ticket ID of the ticket. |
HelpdeskAdvanced.Ticket.ParentTicketID | string | The parent ticket ID of the ticket. |
HelpdeskAdvanced.Ticket.Problem | string | The problem field of the ticket. |
HelpdeskAdvanced.Ticket.ProblemHTML | string | The problem field in HTML format of the ticket. |
HelpdeskAdvanced.Ticket.RemoteID | string | The remote ID of the ticket. |
HelpdeskAdvanced.Ticket.Score | string | The score of the ticket. |
HelpdeskAdvanced.Ticket.ServiceID | string | The service ID of the ticket. |
HelpdeskAdvanced.Ticket.Site | string | The site of the ticket. |
HelpdeskAdvanced.Ticket.SiteUnRead | string | Whether the ticket is unread for the site. |
HelpdeskAdvanced.Ticket.Solicits | string | Whether the ticket solicits feedback. |
HelpdeskAdvanced.Ticket.SolutionHTML | string | The solution in HTML format of the ticket. |
HelpdeskAdvanced.Ticket.SourceMailBoxID | string | The source mailbox ID of the ticket. |
HelpdeskAdvanced.Ticket.Subject | string | The subject of the ticket. |
HelpdeskAdvanced.Ticket.SupplierID | string | The supplier ID of the ticket. |
HelpdeskAdvanced.Ticket.Tag | string | The tag of the ticket. |
HelpdeskAdvanced.Ticket.TaskEffort | string | The task effort of the ticket. |
HelpdeskAdvanced.Ticket.TemplateTicketID | string | The template ticket ID of the ticket. |
HelpdeskAdvanced.Ticket.TicketClassificationID | string | The ticket classification ID of the ticket. |
HelpdeskAdvanced.Ticket.TicketCode | string | The ticket code of the ticket. |
HelpdeskAdvanced.Ticket.TicketPriorityID | string | The ticket priority ID of the ticket. |
HelpdeskAdvanced.Ticket.TicketSolutionID | string | The ticket solution ID of the ticket. |
HelpdeskAdvanced.Ticket.TicketSourceID | string | The ticket source ID of the ticket. |
HelpdeskAdvanced.Ticket.TicketStatusID | string | The ticket status ID of the ticket. |
HelpdeskAdvanced.Ticket.TicketTypeID | string | The ticket type ID of the ticket. |
HelpdeskAdvanced.Ticket.UnRead | string | Whether the ticket is unread. |
HelpdeskAdvanced.Ticket.UrgencyID | string | The urgency ID of the ticket. |
HelpdeskAdvanced.Ticket.UserID | string | The user ID of the ticket. |
#
Command example!hda-create-ticket object_type_id=T2 ticket_priority_id=P4 ticket_status_id=S3
#
Context Example#
Human Readable Output#
Ticket Created
Object Description Object Entity Ticket Classification ID Is New Expiration Date First Update User ID Owner User ID Date Assigned User ID 12345678C: Incident INC false 2023-10-04T15:45:00Z S00000C S00000C 2023-10-04T07:45:09Z S00000C
#
hda-list-ticketsList tickets.
#
Base Commandhda-list-tickets
#
InputArgument Name | Description | Required |
---|---|---|
ticket_id | The ID of the ticket to retrieve. | Optional |
filter | Filters to apply to the ticket list. | Optional |
page | The page number to retrieve. | Optional |
page_size | The number of tickets per page. | Optional |
limit | The maximum number of tickets to return. Default is 50. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
HelpdeskAdvanced.Ticket.AccountID | string | The account ID of the ticket. |
HelpdeskAdvanced.Ticket.AssetID | string | The asset ID of the ticket. |
HelpdeskAdvanced.Ticket.BilledTokens | string | The billed tokens of the ticket. |
HelpdeskAdvanced.Ticket.CalendarID | string | The calendar ID of the ticket. |
HelpdeskAdvanced.Ticket.ClosureDate | string | The closure date of the ticket. |
HelpdeskAdvanced.Ticket.ContactID | string | The contact ID of the ticket. |
HelpdeskAdvanced.Ticket.CustomerContractID | string | The customer contract ID of the ticket. |
HelpdeskAdvanced.Ticket.Date | string | The date of the ticket. |
HelpdeskAdvanced.Ticket.EstimatedTaskDuration | string | The estimated task duration of the ticket. |
HelpdeskAdvanced.Ticket.EstimatedTaskStartDate | string | The estimated task start date of the ticket. |
HelpdeskAdvanced.Ticket.ExpirationDate | string | The expiration date of the ticket. |
HelpdeskAdvanced.Ticket.FirstUpdateUserID | string | The ID of the user who first updated the ticket. |
HelpdeskAdvanced.Ticket.ID | string | The ID of the ticket. |
HelpdeskAdvanced.Ticket.KnownIssue | string | The known issue field of the ticket. |
HelpdeskAdvanced.Ticket.LanguageID | string | The language ID of the ticket. |
HelpdeskAdvanced.Ticket.LastExpirationDate | string | The last expiration date of the ticket. |
HelpdeskAdvanced.Ticket.LocationID | string | The location ID of the ticket. |
HelpdeskAdvanced.Ticket.MailBoxID | string | The mailbox ID of the ticket. |
HelpdeskAdvanced.Ticket.NextExpirationDate | string | The next expiration date of the ticket. |
HelpdeskAdvanced.Ticket.NextExpirationID | string | The next expiration ID of the ticket. |
HelpdeskAdvanced.Ticket.OwnerUserID | string | The owner user ID of the ticket. |
HelpdeskAdvanced.Ticket.Problem | string | The problem field of the ticket. |
HelpdeskAdvanced.Ticket.ProblemHTML | string | The problem field in HTML format of the ticket. |
HelpdeskAdvanced.Ticket.Score | string | The score of the ticket. |
HelpdeskAdvanced.Ticket.ServiceID | string | The service ID of the ticket. |
HelpdeskAdvanced.Ticket.SiteUnRead | string | Whether the ticket is unread for the site. |
HelpdeskAdvanced.Ticket.Solicits | string | Whether the ticket solicits feedback. |
HelpdeskAdvanced.Ticket.Solution | string | The solution of the ticket. |
HelpdeskAdvanced.Ticket.SolutionHTML | string | The solution in HTML format of the ticket. |
HelpdeskAdvanced.Ticket.Subject | string | The subject of the ticket. |
HelpdeskAdvanced.Ticket.SupplierID | string | The supplier ID of the ticket. |
HelpdeskAdvanced.Ticket.TaskEffort | string | The task effort of the ticket. |
HelpdeskAdvanced.Ticket.TicketClassificationID | string | The ticket classification ID of the ticket. |
HelpdeskAdvanced.Ticket.TicketTypeID | string | The ticket type ID of the ticket. |
HelpdeskAdvanced.Ticket.UrgencyID | string | The urgency ID of the ticket. |
#
Command example!hda-list-tickets
#
Context Example#
Human Readable Output#
Tickets
Ticket ID Subject Solution Date Service ID Problem Contact ID Owner User ID Account ID 10000000C Problem 2019-04-25T07:03:48Z S000X Problem S24007C S00000C C00C
#
hda-add-ticket-attachmentAdd an attachment to a ticket.
#
Base Commandhda-add-ticket-attachment
#
InputArgument Name | Description | Required |
---|---|---|
ticket_id | The ticket ID to retrieve details for. | Required |
entry_id | The file entry ID to attach. | Required |
#
Context OutputThere is no context output for this command.
#
hda-list-ticket-attachmentsList attachments for a ticket.
#
Base Commandhda-list-ticket-attachments
#
InputArgument Name | Description | Required |
---|---|---|
ticket_id | The ticket ID to retrieve details for. | Required |
limit | The maximum number of tickets to return. Default is 50. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
HelpdeskAdvanced.Ticket.Attachment.BlobID | string | The blob ID of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.ContentType | string | The content type of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.Description | string | The description of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.EmailID | string | The email ID of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.FileName | string | The file name of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.FirstUpdate | string | The date and time when the attachment was first updated. |
HelpdeskAdvanced.Ticket.Attachment.FirstUpdateUserID | string | The ID of the user who first uploaded the attachment. |
HelpdeskAdvanced.Ticket.Attachment.ID | string | The ID of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.IsNew | string | Indicates whether the attachment is new. |
HelpdeskAdvanced.Ticket.Attachment.KBSize | string | The size of the attachment in KB. |
HelpdeskAdvanced.Ticket.Attachment.LastUpdate | string | The date and time when the attachment was last updated. |
HelpdeskAdvanced.Ticket.Attachment.LastUpdateUserID | string | The ID of the user who last updated the attachment. |
HelpdeskAdvanced.Ticket.Attachment.Note | string | Any additional notes about the attachment. |
HelpdeskAdvanced.Ticket.Attachment.ObjectDescription | string | The description of the object the attachment is associated with. |
HelpdeskAdvanced.Ticket.Attachment.ObjectEntity | string | The object entity of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.ObjectTypeID | string | The object type ID of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.OwnerUserID | string | The owner user ID of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.ParentObject | string | The parent object the attachment is associated with. |
HelpdeskAdvanced.Ticket.Attachment.ParentObjectID | string | The ID of the parent object the attachment is associated with. |
HelpdeskAdvanced.Ticket.Attachment.RemoteID | string | The remote ID of the attachment. |
HelpdeskAdvanced.Ticket.Attachment.Site | string | The site ID the attachment is associated with. |
HelpdeskAdvanced.Ticket.Attachment.TicketID | string | The ticket ID the attachment is associated with. |
HelpdeskAdvanced.Ticket.Attachment.UniqueID | string | A unique ID for the attachment. |
#
Command example!hda-list-ticket-attachments ticket_id=A0000001C
#
Context Example#
Human Readable Output#
Attachments of A0000001C
File Name Last Update Description Object Description First Update User ID Object Entity Content Type test.txt 2023-09-29T08:30:04Z test.txt test.txt S00000C Attachment text/plain
#
hda-add-ticket-commentAdd a comment to a ticket.
#
Base Commandhda-add-ticket-comment
#
InputArgument Name | Description | Required |
---|---|---|
ticket_id | The ticket ID to retrieve details for. | Required |
comment | The comment text. | Required |
site_visible | Whether the ticket is visible to the customer site. Possible values are: True, False. Default is False. | Required |
#
Context OutputThere is no context output for this command.
#
Command example!hda-add-ticket-comment comment="here be comment" site_visible=True ticket_id=A0000001C
#
Human Readable OutputComment was succesfully added to A0000001C
#
hda-list-ticket-statusesList ticket statuses.
#
Base Commandhda-list-ticket-statuses
#
InputArgument Name | Description | Required |
---|---|---|
limit | The maximum number of statuses to return. Default is 50. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
HelpdeskAdvanced.TicketStatus.ID | Number | The status ID. |
HelpdeskAdvanced.TicketStatus.Name | String | The status name. |
#
Command example!hda-list-ticket-statuses
#
Context Example#
Human Readable Output#
Results
Description ID New S1 Other S10
#
hda-change-ticket-statusChange the status of a ticket.
#
Base Commandhda-change-ticket-status
#
InputArgument Name | Description | Required |
---|---|---|
ticket_id | The ID of the ticket to change status for. | Required |
status_id | The ID of the status to change the ticket to. | Required |
note | An optional note to add with the status change. | Optional |
#
Context OutputThere is no context output for this command.
#
Command example!hda-change-ticket-status status_id=S2 ticket_id=1111111111C note=testing debug-mode=true
#
Human Readable OutputChanged status of ticket 1111111111C to S2 successfully.
#
hda-list-ticket-prioritiesList ticket priorities.
#
Base Commandhda-list-ticket-priorities
#
InputArgument Name | Description | Required |
---|---|---|
ticket_id | The ID of the ticket to change status for. | Required |
#
Context OutputPath | Type | Description |
---|---|---|
HelpdeskAdvanced.TicketPriority.ID | Number | The priority ID. |
HelpdeskAdvanced.TicketPriority.Name | String | The priority name. |
#
hda-get-ticket-historyGet ticket history.
#
Base Commandhda-get-ticket-history
#
InputArgument Name | Description | Required |
---|---|---|
ticket_id | The ID of the ticket to change status for. | Required |
#
Context OutputPath | Type | Description |
---|---|---|
HelpdeskAdvanced.TicketHistory.TicketID | string | The ticket ID associated with the history entry. |
HelpdeskAdvanced.TicketHistory.AccountID | string | The account ID of the ticket. |
HelpdeskAdvanced.TicketHistory.Attachments | string | List of attachments for the ticket. |
HelpdeskAdvanced.TicketHistory.AutEmailCounter | string | The AUT email counter. |
HelpdeskAdvanced.TicketHistory.ContactID | string | The contact ID of the ticket. |
HelpdeskAdvanced.TicketHistory.Data.Comment | string | The comment text. |
HelpdeskAdvanced.TicketHistory.Data.Date | string | The date of the history entry. |
HelpdeskAdvanced.TicketHistory.Data.From | string | The user who made the change. |
HelpdeskAdvanced.TicketHistory.Data.FromID | string | The ID of the user who made the change. |
HelpdeskAdvanced.TicketHistory.Data.Problem | string | The problem associated with the history entry. |
HelpdeskAdvanced.TicketHistory.Data.To | string | The user/team the ticket was assigned to. |
HelpdeskAdvanced.TicketHistory.Data.ToID | string | The ID of the user/team the ticket was assigned to. |
HelpdeskAdvanced.TicketHistory.ExternalAction | string | The external action associated with the history entry. |
HelpdeskAdvanced.TicketHistory.FullName | string | The full name of the ticket. |
HelpdeskAdvanced.TicketHistory.HistoryID | string | The ID of the history entry. |
HelpdeskAdvanced.TicketHistory.OperationDescription | string | The description of the operation. |
HelpdeskAdvanced.TicketHistory.OperationTypeID | string | The type ID of the operation. |
HelpdeskAdvanced.TicketHistory.UpdateDate | date | The date the ticket was last updated. |
HelpdeskAdvanced.TicketHistory.UserID | string | The user ID of the ticket. |
HelpdeskAdvanced.TicketHistory.Username | string | The username associated with the ticket. |
#
Command example!hda-get-ticket-history ticket_id=1111111C
#
Context Example#
Human Readable Output#
Ticket History: 1111111C
Update Date Ticket ID Operation Type ID Operation Description 2023-10-04T07:45:35Z 1111111C Status change
#
hda-list-usersList users.
#
Base Commandhda-list-users
#
InputArgument Name | Description | Required |
---|---|---|
user_id | The ID of the user to retrieve details for. | Optional |
page | The page number. | Optional |
page_size | The number of users to return per page. | Optional |
limit | The maximum number of users to return per page. Default is 50. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
HelpdeskAdvanced.User.ID | string | The user ID. |
HelpdeskAdvanced.User.Email | string | The user's email address. |
HelpdeskAdvanced.User.FirstName | string | The user's first name. |
HelpdeskAdvanced.User.LastName | string | The user's last name. |
HelpdeskAdvanced.User.Phone | string | The user's phone number. |
#
Command example!hda-list-users
#
Context Example#
Human Readable Output#
PAT HelpDeskAdvanced Users
Phone ID First Name Last Name E Mail #GUEST# Guest Guest@example.com
#
hda-list-groupsList groups.
#
Base Commandhda-list-groups
#
InputArgument Name | Description | Required |
---|---|---|
group_id | The ID of the group to retrieve details for. | Optional |
page | The page number. | Optional |
page_size | The number of groups to return per page. | Optional |
limit | The maximum number of groups to return per page. Default is 50. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
HelpdeskAdvanced.Group.ID | string | The group ID. |
HelpdeskAdvanced.Group.ObjectTypeID | string | The object type ID of the group. |
HelpdeskAdvanced.Group.Description | string | The group description. |
#
Command example!hda-list-groups
#
Context Example#
Human Readable Output#
PAT HelpDeskAdvanced Groups
Group ID Description Object Type ID G000C Example 65