n8n-nodes-pragma-bitrix24 1.0.0

package/dist/nodes/Bitrix24ChatBot/Bitrix24ChatBot.node.js

@@ -0,0 +1,522 @@
+"use strict";
+/**
+ * Bitrix24 ChatBot — Нода управления чат-ботами
+ *
+ * Bitrix24 PRAGMA.by nodes for n8n
+ * Профессиональная интеграция с Битрикс24.
+ *
+ * @author PRAGMA & Азбука Решений
+ * @copyright 2026 PRAGMA (https://pragma.by/) & Азбука Решений (https://abc-solution.ru/)
+ *
+ * Контакты:
+ * 🇧🇾 PRAGMA: +375 (44) 702-70-90 | https://pragma.by/
+ * 🇷🇺 Азбука Решений: +7 (939) 555-19-60 | https://abc-solution.ru/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bitrix24ChatBot = void 0;
+const Helpers_1 = require("../Bitrix24/Helpers");
+class Bitrix24ChatBot {
+    constructor() {
+        this.description = {
+            displayName: 'Bitrix24 Чат-бот',
+            name: 'bitrix24ChatBot',
+            icon: 'file:bitrix24.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Управление чат-ботами, сообщениями и уведомлениями в Битрикс24',
+            defaults: {
+                name: 'Bitrix24 Чат-бот',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'bitrix24Api',
+                    required: false,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Authentication Method',
+                    name: 'authMethod',
+                    type: 'options',
+                    options: [
+                        {
+                            name: 'Saved Credentials',
+                            value: 'credentials',
+                        },
+                        {
+                            name: 'Access Token (Stateless)',
+                            value: 'token',
+                            description: 'Use token from an event (e.g. Bot Message) for quick reply without DB.',
+                        },
+                    ],
+                    default: 'credentials',
+                    description: 'Choose how to authenticate',
+                },
+                {
+                    displayName: 'Access Token',
+                    name: 'accessToken',
+                    type: 'string',
+                    typeOptions: { password: true },
+                    default: '',
+                    displayOptions: { show: { authMethod: ['token'] } },
+                    required: true,
+                    description: 'Access Token (from Bitrix24 Trigger)',
+                },
+                {
+                    displayName: 'Domain',
+                    name: 'domain',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { authMethod: ['token'] } },
+                    required: true,
+                    description: 'Bitrix24 Domain (e.g. myportal.bitrix24.com)',
+                },
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Bot',
+                            value: 'bot',
+                            description: 'Manage Bots (Register/Update)',
+                        },
+                        {
+                            name: 'Message',
+                            value: 'message',
+                            description: 'Send messages (Bot)',
+                        },
+                        {
+                            name: 'Command',
+                            value: 'command',
+                            description: 'Manage commands (Slash commands)',
+                        },
+                        {
+                            name: 'Chat',
+                            value: 'chat',
+                            description: 'Manage chats (Create/Add Users)',
+                        },
+                        {
+                            name: 'Notification',
+                            value: 'notification',
+                            description: 'Send system notifications',
+                        },
+                    ],
+                    default: 'message',
+                    required: true,
+                },
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        // Bot
+                        {
+                            name: 'Register',
+                            value: 'register',
+                            action: 'Register a new bot',
+                            displayOptions: { show: { resource: ['bot'] } },
+                        },
+                        {
+                            name: 'Update',
+                            value: 'update',
+                            action: 'Update a bot',
+                            displayOptions: { show: { resource: ['bot'] } },
+                        },
+                        // Message
+                        {
+                            name: 'Send',
+                            value: 'send',
+                            action: 'Send a message',
+                            displayOptions: { show: { resource: ['message'] } },
+                        },
+                        {
+                            name: 'Update',
+                            value: 'update',
+                            action: 'Update a message',
+                            displayOptions: { show: { resource: ['message'] } },
+                        },
+                        {
+                            name: 'Delete',
+                            value: 'delete',
+                            action: 'Delete a message',
+                            displayOptions: { show: { resource: ['message'] } },
+                        },
+                        {
+                            name: 'Typing',
+                            value: 'typing',
+                            action: 'Send typing notification',
+                            displayOptions: { show: { resource: ['message'] } },
+                        },
+                        // Command
+                        {
+                            name: 'Register',
+                            value: 'register',
+                            action: 'Register a command',
+                            displayOptions: { show: { resource: ['command'] } },
+                        },
+                        {
+                            name: 'Delete',
+                            value: 'delete',
+                            action: 'Delete a command',
+                            displayOptions: { show: { resource: ['command'] } },
+                        },
+                        {
+                            name: 'Answer',
+                            value: 'answer',
+                            action: 'Answer a command',
+                            displayOptions: { show: { resource: ['command'] } },
+                        },
+                        // Chat
+                        {
+                            name: 'Create',
+                            value: 'create',
+                            action: 'Create a chat',
+                            displayOptions: { show: { resource: ['chat'] } },
+                        },
+                        {
+                            name: 'Add User',
+                            value: 'addUser',
+                            action: 'Add user to chat',
+                            displayOptions: { show: { resource: ['chat'] } },
+                        },
+                        {
+                            name: 'Get Users',
+                            value: 'getUsers', // im.chat.user.list
+                            action: 'Get chat users',
+                            displayOptions: { show: { resource: ['chat'] } },
+                        },
+                        // Notification
+                        {
+                            name: 'Send',
+                            value: 'send',
+                            action: 'Send notification',
+                            displayOptions: { show: { resource: ['notification'] } },
+                        },
+                    ],
+                    default: 'send',
+                    required: true,
+                },
+                // ----------------------------------
+                // Fields for Bot Register
+                // ----------------------------------
+                {
+                    displayName: 'Code',
+                    name: 'code',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['bot'], operation: ['register'] } },
+                    description: 'Unique code for the bot (e.g. "my_bot")',
+                },
+                {
+                    displayName: 'Type',
+                    name: 'type',
+                    type: 'options',
+                    options: [
+                        { name: 'Bot', value: 'B' },
+                        { name: 'Human', value: 'H' },
+                        { name: 'Openline', value: 'O' },
+                        { name: 'Supervisor', value: 'S' },
+                    ],
+                    default: 'B',
+                    displayOptions: { show: { resource: ['bot'], operation: ['register'] } },
+                },
+                {
+                    displayName: 'Event Handler URL',
+                    name: 'eventHandler',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['bot'], operation: ['register', 'update'] } }, // Update allows changing url
+                    description: 'URL to handle bot events (Webhook)',
+                },
+                {
+                    displayName: 'Bot Name',
+                    name: 'name',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['bot', 'chat'], operation: ['register', 'update', 'create'] } },
+                },
+                {
+                    displayName: 'Bot ID',
+                    name: 'botId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['bot'], operation: ['update'] } },
+                    description: 'ID of the bot to update',
+                },
+                // ----------------------------------
+                // Fields for Message Send
+                // ----------------------------------
+                {
+                    displayName: 'Bot ID (Sender)',
+                    name: 'botId', // Reuse botId parameter name? Or senderId. imbot.message.add needs BOT_ID
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['message'], operation: ['send'] } },
+                    description: 'ID of the bot sending the message',
+                    required: true,
+                },
+                {
+                    displayName: 'Message ID',
+                    name: 'messageId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['message'], operation: ['update', 'delete'] } }, // For message manupulation
+                    required: true,
+                },
+                {
+                    displayName: 'Dialog ID',
+                    name: 'dialogId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['message'], operation: ['send', 'typing'] } },
+                    description: 'Chat ID or User ID (e.g. 123 for user, chat123 for chat)',
+                    required: true,
+                },
+                {
+                    displayName: 'Message',
+                    name: 'message',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['message', 'notification'], operation: ['send', 'update'] } },
+                    description: 'Message text. Supports BB-codes.',
+                },
+                {
+                    displayName: 'Keyboard (JSON)',
+                    name: 'keyboard',
+                    type: 'json',
+                    default: '',
+                    displayOptions: { show: { resource: ['message'], operation: ['send', 'update'] } },
+                    description: 'Buttons. Example: {"BUTTONS": [{"TEXT": "Click Me", "COMMAND": "my_cmd"}]}',
+                },
+                {
+                    displayName: 'Attach (JSON)',
+                    name: 'vocab',
+                    type: 'json',
+                    default: '',
+                    displayOptions: { show: { resource: ['message'], operation: ['send', 'update'] } },
+                    description: 'Attachment definition in JSON format',
+                },
+                // ----------------------------------
+                // Fields for Command
+                // ----------------------------------
+                {
+                    displayName: 'Command',
+                    name: 'command',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['command'], operation: ['register', 'delete'] } },
+                    description: 'Command text (e.g. "report")',
+                    required: true,
+                },
+                {
+                    displayName: 'Command ID',
+                    name: 'commandId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['command'], operation: ['delete', 'answer'] } },
+                    required: true,
+                },
+                {
+                    displayName: 'Message ID',
+                    name: 'messageId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['command'], operation: ['answer'] } },
+                    description: 'ID of the message to answer to',
+                },
+                // ----------------------------------
+                // Fields for Chat
+                // ----------------------------------
+                {
+                    displayName: 'Description',
+                    name: 'description',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['chat', 'bot'], operation: ['create', 'register'] } }, // Bot register also has desc
+                },
+                {
+                    displayName: 'Chat ID',
+                    name: 'chatId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['chat'], operation: ['addUser'] } },
+                    required: true,
+                },
+                {
+                    displayName: 'User ID',
+                    name: 'userId', // Recipient for notification or user to add
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { resource: ['chat', 'notification'], operation: ['addUser', 'send'] } },
+                    required: true,
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        const authMethod = this.getNodeParameter('authMethod', 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                let overrideAuth;
+                if (authMethod === 'token') {
+                    overrideAuth = {
+                        accessToken: this.getNodeParameter('accessToken', i),
+                        domain: this.getNodeParameter('domain', i),
+                    };
+                }
+                let endpoint = '';
+                let body = {};
+                if (resource === 'bot') {
+                    if (operation === 'register') {
+                        endpoint = 'imbot.register';
+                        body.CODE = this.getNodeParameter('code', i);
+                        body.TYPE = this.getNodeParameter('type', i);
+                        body.EVENT_HANDLER = this.getNodeParameter('eventHandler', i, '');
+                        body.PROPERTIES = {
+                            NAME: this.getNodeParameter('name', i, ''),
+                            WORK_POSITION: this.getNodeParameter('description', i, ''),
+                        };
+                    }
+                    else if (operation === 'update') {
+                        endpoint = 'imbot.update';
+                        body.BOT_ID = this.getNodeParameter('botId', i);
+                        body.EVENT_HANDLER = this.getNodeParameter('eventHandler', i, '');
+                        const name = this.getNodeParameter('name', i, '');
+                        const desc = this.getNodeParameter('description', i, '');
+                        if (name || desc) {
+                            body.PROPERTIES = {};
+                            if (name)
+                                body.PROPERTIES.NAME = name;
+                            if (desc)
+                                body.PROPERTIES.WORK_POSITION = desc;
+                        }
+                    }
+                }
+                else if (resource === 'message') {
+                    if (operation === 'send') {
+                        endpoint = 'imbot.message.add';
+                        body.BOT_ID = this.getNodeParameter('botId', i);
+                        body.DIALOG_ID = this.getNodeParameter('dialogId', i);
+                        body.MESSAGE = this.getNodeParameter('message', i);
+                        const keyboard = this.getNodeParameter('keyboard', i, '');
+                        if (keyboard) {
+                            if (typeof keyboard === 'string')
+                                body.KEYBOARD = JSON.parse(keyboard);
+                            else
+                                body.KEYBOARD = keyboard;
+                        }
+                        const attach = this.getNodeParameter('vocab', i, '');
+                        if (attach) {
+                            if (typeof attach === 'string')
+                                body.ATTACH = JSON.parse(attach);
+                            else
+                                body.ATTACH = attach;
+                        }
+                    }
+                    else if (operation === 'update') {
+                        endpoint = 'imbot.message.update';
+                        body.BOT_ID = this.getNodeParameter('botId', i);
+                        body.MESSAGE_ID = this.getNodeParameter('messageId', i);
+                        body.MESSAGE = this.getNodeParameter('message', i);
+                        const keyboard = this.getNodeParameter('keyboard', i, '');
+                        if (keyboard) {
+                            if (typeof keyboard === 'string')
+                                body.KEYBOARD = JSON.parse(keyboard);
+                            else
+                                body.KEYBOARD = keyboard;
+                        }
+                    }
+                    else if (operation === 'delete') {
+                        endpoint = 'imbot.message.delete';
+                        body.BOT_ID = this.getNodeParameter('botId', i);
+                        body.MESSAGE_ID = this.getNodeParameter('messageId', i);
+                    }
+                    else if (operation === 'typing') {
+                        endpoint = 'imbot.chat.sendtyping'; // check docs. actually imbot.chat.sendtyping requires DIALOG_ID
+                        body.BOT_ID = this.getNodeParameter('botId', i);
+                        body.DIALOG_ID = this.getNodeParameter('dialogId', i);
+                    }
+                }
+                else if (resource === 'command') {
+                    if (operation === 'register') {
+                        endpoint = 'imbot.command.register';
+                        // We assume BOT_ID is derived from auth? No, user usually registers command for THEIR bot app.
+                        // Actually imbot.command.register requires BOT_ID usually.
+                        // NOTE: Standard OAuth app might restrict which bots it can manage.
+                        // Let's assume we pass BOT_ID if needed, but often it's implicit for the client.
+                        // Checking docs: imbot.command.register params: COMMAND, COMMON(Y/N), HIDDEN(Y/N), EXT_BLACKLIST, EXT_CONTEXT, LANG, EVENT_COMMAND_ADD
+                        // It relates to the APP, but often tied to a bot logic.
+                        // Wait, imbot.command.register registers a command for the current APPLICATION.
+                        body.COMMAND = this.getNodeParameter('command', i);
+                        body.LANG = Array.isArray(body.LANG) ? body.LANG : [{ LANGUAGE_ID: 'en', TITLE: 'Command' }]; // minimalist default
+                    }
+                    else if (operation === 'answer') {
+                        endpoint = 'imbot.command.answer';
+                        body.COMMAND_ID = this.getNodeParameter('commandId', i);
+                        body.MESSAGE_ID = this.getNodeParameter('messageId', i);
+                        body.MESSAGE = this.getNodeParameter('message', i, '');
+                    }
+                    else if (operation === 'delete') {
+                        endpoint = 'imbot.command.unregister';
+                        body.COMMAND_ID = this.getNodeParameter('commandId', i);
+                    }
+                }
+                else if (resource === 'chat') {
+                    if (operation === 'create') {
+                        endpoint = 'im.chat.add';
+                        body.TITLE = this.getNodeParameter('name', i, '');
+                        body.DESCRIPTION = this.getNodeParameter('description', i, '');
+                    }
+                    else if (operation === 'addUser') {
+                        endpoint = 'im.chat.user.add';
+                        body.CHAT_ID = this.getNodeParameter('chatId', i);
+                        // bitrix expects USERS array
+                        const userId = this.getNodeParameter('userId', i);
+                        body.USERS = [userId];
+                    }
+                    else if (operation === 'getUsers') {
+                        endpoint = 'im.chat.user.list';
+                        body.CHAT_ID = this.getNodeParameter('chatId', i);
+                    }
+                }
+                else if (resource === 'notification') {
+                    if (operation === 'send') {
+                        endpoint = 'im.notify.system.add';
+                        body.USER_ID = this.getNodeParameter('userId', i);
+                        body.MESSAGE = this.getNodeParameter('message', i);
+                    }
+                }
+                const response = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', endpoint, body, {}, overrideAuth);
+                let result = response.result;
+                if (result === undefined)
+                    result = { success: true }; // Sometimes void methods return nothing
+                if (Array.isArray(result)) {
+                    result.forEach((item) => returnData.push({ json: item, pairedItem: { item: i } }));
+                }
+                else {
+                    returnData.push({ json: result, pairedItem: { item: i } });
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message }, pairedItem: { item: i } });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Bitrix24ChatBot = Bitrix24ChatBot;