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

apps/meteor/server/lib/import/omnichannel-contacts/ContactImporter.ts

@@ -0,0 +1,48 @@
+import fs from 'node:fs';
+
+import type { IImport } from '@rocket.chat/core-typings';
+import { parse } from 'csv-parse/lib/sync';
+
+import { Importer, ProgressStep, ImporterWebsocket } from '..';
+import { addParsedContacts } from './addParsedContacts';
+import type { ConverterOptions } from '../classes/ImportDataConverter';
+import type { ImporterProgress } from '../classes/ImporterProgress';
+import type { ImporterInfo } from '../definitions/ImporterInfo';
+
+export class ContactImporter extends Importer {
+	private csvParser: (csv: string) => string[][];
+
+	constructor(info: ImporterInfo, importRecord: IImport, converterOptions: ConverterOptions = {}) {
+		super(info, importRecord, converterOptions);
+
+		this.csvParser = parse;
+	}
+
+	override async prepareUsingLocalFile(fullFilePath: string): Promise<ImporterProgress> {
+		this.logger.debug('start preparing import operation');
+		await this.converter.clearImportData();
+
+		ImporterWebsocket.progressUpdated({ rate: 0 });
+
+		await super.updateProgress(ProgressStep.PREPARING_CONTACTS);
+		// Reading the whole file at once for compatibility with the code written for the other importers
+		// We can change this to a stream once we improve the rest of the importer classes
+		const fileContents = fs.readFileSync(fullFilePath, { encoding: 'utf8' });
+		if (!fileContents || typeof fileContents !== 'string') {
+			throw new Error('Failed to load file contents.');
+		}
+
+		const parsedContacts = this.csvParser(fileContents);
+		const contactsCount = await addParsedContacts.call(this.converter, parsedContacts);
+
+		if (contactsCount === 0) {
+			this.logger.error('No contacts found in the import file.');
+			await super.updateProgress(ProgressStep.ERROR);
+		} else {
+			await super.updateRecord({ 'count.contacts': contactsCount, 'count.total': contactsCount });
+			ImporterWebsocket.progressUpdated({ rate: 100 });
+		}
+
+		return super.getProgress();
+	}
+}

apps/meteor/server/lib/import/omnichannel-contacts/addParsedContacts.ts

@@ -0,0 +1,39 @@
+import { Random } from '@rocket.chat/random';
+
+import type { ImportDataConverter } from '../classes/ImportDataConverter';
+
+export async function addParsedContacts(this: ImportDataConverter, parsedContacts: string[][]): Promise<number> {
+	const columnNames = parsedContacts.shift();
+	let addedContacts = 0;
+
+	for (const parsedData of parsedContacts) {
+		const contactData = parsedData.reduce(
+			(acc, value, index) => {
+				const columnName = columnNames && index < columnNames.length ? columnNames[index] : `column${index}`;
+				return {
+					...acc,
+					[columnName]: value,
+				};
+			},
+			{} as Record<string, string>,
+		);
+
+		if (!contactData.emails && !contactData.phones && !contactData.name) {
+			continue;
+		}
+
+		const { emails = '', phones = '', name = '', manager: contactManager = undefined, id = Random.id(), ...customFields } = contactData;
+
+		await this.addContact({
+			importIds: [id],
+			emails: emails.split(';'),
+			phones: phones.split(';'),
+			name,
+			contactManager,
+			customFields,
+		});
+		addedContacts++;
+	}
+
+	return addedContacts;
+}

apps/meteor/server/lib/import/omnichannel-contacts/index.ts

@@ -0,0 +1,12 @@
+import { License } from '@rocket.chat/license';
+
+import { Importers } from '..';
+import { ContactImporter } from './ContactImporter';
+
+License.onValidFeature('contact-id-verification', () => {
+	Importers.add({
+		key: 'omnichannel_contact',
+		name: 'omnichannel_contacts_importer',
+		importer: ContactImporter,
+	});
+});