cal.pub0.org/packages/app-store/zohocrm/lib/CalendarService.ts

330 lines
11 KiB
TypeScript

import axios from "axios";
import qs from "qs";
import { getLocation } from "@calcom/lib/CalEventParser";
import { HttpError } from "@calcom/lib/http-error";
import logger from "@calcom/lib/logger";
import prisma from "@calcom/prisma";
import type {
Calendar,
CalendarEvent,
EventBusyDate,
IntegrationCalendar,
NewCalendarEventType,
Person,
} from "@calcom/types/Calendar";
import type { CredentialPayload } from "@calcom/types/Credential";
import getAppKeysFromSlug from "../../_utils/getAppKeysFromSlug";
export type ZohoToken = {
scope: string;
api_domain: string;
expires_in: number;
expiryDate: number;
token_type: string;
access_token: string;
accountServer: string;
refresh_token: string;
};
export type ZohoContact = {
Email: string;
};
/**
* Converts to the date Format as required by zoho: 2020-08-02T15:30:00+05:30
* https://www.zoho.com/crm/developer/docs/api/v2/events-response.html
*/
const toISO8601String = (date: Date) => {
const tzo = -date.getTimezoneOffset(),
dif = tzo >= 0 ? "+" : "-",
pad = function (num: number) {
return (num < 10 ? "0" : "") + num;
};
return (
date.getFullYear() +
"-" +
pad(date.getMonth() + 1) +
"-" +
pad(date.getDate()) +
"T" +
pad(date.getHours()) +
":" +
pad(date.getMinutes()) +
":" +
pad(date.getSeconds()) +
dif +
pad(Math.floor(Math.abs(tzo) / 60)) +
":" +
pad(Math.abs(tzo) % 60)
);
};
export default class ZohoCrmCalendarService implements Calendar {
private integrationName = "";
private auth: Promise<{ getToken: () => Promise<void> }>;
private log: typeof logger;
private client_id = "";
private client_secret = "";
private accessToken = "";
constructor(credential: CredentialPayload) {
this.integrationName = "zohocrm_other_calendar";
this.auth = this.zohoCrmAuth(credential).then((r) => r);
this.log = logger.getChildLogger({ prefix: [`[[lib] ${this.integrationName}`] });
}
private createContacts = async (attendees: Person[]) => {
const contacts = attendees.map((attendee) => {
const [firstname, lastname] = !!attendee.name ? attendee.name.split(" ") : [attendee.email, "-"];
return {
First_Name: firstname,
Last_Name: lastname || "-",
Email: attendee.email,
};
});
return axios({
method: "post",
url: `https://www.zohoapis.com/crm/v3/Contacts`,
headers: {
"content-type": "application/json",
authorization: `Zoho-oauthtoken ${this.accessToken}`,
},
data: JSON.stringify({ data: contacts }),
});
};
private contactSearch = async (event: CalendarEvent) => {
const searchCriteria =
"(" + event.attendees.map((attendee) => `(Email:equals:${encodeURI(attendee.email)})`).join("or") + ")";
return await axios({
method: "get",
url: `https://www.zohoapis.com/crm/v3/Contacts/search?criteria=${searchCriteria}`,
headers: {
authorization: `Zoho-oauthtoken ${this.accessToken}`,
},
})
.then((data) => data.data)
.catch((e) => this.log.error(e, e.response?.data));
};
private getMeetingBody = (event: CalendarEvent): string => {
return `<b>${event.organizer.language.translate("invitee_timezone")}:</b> ${
event.attendees[0].timeZone
}<br><br><b>${event.organizer.language.translate("share_additional_notes")}</b><br>${
event.additionalNotes || "-"
}`;
};
private createZohoEvent = async (event: CalendarEvent) => {
const zohoEvent = {
Event_Title: event.title,
Start_DateTime: toISO8601String(new Date(event.startTime)),
End_DateTime: toISO8601String(new Date(event.endTime)),
Description: this.getMeetingBody(event),
Venue: getLocation(event),
};
return axios({
method: "post",
url: `https://www.zohoapis.com/crm/v3/Events`,
headers: {
"content-type": "application/json",
authorization: `Zoho-oauthtoken ${this.accessToken}`,
},
data: JSON.stringify({ data: [zohoEvent] }),
})
.then((data) => data.data)
.catch((e) => this.log.error(e, e.response?.data));
};
private updateMeeting = async (uid: string, event: CalendarEvent) => {
const zohoEvent = {
id: uid,
Event_Title: event.title,
Start_DateTime: toISO8601String(new Date(event.startTime)),
End_DateTime: toISO8601String(new Date(event.endTime)),
Description: this.getMeetingBody(event),
Venue: getLocation(event),
};
return axios({
method: "put",
url: `https://www.zohoapis.com/crm/v3/Events`,
headers: {
"content-type": "application/json",
authorization: `Zoho-oauthtoken ${this.accessToken}`,
},
data: JSON.stringify({ data: [zohoEvent] }),
})
.then((data) => data.data)
.catch((e) => this.log.error(e, e.response?.data));
};
private deleteMeeting = async (uid: string) => {
return axios({
method: "delete",
url: `https://www.zohoapis.com/crm/v3/Events?ids=${uid}`,
headers: {
"content-type": "application/json",
authorization: `Zoho-oauthtoken ${this.accessToken}`,
},
})
.then((data) => data.data)
.catch((e) => this.log.error(e, e.response?.data));
};
private zohoCrmAuth = async (credential: CredentialPayload) => {
const appKeys = await getAppKeysFromSlug("zohocrm");
if (typeof appKeys.client_id === "string") this.client_id = appKeys.client_id;
if (typeof appKeys.client_secret === "string") this.client_secret = appKeys.client_secret;
if (!this.client_id) throw new HttpError({ statusCode: 400, message: "Zoho CRM client_id missing." });
if (!this.client_secret)
throw new HttpError({ statusCode: 400, message: "Zoho CRM client_secret missing." });
const credentialKey = credential.key as unknown as ZohoToken;
const isTokenValid = (token: ZohoToken) => {
const isValid = token && token.access_token && token.expiryDate && token.expiryDate < Date.now();
if (isValid) {
this.accessToken = token.access_token;
}
return isValid;
};
const refreshAccessToken = async (credentialKey: ZohoToken) => {
try {
const url = `${credentialKey.accountServer}/oauth/v2/token`;
const formData = {
grant_type: "refresh_token",
client_id: this.client_id,
client_secret: this.client_secret,
refresh_token: credentialKey.refresh_token,
};
const zohoCrmTokenInfo = await axios({
method: "post",
url: url,
data: qs.stringify(formData),
headers: {
"Content-Type": "application/x-www-form-urlencoded;charset=utf-8",
},
});
if (!zohoCrmTokenInfo.data.error) {
// set expiry date as offset from current time.
zohoCrmTokenInfo.data.expiryDate = Math.round(Date.now() + 60 * 60);
await prisma.credential.update({
where: {
id: credential.id,
},
data: {
key: {
...(zohoCrmTokenInfo.data as ZohoToken),
refresh_token: credentialKey.refresh_token,
accountServer: credentialKey.accountServer,
},
},
});
this.accessToken = zohoCrmTokenInfo.data.access_token;
this.log.debug("Fetched token", this.accessToken);
} else {
this.log.error(zohoCrmTokenInfo.data);
}
} catch (e: unknown) {
this.log.error(e);
}
};
return {
getToken: () => (isTokenValid(credentialKey) ? Promise.resolve() : refreshAccessToken(credentialKey)),
};
};
async handleEventCreation(event: CalendarEvent, contacts: CalendarEvent["attendees"]) {
const meetingEvent = await this.createZohoEvent(event);
if (meetingEvent.data && meetingEvent.data.length && meetingEvent.data[0].status === "success") {
this.log.debug("event:creation:ok", { meetingEvent });
return Promise.resolve({
uid: meetingEvent.data[0].details.id,
id: meetingEvent.data[0].details.id,
type: this.integrationName,
password: "",
url: "",
additionalInfo: { contacts, meetingEvent },
});
}
this.log.debug("meeting:creation:notOk", { meetingEvent, event, contacts });
return Promise.reject("Something went wrong when creating a meeting in ZohoCRM");
}
async createEvent(event: CalendarEvent): Promise<NewCalendarEventType> {
const auth = await this.auth;
await auth.getToken();
const contacts = await this.contactSearch(event);
if (contacts.data && contacts.data.length) {
if (contacts.data.length === event.attendees.length) {
// all contacts are in Zoho CRM already.
this.log.debug("contact:search:all", { event, contacts: contacts.data });
return await this.handleEventCreation(event, event.attendees);
} else {
// Some attendees don't exist in ZohoCRM
// Get the existing contacts' email to filter out
this.log.debug("contact:search:notAll", { event, contacts });
const existingContacts = contacts.data.map((contact: ZohoContact) => contact.Email);
this.log.debug("contact:filter:existing", { existingContacts });
// Get non existing contacts filtering out existing from attendees
const nonExistingContacts: Person[] = event.attendees.filter(
(attendee) => !existingContacts.includes(attendee.email)
);
this.log.debug("contact:filter:nonExisting", { nonExistingContacts });
// Only create contacts in ZohoCRM that were not present in the previous contact search
const createContacts = await this.createContacts(nonExistingContacts);
this.log.debug("contact:created", { createContacts });
// Continue with event creation and association only when all contacts are present in Zoho
if (createContacts.data?.data[0].status === "success") {
this.log.debug("contact:creation:ok");
return await this.handleEventCreation(event, nonExistingContacts.concat(contacts));
}
return Promise.reject({
calError: "Something went wrong when creating non-existing attendees in ZohoCRM",
});
}
} else {
this.log.debug("contact:search:none", { event, contacts });
const createContacts = await this.createContacts(event.attendees);
this.log.debug("contact:created", { createContacts });
if (createContacts.data?.data[0].status === "success") {
this.log.debug("contact:creation:ok");
return await this.handleEventCreation(event, event.attendees);
}
}
return Promise.reject({
calError: "Something went wrong when searching/creating the attendees in ZohoCRM",
});
}
async updateEvent(uid: string, event: CalendarEvent): Promise<NewCalendarEventType> {
const auth = await this.auth;
await auth.getToken();
return await this.updateMeeting(uid, event);
}
async deleteEvent(uid: string): Promise<void> {
const auth = await this.auth;
await auth.getToken();
return await this.deleteMeeting(uid);
}
async getAvailability(
_dateFrom: string,
_dateTo: string,
_selectedCalendars: IntegrationCalendar[]
): Promise<EventBusyDate[]> {
return Promise.resolve([]);
}
async listCalendars(_event?: CalendarEvent): Promise<IntegrationCalendar[]> {
return Promise.resolve([]);
}
}