node-zendesk • Docs
node-zendesk / clients/core/ticketimport / TicketImport
Class: TicketImport
TicketImport: A class that provides methods to interact with Zendesk's Ticket Import API. This is a thin wrapper around the Zendesk REST API for ticket imports.
See
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_import/
Extends
Constructors
new TicketImport()
new TicketImport(
options
):TicketImport
Parameters
• options: any
Returns
Overrides
Defined in
clients/core/ticketimport.d.ts:7
Properties
_transporter
_transporter:
Transporter
Inherited from
Defined in
clients/client.d.ts:42
eventTarget
eventTarget:
CustomEventTarget
Event target to handle custom events.
Inherited from
Defined in
clients/client.d.ts:40
jsonAPINames
jsonAPINames:
string
[]
Array to hold names used in the JSON API.
Overrides
Defined in
clients/core/ticketimport.d.ts:8
options
options:
ZendeskClientOptions
&object
Configuration options for the client.
Type declaration
get()
get: (
key
) =>any
Parameters
• key: string
Returns
any
Inherited from
Defined in
clients/client.d.ts:34
sideLoad
sideLoad:
any
[]
Array to handle side-loaded resources.
Inherited from
Defined in
clients/client.d.ts:37
useDotJson
useDotJson:
boolean
Flag to indicate if the API endpoint should use '.json' ending.
Inherited from
Defined in
clients/client.d.ts:39
Accessors
transporter
Get Signature
get transporter():
Transporter
Returns
Transporter for making requests.
Inherited from
Defined in
clients/client.d.ts:41
Methods
_rawRequest()
_rawRequest(
method
,uri
, ...arguments_
):Promise
<object
>
Parameters
• method: any
• uri: any
• ...arguments_: any
[]
Returns
Promise
<object
>
response
response:
any
result
result:
object
Inherited from
Defined in
clients/client.d.ts:78
bulkImport()
bulkImport(
tickets
):Promise
<object
>
Bulk imports multiple tickets into Zendesk.
Parameters
• tickets: object
[]
An array containing ticket data to be imported. Each ticket should include the following fields:
Returns
Promise
<object
>
The response from the Zendesk API, including a job status object.
response
response:
object
result
result:
object
Throws
Throws an error if the request to the Zendesk API fails.
See
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_import/#ticket-bulk-import
Example
const ticketDataArray = [{
assignee_id: 19,
comments: [{ author_id: 19, value: "This is a comment" }],
description: "A description",
requester_id: 827,
subject: "Help",
tags: ["foo", "bar"]
},
{
assignee_id: 20,
comments: [{ author_id: 20, value: "Another comment" }],
description: "Another description",
requester_id: 828,
subject: "Help Again",
tags: ["foo2", "bar2"]
}];
const response = await client.ticketimport.bulkImport(ticketDataArray);
Defined in
clients/core/ticketimport.d.ts:87
delete()
delete(...
arguments_
):Promise
<void
|object
>
Deletes a resource.
Parameters
• ...arguments_: any
[]
The resources or parts of the resource path.
Returns
Promise
<void
| object
>
- Either void or response object
Inherited from
Defined in
clients/client.d.ts:76
emit()
emit(
eventType
,eventData
):void
Parameters
• eventType: any
• eventData: any
Returns
void
Inherited from
Defined in
clients/client.d.ts:43
exportAudit()
exportAudit(
ticketID
):Promise
<any
[]>
Parameters
• ticketID: number
The ID of the ticket to fetch the audits for.
Returns
Promise
<any
[]>
An array of ticket audits from the Zendesk API.
Throws
Throws an error if the request to the Zendesk API fails.
See
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_import/
Example
const ticketID = 12345;
const audits = await client.ticketimport.exportAudit(ticketID);
Deprecated
Use the list
method from the TicketAudits
class instead. Exports the audits of a specific ticket.
Defined in
clients/core/ticketimport.d.ts:54
get()
get(
resource
):Promise
<NodeModule
>
Parameters
• resource: any
Returns
Promise
<NodeModule
>
Inherited from
Defined in
clients/client.d.ts:62
getAll()
getAll(
resource
):Promise
<any
[]>
Parameters
• resource: any
Returns
Promise
<any
[]>
Inherited from
Defined in
clients/client.d.ts:77
import()
import(
ticket
):Promise
<object
>
Imports a ticket into Zendesk.
Parameters
• ticket
The ticket data to be imported.
• ticket.assignee_id: number
The ID of the user to assign this ticket to.
• ticket.comments: any
[]
Array of comments associated with the ticket.
• ticket.description: string
The description of the ticket.
• ticket.requester_id: number
The ID of the user requesting the ticket.
• ticket.subject: string
The subject of the ticket.
• ticket.tags: any
[]
Array of tags associated with the ticket.
Returns
Promise
<object
>
The response from the Zendesk API.
response
response:
object
result
result:
object
Throws
Throws an error if the request to the Zendesk API fails.
See
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_import/#ticket-import
Example
const ticketData = {
assignee_id: 19,
comments: [{ author_id: 19, value: "This is a comment" }],
description: "A description",
requester_id: 827,
subject: "Help",
tags: ["foo", "bar"]
};
const response = await client.ticketimport.import(ticketData);
Defined in
clients/core/ticketimport.d.ts:32
on()
on(
eventType
,callback
):void
Parameters
• eventType: any
• callback: any
Returns
void
Inherited from
Defined in
clients/client.d.ts:44
patch()
patch(...
arguments_
):Promise
<void
|object
>
Patches a resource.
Parameters
• ...arguments_: any
[]
The resources or parts of the resource path followed by the body.
Returns
Promise
<void
| object
>
- Either void or response object
Inherited from
Defined in
clients/client.d.ts:68
post()
post(
resource
,body
):Promise
<NodeModule
>
Parameters
• resource: any
• body: any
Returns
Promise
<NodeModule
>
Inherited from
Defined in
clients/client.d.ts:70
put()
put(
resource
,body
):Promise
<NodeModule
>
Parameters
• resource: any
• body: any
Returns
Promise
<NodeModule
>
Inherited from
Defined in
clients/client.d.ts:69
request()
request<
T
>(method
,uri
, ...arguments_
):Promise
<NodeModule
>
Request method that handles various HTTP methods.
Type Parameters
• T
Parameters
• method: string
HTTP method (e.g., 'GET', 'POST').
• uri: string
The URI for the request.
• ...arguments_: any
[]
Additional arguments for the request.
Returns
Promise
<NodeModule
>
- The API response.
Inherited from
Defined in
clients/client.d.ts:96
requestAll()
requestAll(
method
,uri
, ...arguments_
):Promise
<any
[]>
Parameters
• method: any
• uri: any
• ...arguments_: any
[]
Returns
Promise
<any
[]>
Inherited from
Defined in
clients/client.d.ts:97
requestUpload()
requestUpload(
uri
,file
):Promise
<any
>
Parameters
• uri: any
• file: any
Returns
Promise
<any
>
Inherited from
Defined in
clients/client.d.ts:98
setSideLoad()
setSideLoad(
array
):void
Parameters
• array: any
Returns
void
Inherited from
Defined in
clients/client.d.ts:61