mirror of
https://github.com/n8n-io/n8n.git
synced 2024-12-26 21:19:43 -08:00
512 lines
16 KiB
TypeScript
512 lines
16 KiB
TypeScript
import {
|
|
IExecuteFunctions,
|
|
} from 'n8n-core';
|
|
|
|
import {
|
|
IDataObject,
|
|
ILoadOptionsFunctions,
|
|
INodeExecutionData,
|
|
INodePropertyOptions,
|
|
INodeType,
|
|
INodeTypeDescription,
|
|
} from 'n8n-workflow';
|
|
|
|
import {
|
|
validateJSON,
|
|
zendeskApiRequest,
|
|
zendeskApiRequestAllItems,
|
|
} from './GenericFunctions';
|
|
|
|
import {
|
|
ticketFields,
|
|
ticketOperations
|
|
} from './TicketDescription';
|
|
|
|
import {
|
|
ticketFieldFields,
|
|
ticketFieldOperations
|
|
} from './TicketFieldDescription';
|
|
|
|
import {
|
|
userFields,
|
|
userOperations
|
|
} from './UserDescription';
|
|
|
|
import {
|
|
IComment,
|
|
ITicket,
|
|
} from './TicketInterface';
|
|
|
|
export class Zendesk implements INodeType {
|
|
description: INodeTypeDescription = {
|
|
displayName: 'Zendesk',
|
|
name: 'zendesk',
|
|
icon: 'file:zendesk.png',
|
|
group: ['output'],
|
|
version: 1,
|
|
subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
|
|
description: 'Consume Zendesk API',
|
|
defaults: {
|
|
name: 'Zendesk',
|
|
color: '#13353c',
|
|
},
|
|
inputs: ['main'],
|
|
outputs: ['main'],
|
|
credentials: [
|
|
{
|
|
name: 'zendeskApi',
|
|
required: true,
|
|
displayOptions: {
|
|
show: {
|
|
authentication: [
|
|
'apiToken',
|
|
],
|
|
},
|
|
},
|
|
},
|
|
{
|
|
name: 'zendeskOAuth2Api',
|
|
required: true,
|
|
displayOptions: {
|
|
show: {
|
|
authentication: [
|
|
'oAuth2',
|
|
],
|
|
},
|
|
},
|
|
},
|
|
],
|
|
properties: [
|
|
{
|
|
displayName: 'Authentication',
|
|
name: 'authentication',
|
|
type: 'options',
|
|
options: [
|
|
{
|
|
name: 'API Token',
|
|
value: 'apiToken',
|
|
},
|
|
{
|
|
name: 'OAuth2',
|
|
value: 'oAuth2',
|
|
},
|
|
],
|
|
default: 'apiToken',
|
|
description: 'The resource to operate on.',
|
|
},
|
|
{
|
|
displayName: 'Resource',
|
|
name: 'resource',
|
|
type: 'options',
|
|
options: [
|
|
{
|
|
name: 'Ticket',
|
|
value: 'ticket',
|
|
description: 'Tickets are the means through which your end users (customers) communicate with agents in Zendesk Support.',
|
|
},
|
|
{
|
|
name: 'Ticket Field',
|
|
value: 'ticketField',
|
|
description: 'Manage system and custom ticket fields',
|
|
},
|
|
{
|
|
name: 'User',
|
|
value: 'user',
|
|
description: 'Manage users',
|
|
},
|
|
],
|
|
default: 'ticket',
|
|
description: 'Resource to consume.',
|
|
},
|
|
// TICKET
|
|
...ticketOperations,
|
|
...ticketFields,
|
|
// TICKET FIELD
|
|
...ticketFieldOperations,
|
|
...ticketFieldFields,
|
|
// USER
|
|
...userOperations,
|
|
...userFields,
|
|
],
|
|
};
|
|
|
|
methods = {
|
|
loadOptions: {
|
|
// Get all the custom fields to display them to user so that he can
|
|
// select them easily
|
|
async getCustomFields(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
|
|
const returnData: INodePropertyOptions[] = [];
|
|
const customFields = [
|
|
'text',
|
|
'textarea',
|
|
'date',
|
|
'integer',
|
|
'decimal',
|
|
'regexp',
|
|
'multiselect',
|
|
'tagger',
|
|
];
|
|
const fields = await zendeskApiRequestAllItems.call(this, 'ticket_fields', 'GET', '/ticket_fields');
|
|
for (const field of fields) {
|
|
if (customFields.includes(field.type)) {
|
|
const fieldName = field.title;
|
|
const fieldId = field.id;
|
|
returnData.push({
|
|
name: fieldName,
|
|
value: fieldId,
|
|
});
|
|
}
|
|
}
|
|
return returnData;
|
|
},
|
|
// Get all the groups to display them to user so that he can
|
|
// select them easily
|
|
async getGroups(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
|
|
const returnData: INodePropertyOptions[] = [];
|
|
const groups = await zendeskApiRequestAllItems.call(this, 'groups', 'GET', '/groups');
|
|
for (const group of groups) {
|
|
const groupName = group.name;
|
|
const groupId = group.id;
|
|
returnData.push({
|
|
name: groupName,
|
|
value: groupId,
|
|
});
|
|
}
|
|
return returnData;
|
|
},
|
|
// Get all the tags to display them to user so that he can
|
|
// select them easily
|
|
async getTags(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
|
|
const returnData: INodePropertyOptions[] = [];
|
|
const tags = await zendeskApiRequestAllItems.call(this, 'tags', 'GET', '/tags');
|
|
for (const tag of tags) {
|
|
const tagName = tag.name;
|
|
const tagId = tag.name;
|
|
returnData.push({
|
|
name: tagName,
|
|
value: tagId,
|
|
});
|
|
}
|
|
return returnData;
|
|
},
|
|
|
|
// Get all the locales to display them to user so that he can
|
|
// select them easily
|
|
async getLocales(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
|
|
const returnData: INodePropertyOptions[] = [];
|
|
const locales = await zendeskApiRequestAllItems.call(this, 'locales', 'GET', '/locales');
|
|
for (const locale of locales) {
|
|
const localeName = `${locale.locale} - ${locale.name}`;
|
|
const localeId = locale.locale;
|
|
returnData.push({
|
|
name: localeName,
|
|
value: localeId,
|
|
});
|
|
}
|
|
return returnData;
|
|
},
|
|
|
|
// Get all the user fields to display them to user so that he can
|
|
// select them easily
|
|
async getUserFields(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
|
|
const returnData: INodePropertyOptions[] = [];
|
|
const fields = await zendeskApiRequestAllItems.call(this, 'user_fields', 'GET', '/user_fields');
|
|
for (const field of fields) {
|
|
const fieldName = field.title;
|
|
const fieldId = field.key;
|
|
returnData.push({
|
|
name: fieldName,
|
|
value: fieldId,
|
|
});
|
|
}
|
|
return returnData;
|
|
},
|
|
}
|
|
};
|
|
|
|
async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
|
|
const items = this.getInputData();
|
|
const returnData: IDataObject[] = [];
|
|
const length = items.length as unknown as number;
|
|
const qs: IDataObject = {};
|
|
let responseData;
|
|
for (let i = 0; i < length; i++) {
|
|
const resource = this.getNodeParameter('resource', 0) as string;
|
|
const operation = this.getNodeParameter('operation', 0) as string;
|
|
//https://developer.zendesk.com/rest_api/docs/support/introduction
|
|
if (resource === 'ticket') {
|
|
//https://developer.zendesk.com/rest_api/docs/support/tickets
|
|
if (operation === 'create') {
|
|
const description = this.getNodeParameter('description', i) as string;
|
|
const jsonParameters = this.getNodeParameter('jsonParameters', i) as boolean;
|
|
const comment: IComment = {
|
|
body: description,
|
|
};
|
|
const body: ITicket = {
|
|
comment,
|
|
};
|
|
if (jsonParameters) {
|
|
const additionalFieldsJson = this.getNodeParameter('additionalFieldsJson', i) as string;
|
|
|
|
if (additionalFieldsJson !== '' ) {
|
|
|
|
if (validateJSON(additionalFieldsJson) !== undefined) {
|
|
|
|
Object.assign(body, JSON.parse(additionalFieldsJson));
|
|
|
|
} else {
|
|
throw new Error('Additional fields must be a valid JSON');
|
|
}
|
|
}
|
|
|
|
} else {
|
|
|
|
const additionalFields = this.getNodeParameter('additionalFields', i) as IDataObject;
|
|
|
|
if (additionalFields.type) {
|
|
body.type = additionalFields.type as string;
|
|
}
|
|
if (additionalFields.externalId) {
|
|
body.external_id = additionalFields.externalId as string;
|
|
}
|
|
if (additionalFields.subject) {
|
|
body.subject = additionalFields.subject as string;
|
|
}
|
|
if (additionalFields.status) {
|
|
body.status = additionalFields.status as string;
|
|
}
|
|
if (additionalFields.recipient) {
|
|
body.recipient = additionalFields.recipient as string;
|
|
}
|
|
if (additionalFields.group) {
|
|
body.group = additionalFields.group as string;
|
|
}
|
|
if (additionalFields.tags) {
|
|
body.tags = additionalFields.tags as string[];
|
|
}
|
|
if (additionalFields.customFieldsUi) {
|
|
body.custom_fields = (additionalFields.customFieldsUi as IDataObject).customFieldsValues as IDataObject[];
|
|
}
|
|
}
|
|
responseData = await zendeskApiRequest.call(this, 'POST', '/tickets', { ticket: body });
|
|
responseData = responseData.ticket;
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/tickets#update-ticket
|
|
if (operation === 'update') {
|
|
const ticketId = this.getNodeParameter('id', i) as string;
|
|
const jsonParameters = this.getNodeParameter('jsonParameters', i) as boolean;
|
|
const body: ITicket = {};
|
|
|
|
if (jsonParameters) {
|
|
const updateFieldsJson = this.getNodeParameter('updateFieldsJson', i) as string;
|
|
|
|
if (updateFieldsJson !== '' ) {
|
|
|
|
if (validateJSON(updateFieldsJson) !== undefined) {
|
|
|
|
Object.assign(body, JSON.parse(updateFieldsJson));
|
|
|
|
} else {
|
|
throw new Error('Additional fields must be a valid JSON');
|
|
}
|
|
}
|
|
|
|
} else {
|
|
|
|
const updateFields = this.getNodeParameter('updateFields', i) as IDataObject;
|
|
|
|
if (updateFields.type) {
|
|
body.type = updateFields.type as string;
|
|
}
|
|
if (updateFields.externalId) {
|
|
body.external_id = updateFields.externalId as string;
|
|
}
|
|
if (updateFields.subject) {
|
|
body.subject = updateFields.subject as string;
|
|
}
|
|
if (updateFields.status) {
|
|
body.status = updateFields.status as string;
|
|
}
|
|
if (updateFields.recipient) {
|
|
body.recipient = updateFields.recipient as string;
|
|
}
|
|
if (updateFields.group) {
|
|
body.group = updateFields.group as string;
|
|
}
|
|
if (updateFields.tags) {
|
|
body.tags = updateFields.tags as string[];
|
|
}
|
|
if (updateFields.customFieldsUi) {
|
|
body.custom_fields = (updateFields.customFieldsUi as IDataObject).customFieldsValues as IDataObject[];
|
|
}
|
|
}
|
|
responseData = await zendeskApiRequest.call(this, 'PUT', `/tickets/${ticketId}`, { ticket: body });
|
|
responseData = responseData.ticket;
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/tickets#show-ticket
|
|
if (operation === 'get') {
|
|
const ticketId = this.getNodeParameter('id', i) as string;
|
|
responseData = await zendeskApiRequest.call(this, 'GET', `/tickets/${ticketId}`, {});
|
|
responseData = responseData.ticket;
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/search#list-search-results
|
|
if (operation === 'getAll') {
|
|
const returnAll = this.getNodeParameter('returnAll', i) as boolean;
|
|
const options = this.getNodeParameter('options', i) as IDataObject;
|
|
qs.query = 'type:ticket';
|
|
if (options.status) {
|
|
qs.query += ` status:${options.status}`;
|
|
}
|
|
if (options.sortBy) {
|
|
qs.sort_by = options.sortBy;
|
|
}
|
|
if (options.sortOrder) {
|
|
qs.sort_order = options.sortOrder;
|
|
}
|
|
if (returnAll) {
|
|
responseData = await zendeskApiRequestAllItems.call(this, 'results', 'GET', `/search`, {}, qs);
|
|
} else {
|
|
const limit = this.getNodeParameter('limit', i) as number;
|
|
qs.per_page = limit;
|
|
responseData = await zendeskApiRequest.call(this, 'GET', `/search`, {}, qs);
|
|
responseData = responseData.results;
|
|
}
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/tickets#delete-ticket
|
|
if (operation === 'delete') {
|
|
const ticketId = this.getNodeParameter('id', i) as string;
|
|
try {
|
|
responseData = await zendeskApiRequest.call(this, 'DELETE', `/tickets/${ticketId}`, {});
|
|
} catch (err) {
|
|
throw new Error(`Zendesk Error: ${err}`);
|
|
}
|
|
}
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/ticket_fields
|
|
if (resource === 'ticketField') {
|
|
//https://developer.zendesk.com/rest_api/docs/support/tickets#show-ticket
|
|
if (operation === 'get') {
|
|
const ticketFieldId = this.getNodeParameter('ticketFieldId', i) as string;
|
|
responseData = await zendeskApiRequest.call(this, 'GET', `/ticket_fields/${ticketFieldId}`, {});
|
|
responseData = responseData.ticket_field;
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/ticket_fields#list-ticket-fields
|
|
if (operation === 'getAll') {
|
|
const returnAll = this.getNodeParameter('returnAll', i) as boolean;
|
|
if (returnAll) {
|
|
responseData = await zendeskApiRequestAllItems.call(this, 'ticket_fields', 'GET', '/ticket_fields', {}, qs);
|
|
} else {
|
|
const limit = this.getNodeParameter('limit', i) as number;
|
|
qs.limit = limit;
|
|
responseData = await zendeskApiRequestAllItems.call(this, 'ticket_fields', 'GET', '/ticket_fields', {}, qs);
|
|
responseData = responseData.slice(0, limit);
|
|
}
|
|
}
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/users
|
|
if (resource === 'user') {
|
|
//https://developer.zendesk.com/rest_api/docs/support/users#create-user
|
|
if (operation === 'create') {
|
|
const name = this.getNodeParameter('name', i) as string;
|
|
const additionalFields = this.getNodeParameter('additionalFields', i) as IDataObject;
|
|
|
|
const body: IDataObject = {
|
|
name,
|
|
};
|
|
|
|
Object.assign(body, additionalFields);
|
|
|
|
if (body.userFieldsUi) {
|
|
const userFields = (body.userFieldsUi as IDataObject).userFieldValues as IDataObject[];
|
|
if (userFields) {
|
|
body.user_fields = {};
|
|
for (const userField of userFields) {
|
|
//@ts-ignore
|
|
body.user_fields[userField.field] = userField.value;
|
|
}
|
|
delete body.userFieldsUi;
|
|
}
|
|
}
|
|
|
|
responseData = await zendeskApiRequest.call(this, 'POST', '/users', { user: body });
|
|
responseData = responseData.user;
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/tickets#update-ticket
|
|
if (operation === 'update') {
|
|
const userId = this.getNodeParameter('id', i) as string;
|
|
const updateFields = this.getNodeParameter('updateFields', i) as IDataObject;
|
|
|
|
const body: IDataObject = {};
|
|
|
|
Object.assign(body, updateFields);
|
|
|
|
if (body.userFieldsUi) {
|
|
const userFields = (body.userFieldsUi as IDataObject).userFieldValues as IDataObject[];
|
|
if (userFields) {
|
|
body.user_fields = {};
|
|
for (const userField of userFields) {
|
|
//@ts-ignore
|
|
body.user_fields[userField.field] = userField.value;
|
|
}
|
|
delete body.userFieldsUi;
|
|
}
|
|
}
|
|
|
|
responseData = await zendeskApiRequest.call(this, 'PUT', `/users/${userId}`, { user: body });
|
|
responseData = responseData.user;
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/users#show-user
|
|
if (operation === 'get') {
|
|
const userId = this.getNodeParameter('id', i) as string;
|
|
responseData = await zendeskApiRequest.call(this, 'GET', `/users/${userId}`, {});
|
|
responseData = responseData.user;
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/users#list-users
|
|
if (operation === 'getAll') {
|
|
const returnAll = this.getNodeParameter('returnAll', i) as boolean;
|
|
const options = this.getNodeParameter('filters', i) as IDataObject;
|
|
|
|
Object.assign(qs, options);
|
|
|
|
if (returnAll) {
|
|
responseData = await zendeskApiRequestAllItems.call(this, 'users', 'GET', `/users`, {}, qs);
|
|
} else {
|
|
const limit = this.getNodeParameter('limit', i) as number;
|
|
qs.per_page = limit;
|
|
responseData = await zendeskApiRequest.call(this, 'GET', `/users`, {}, qs);
|
|
responseData = responseData.users;
|
|
}
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/users#search-users
|
|
if (operation === 'search') {
|
|
const returnAll = this.getNodeParameter('returnAll', i) as boolean;
|
|
const options = this.getNodeParameter('filters', i) as IDataObject;
|
|
|
|
Object.assign(qs, options);
|
|
|
|
if (returnAll) {
|
|
responseData = await zendeskApiRequestAllItems.call(this, 'users', 'GET', `/users/search`, {}, qs);
|
|
} else {
|
|
const limit = this.getNodeParameter('limit', i) as number;
|
|
qs.per_page = limit;
|
|
responseData = await zendeskApiRequest.call(this, 'GET', `/users/search`, {}, qs);
|
|
responseData = responseData.users;
|
|
}
|
|
}
|
|
//https://developer.zendesk.com/rest_api/docs/support/users#delete-user
|
|
if (operation === 'delete') {
|
|
const userId = this.getNodeParameter('id', i) as string;
|
|
responseData = await zendeskApiRequest.call(this, 'DELETE', `/users/${userId}`, {});
|
|
responseData = responseData.user;
|
|
}
|
|
}
|
|
if (Array.isArray(responseData)) {
|
|
returnData.push.apply(returnData, responseData as IDataObject[]);
|
|
} else {
|
|
returnData.push(responseData as IDataObject);
|
|
}
|
|
}
|
|
return [this.helpers.returnJsonArray(returnData)];
|
|
}
|
|
}
|