first commit

packages/nodes-base/nodes/Microsoft/Teams/v2/actions/chatMessage/create.operation.ts

@@ -0,0 +1,88 @@
+import type { INodeProperties, IExecuteFunctions, IDataObject } from 'n8n-workflow';
+
+import { updateDisplayOptions } from '@utils/utilities';
+
+import { chatRLC } from '../../descriptions';
+import { prepareMessage } from '../../helpers/utils';
+import { microsoftApiRequest } from '../../transport';
+
+const properties: INodeProperties[] = [
+	chatRLC,
+	{
+		displayName: 'Content Type',
+		name: 'contentType',
+		required: true,
+		type: 'options',
+		options: [
+			{
+				name: 'Text',
+				value: 'text',
+			},
+			{
+				name: 'HTML',
+				value: 'html',
+			},
+		],
+		default: 'text',
+		description: 'Whether the message is plain text or HTML',
+	},
+	{
+		displayName: 'Message',
+		name: 'message',
+		required: true,
+		type: 'string',
+		default: '',
+		description: 'The content of the message to be sent',
+		typeOptions: {
+			rows: 2,
+		},
+	},
+	{
+		displayName: 'Options',
+		name: 'options',
+		type: 'collection',
+		default: {},
+		description: 'Other options to set',
+		placeholder: 'Add option',
+		options: [
+			{
+				displayName: 'Include Link to Workflow',
+				name: 'includeLinkToWorkflow',
+				type: 'boolean',
+				default: true,
+				description:
+					'Whether to append a link to this workflow at the end of the message. This is helpful if you have many workflows sending messages.',
+			},
+		],
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['chatMessage'],
+		operation: ['create'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);
+
+export async function execute(this: IExecuteFunctions, i: number, instanceId: string) {
+	// https://docs.microsoft.com/en-us/graph/api/channel-post-messages?view=graph-rest-1.0&tabs=http
+
+	const chatId = this.getNodeParameter('chatId', i, '', { extractValue: true }) as string;
+	const contentType = this.getNodeParameter('contentType', i) as string;
+	const message = this.getNodeParameter('message', i) as string;
+	const options = this.getNodeParameter('options', i, {});
+
+	const includeLinkToWorkflow = options.includeLinkToWorkflow !== false;
+
+	const body: IDataObject = prepareMessage.call(
+		this,
+		message,
+		contentType,
+		includeLinkToWorkflow,
+		instanceId,
+	);
+
+	return await microsoftApiRequest.call(this, 'POST', `/v1.0/chats/${chatId}/messages`, body);
+}

packages/nodes-base/nodes/Microsoft/Teams/v2/actions/chatMessage/get.operation.ts

@@ -0,0 +1,51 @@
+import { type INodeProperties, type IExecuteFunctions, NodeOperationError } from 'n8n-workflow';
+
+import { updateDisplayOptions } from '@utils/utilities';
+
+import { chatRLC } from '../../descriptions';
+import { microsoftApiRequest } from '../../transport';
+
+const properties: INodeProperties[] = [
+	chatRLC,
+	{
+		displayName: 'Message ID',
+		name: 'messageId',
+		required: true,
+		type: 'string',
+		default: '',
+		placeholder: 'e.g. 1673355049064',
+		description: 'The ID of the message to retrieve',
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['chatMessage'],
+		operation: ['get'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);
+
+export async function execute(this: IExecuteFunctions, i: number) {
+	// https://docs.microsoft.com/en-us/graph/api/chat-list-messages?view=graph-rest-1.0&tabs=http
+
+	try {
+		const chatId = this.getNodeParameter('chatId', i, '', { extractValue: true }) as string;
+		const messageId = this.getNodeParameter('messageId', i) as string;
+
+		return await microsoftApiRequest.call(
+			this,
+			'GET',
+			`/v1.0/chats/${chatId}/messages/${messageId}`,
+		);
+	} catch (error) {
+		throw new NodeOperationError(
+			this.getNode(),
+			"The message you are trying to get doesn't exist",
+			{
+				description: "Check that the 'Message ID' parameter is correctly set",
+			},
+		);
+	}
+}

packages/nodes-base/nodes/Microsoft/Teams/v2/actions/chatMessage/getAll.operation.ts

@@ -0,0 +1,44 @@
+import type { INodeProperties, IExecuteFunctions } from 'n8n-workflow';
+
+import { returnAllOrLimit } from '@utils/descriptions';
+import { updateDisplayOptions } from '@utils/utilities';
+
+import { chatRLC } from '../../descriptions';
+import { microsoftApiRequestAllItems } from '../../transport';
+
+const properties: INodeProperties[] = [chatRLC, ...returnAllOrLimit];
+
+const displayOptions = {
+	show: {
+		resource: ['chatMessage'],
+		operation: ['getAll'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);
+
+export async function execute(this: IExecuteFunctions, i: number) {
+	// https://docs.microsoft.com/en-us/graph/api/chat-list-messages?view=graph-rest-1.0&tabs=http
+
+	const chatId = this.getNodeParameter('chatId', i, '', { extractValue: true }) as string;
+	const returnAll = this.getNodeParameter('returnAll', i);
+
+	if (returnAll) {
+		return await microsoftApiRequestAllItems.call(
+			this,
+			'value',
+			'GET',
+			`/v1.0/chats/${chatId}/messages`,
+		);
+	} else {
+		const limit = this.getNodeParameter('limit', i);
+		const responseData = await microsoftApiRequestAllItems.call(
+			this,
+			'value',
+			'GET',
+			`/v1.0/chats/${chatId}/messages`,
+			{},
+		);
+		return responseData.splice(0, limit);
+	}
+}

packages/nodes-base/nodes/Microsoft/Teams/v2/actions/chatMessage/index.ts

@@ -0,0 +1,54 @@
+import { SEND_AND_WAIT_OPERATION, type INodeProperties } from 'n8n-workflow';
+
+import * as create from './create.operation';
+import * as get from './get.operation';
+import * as getAll from './getAll.operation';
+import * as sendAndWait from './sendAndWait.operation';
+
+export { create, get, getAll, sendAndWait };
+
+export const description: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['chatMessage'],
+			},
+		},
+		options: [
+			{
+				name: 'Create',
+				value: 'create',
+				description: 'Create a message in a chat',
+				action: 'Create chat message',
+			},
+			{
+				name: 'Get',
+				value: 'get',
+				description: 'Get a message from a chat',
+				action: 'Get chat message',
+			},
+			{
+				name: 'Get Many',
+				value: 'getAll',
+				description: 'Get many messages from a chat',
+				action: 'Get many chat messages',
+			},
+			{
+				name: 'Send and Wait for Response',
+				value: SEND_AND_WAIT_OPERATION,
+				description: 'Send a message and wait for response',
+				action: 'Send message and wait for response',
+			},
+		],
+		default: 'create',
+	},
+
+	...create.description,
+	...get.description,
+	...getAll.description,
+	...sendAndWait.description,
+];

packages/nodes-base/nodes/Microsoft/Teams/v2/actions/chatMessage/sendAndWait.operation.ts

@@ -0,0 +1,45 @@
+import type { INodeProperties, IExecuteFunctions } from 'n8n-workflow';
+
+import {
+	getSendAndWaitConfig,
+	getSendAndWaitProperties,
+} from '../../../../../../utils/sendAndWait/utils';
+import { createUtmCampaignLink } from '../../../../../../utils/utilities';
+import { chatRLC } from '../../descriptions';
+import { microsoftApiRequest } from '../../transport';
+
+export const description: INodeProperties[] = getSendAndWaitProperties(
+	[chatRLC],
+	'chatMessage',
+	undefined,
+	{
+		noButtonStyle: true,
+		defaultApproveLabel: '✓ Approve',
+		defaultDisapproveLabel: '✗ Decline',
+	},
+).filter((p) => p.name !== 'subject');
+
+export async function execute(this: IExecuteFunctions, i: number, instanceId: string) {
+	const chatId = this.getNodeParameter('chatId', i, '', { extractValue: true }) as string;
+	const config = getSendAndWaitConfig(this);
+
+	const buttons = config.options.map((option) => `<a href="${option.url}">${option.label}</a>`);
+
+	let content = `${config.message}<br><br>${buttons.join(' ')}`;
+
+	if (config.appendAttribution !== false) {
+		const attributionText = 'This message was sent automatically with';
+		const link = createUtmCampaignLink('n8n-nodes-base.microsoftTeams', instanceId);
+		const attribution = `<em>${attributionText} <a href="${link}">n8n</a></em>`;
+		content += `<br><br>${attribution}`;
+	}
+
+	const body = {
+		body: {
+			contentType: 'html',
+			content,
+		},
+	};
+
+	return await microsoftApiRequest.call(this, 'POST', `/v1.0/chats/${chatId}/messages`, body);
+}