@catalogicus-international/n8n-nodes-telegram-advance 0.2.5 → 0.2.6

package/README.md

@@ -144,6 +144,14 @@ The trigger shares the same per-bot update stream as waiting questions. This
 lets one bot receive ordinary updates while also handling Telegram Advance
 approval, choice, and reply waits.
 
+### Telegram Advance AI Webhook
+
+Use this node when an n8n AI Agent should call Telegram as a tool while answers
+arrive through Telegram webhooks. It exposes the same send and send-and-wait
+surface as `Telegram Advance Webhook`, declares `usableAsTool`, and relies on an
+active `Telegram Advance Webhook Trigger` on the same bot to deliver button
+presses and free-text replies to the waiting execution.
+
 ## Setup
 
 1. Create a bot with [BotFather](https://t.me/BotFather) and copy its token.

package/dist/nodes/TelegramAdvanceAiWebhook/TelegramAdvanceAiWebhook.node.d.ts

@@ -0,0 +1,10 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class TelegramAdvanceAiWebhook implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        credentialTest: {
+            telegramAdvanceApiCredentialTest: import("n8n-workflow").ICredentialTestFunction;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/TelegramAdvanceAiWebhook/TelegramAdvanceAiWebhook.node.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramAdvanceAiWebhook = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const actionShared_1 = require("../actionShared");
+const credentialTest_1 = require("../credentialTest");
+class TelegramAdvanceAiWebhook {
+    constructor() {
+        this.description = {
+            displayName: 'Telegram Advance AI Webhook',
+            name: 'telegramAdvanceAiWebhook',
+            icon: 'file:../../icons/telegram.svg',
+            group: ['output'],
+            version: 1,
+            subtitle: '={{ $parameter["operation"] === "sendAndWait" ? $parameter["responseType"] : "send message" }}',
+            description: 'AI Agent-ready Telegram webhook node for sending messages or waiting for in-chat responses',
+            defaults: {
+                name: 'Telegram Advance AI Webhook',
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [
+                {
+                    name: 'telegramAdvanceApi',
+                    required: true,
+                    testedBy: 'telegramAdvanceApiCredentialTest',
+                },
+            ],
+            properties: (0, actionShared_1.buildActionProperties)({
+                displayName: 'AI Agent Webhook Wait',
+                name: 'waitNotice',
+                type: 'notice',
+                default: '',
+                description: 'This AI Agent-ready node sends the question and waits for an in-chat answer delivered through an active Telegram Advance Webhook Trigger on the same bot. It keeps Telegram webhooks enabled, so do not run long polling for this bot at the same time. In n8n queue mode, configure Redis in the credentials so webhook answers can reach the waiting execution across workers.',
+                displayOptions: { show: { operation: ['sendAndWait'] } },
+            }),
+        };
+        this.methods = {
+            credentialTest: {
+                telegramAdvanceApiCredentialTest: credentialTest_1.testTelegramAdvanceCredential,
+            },
+        };
+    }
+    async execute() {
+        return (0, actionShared_1.runAction)(this, 'webhook');
+    }
+}
+exports.TelegramAdvanceAiWebhook = TelegramAdvanceAiWebhook;
+//# sourceMappingURL=TelegramAdvanceAiWebhook.node.js.map

package/dist/nodes/TelegramAdvanceAiWebhook/TelegramAdvanceAiWebhook.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramAdvanceAiWebhook.node.js","sourceRoot":"","sources":["../../../nodes/TelegramAdvanceAiWebhook/TelegramAdvanceAiWebhook.node.ts"],"names":[],"mappings":";;;AAMA,+CAAmD;AACnD,kDAAmE;AACnE,sDAAkE;AAElE,MAAa,wBAAwB;IAArC;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,6BAA6B;YAC1C,IAAI,EAAE,0BAA0B;YAChC,IAAI,EAAE,+BAA+B;YACrC,KAAK,EAAE,CAAC,QAAQ,CAAC;YACjB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,gGAAgG;YAC1G,WAAW,EACV,4FAA4F;YAC7F,QAAQ,EAAE;gBACT,IAAI,EAAE,6BAA6B;aACnC;YACD,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE;gBACZ;oBACC,IAAI,EAAE,oBAAoB;oBAC1B,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,kCAAkC;iBAC5C;aACD;YACD,UAAU,EAAE,IAAA,oCAAqB,EAAC;gBACjC,WAAW,EAAE,uBAAuB;gBACpC,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EACV,kXAAkX;gBACnX,cAAc,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE;aACxD,CAAC;SACF,CAAC;QAEF,YAAO,GAAG;YACT,cAAc,EAAE;gBACf,gCAAgC,EAAE,8CAA6B;aAC/D;SACD,CAAC;IAOH,CAAC;IAHA,KAAK,CAAC,OAAO;QACZ,OAAO,IAAA,wBAAS,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;CACD;AA7CD,4DA6CC"}

package/dist/nodes/TelegramAdvanceAiWebhook/TelegramAdvanceAiWebhook.node.json

@@ -0,0 +1,23 @@
+{
+    "node": "@catalogicus-international/n8n-nodes-telegram-advance.telegramAdvanceAiWebhook",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["Communication", "HITL"],
+    "subcategories": {
+        "AI": ["Tools"],
+        "HITL": ["Human in the Loop"]
+    },
+    "alias": ["telegram", "approval", "choice", "wait", "human", "product", "webhook", "ai", "agent", "tool"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://core.telegram.org/bots/features#creating-a-new-bot"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/catalogicus-international/n8n-nodes-telegram-advance#readme"
+            }
+        ]
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catalogicus-international/n8n-nodes-telegram-advance",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Native Telegram approval, choice, and reply workflows for n8n without external response pages",
   "license": "MIT",
   "packageManager": "pnpm@9.15.0",
@@ -47,6 +47,7 @@
       "dist/nodes/TelegramAdvance/TelegramAdvance.node.js",
       "dist/nodes/TelegramAdvanceTrigger/TelegramAdvanceTrigger.node.js",
       "dist/nodes/TelegramAdvanceWebhook/TelegramAdvanceWebhook.node.js",
+      "dist/nodes/TelegramAdvanceAiWebhook/TelegramAdvanceAiWebhook.node.js",
       "dist/nodes/TelegramAdvanceWebhookTrigger/TelegramAdvanceWebhookTrigger.node.js"
     ]
   },