snapshot of https://github.com/RocketChat/Rocket.Chat.git (develop, 2026-09-16; blobs > 131072B omitted)

apps/meteor/server/lib/omnichannel/contacts/createContact.ts

@@ -0,0 +1,52 @@
+import type { ILivechatContactChannel, IVisitorLastChat } from '@rocket.chat/core-typings';
+import { LivechatContacts } from '@rocket.chat/models';
+
+import { getAllowedCustomFields } from './getAllowedCustomFields';
+import { validateContactManager } from './validateContactManager';
+import { validateCustomFields } from './validateCustomFields';
+
+export type CreateContactParams = {
+	name: string;
+	emails?: string[];
+	phones?: string[];
+	unknown: boolean;
+	customFields?: Record<string, string | unknown>;
+	lastChat?: IVisitorLastChat;
+	contactManager?: string;
+	channels?: ILivechatContactChannel[];
+	importIds?: string[];
+	shouldValidateCustomFields?: boolean;
+};
+
+export async function createContact({
+	name,
+	emails,
+	phones,
+	customFields: receivedCustomFields = {},
+	lastChat,
+	contactManager,
+	channels = [],
+	unknown,
+	importIds,
+	shouldValidateCustomFields = true,
+}: CreateContactParams): Promise<string> {
+	if (contactManager) {
+		await validateContactManager(contactManager);
+	}
+
+	const customFields = shouldValidateCustomFields
+		? validateCustomFields(await getAllowedCustomFields(), receivedCustomFields)
+		: receivedCustomFields;
+
+	return LivechatContacts.insertContact({
+		name,
+		...(emails && { emails: emails?.map((address) => ({ address })) }),
+		...(phones && { phones: phones?.map((phoneNumber) => ({ phoneNumber })) }),
+		...(contactManager && { contactManager }),
+		...(channels && { channels }),
+		...(customFields && { customFields }),
+		...(lastChat && { lastChat }),
+		unknown,
+		...(importIds?.length && { importIds }),
+	});
+}