@pipedream/telegram_bot_api 0.3.10 → 0.3.12

package/README.md

@@ -1,12 +1,11 @@
 # Overview
 
-With the Telegram Bot API, you can build bots that perform a variety of tasks,
-including:
-
-- Sending and receiving messages
-- Social networking
-- Content management
-- File sharing
-- Location sharing
-- Bot administration
-- And more!
+The Telegram Bot API allows you to build bots that can interact with users on the Telegram platform. Using Pipedream, you can automate messaging, handle commands, and trigger actions based on conversations or alerts. Pipedream's serverless execution model enables you to create complex workflows involving Telegram messages without managing any infrastructure. With Pipedream's integration, you can process inbound messages, send outbound notifications, and connect the Telegram Bot API with numerous other services to create powerful automation solutions.
+
+# Example Use Cases
+
+- **Customer Support Ticketing**: Automate the creation of customer support tickets from Telegram messages. When a user sends a support request to your Telegram bot, Pipedream can capture the message and create a ticket in a service like Zendesk or Jira, assigning it to the appropriate team and sending a confirmation message back to the user.
+
+- **Content Distribution Network**: Use your Telegram bot to distribute content automatically. Pipedream can listen for new posts or updates from your CMS, such as WordPress, and then push that content to a Telegram channel or chat. This workflow is useful for bloggers, news agencies, or anyone wanting to keep their audience informed in real-time.
+
+- **E-commerce Order Notifications**: Send order updates or confirmations to customers via Telegram. When a new order is placed on your e-commerce platform, like Shopify, Pipedream can trigger a workflow that sends a personalized message to the customer's Telegram account, providing them peace of mind and enhancing the overall shopping experience.

package/actions/create-chat-invite-link/create-chat-invite-link.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-create-chat-invite-link",
   name: "Create Chat Invite Link",
   description: "Create an additional invite link for a chat, [See the docs](https://core.telegram.org/bots/api#createchatinvitelink) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/delete-message/delete-message.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-delete-message",
   name: "Delete a Message",
   description: "Deletes a message. [See the docs](https://core.telegram.org/bots/api#deletemessage) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/edit-media-message/edit-media-message.mjs

@@ -8,7 +8,7 @@ export default {
   key: "telegram_bot_api-edit-media-message",
   name: "Edit a Media Message",
   description: "Edits photo or video messages. [See the docs](https://core.telegram.org/bots/api#editmessagemedia) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/edit-text-message/edit-text-message.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-edit-text-message",
   name: "Edit a Text Message",
   description: "Edits text or game messages. [See the docs](https://core.telegram.org/bots/api#editmessagetext) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/export-chat-invite-link/export-chat-invite-link.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-export-chat-invite-link",
   name: "Export Chat Invite Link",
   description: "Generate a new primary invite link for a chat, [See the docs](https://core.telegram.org/bots/api#createchatinvitelink) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/forward-message/forward-message.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-forward-message",
   name: "Forward a Message",
   description: "Forwards messages of any kind. [See the docs](https://core.telegram.org/bots/api#forwardmessage) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/get-num-members-in-chat/get-num-members-in-chat.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-get-num-members-in-chat",
   name: "Get the Number of Members in a Chat",
   description: "Use this module to get the number of members in a chat. [See the docs](https://core.telegram.org/bots/api#getchatmembercount) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/kick-chat-member/kick-chat-member.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-kick-chat-member",
   name: "Kick a Chat Member",
   description: "Use this method to kick a user from a group, a supergroup or channel. [See the docs](https://core.telegram.org/bots/api#banchatmember) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/list-administrators-in-chat/list-administrators-in-chat.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-list-administrators-in-chat",
   name: "List Administrators In Chat",
   description: "Use this module to get a list of administrators in a chat. [See the docs](https://core.telegram.org/bots/api#getchatadministrators) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/list-chats/list-chats.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-list-chats",
   name: "List Chats",
   description: "List available Telegram chats. [See the docs](https://core.telegram.org/bots/api#getupdates) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/list-updates/list-updates.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-list-updates",
   name: "List Updates",
   description: "Retrieves a list of updates from the Telegram server. [See the docs](https://core.telegram.org/bots/api#getupdates) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/pin-message/pin-message.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-pin-message",
   name: "Pin a Message",
   description: "Pins a message. [See the docs](https://core.telegram.org/bots/api#pinchatmessage) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/promote-chat-member/promote-chat-member.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-promote-chat-member",
   name: "Promote a Chat Member",
   description: "Use this method to promote or demote a user in a supergroup or a channel. [See the docs](https://core.telegram.org/bots/api#promotechatmember) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/restrict-chat-member/restrict-chat-member.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-restrict-chat-member",
   name: "Restrict a Chat Member",
   description: "Use this method to restrict a user in a supergroup. [See the docs](https://core.telegram.org/bots/api#restrictchatmember) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-album/send-album.mjs

@@ -5,7 +5,7 @@ export default {
   key: "telegram_bot_api-send-album",
   name: "Send an Album (Media Group)",
   description: "Sends a group of photos or videos as an album. [See the docs](https://core.telegram.org/bots/api#sendmediagroup) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-audio-file/send-audio-file.mjs

@@ -5,7 +5,7 @@ export default {
   key: "telegram_bot_api-send-audio-file",
   name: "Send an Audio File",
   description: "Sends an audio file to your Telegram Desktop application. [See the docs](https://core.telegram.org/bots/api#sendaudio) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-document-or-image/send-document-or-image.mjs

@@ -5,7 +5,7 @@ export default {
   key: "telegram_bot_api-send-document-or-image",
   name: "Send a Document/Image",
   description: "Sends a document or an image to your Telegram Desktop application. [See the docs](https://core.telegram.org/bots/api#senddocument) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-media-by-url-or-id/send-media-by-url-or-id.mjs

@@ -5,7 +5,7 @@ export default {
   key: "telegram_bot_api-send-media-by-url-or-id",
   name: "Send Media by URL or ID",
   description: "Sends a file (document, photo, video, audio, ...) by HTTP URL or by ID that exists on the Telegram servers. [See the docs](https://core.telegram.org/bots/api#inputmedia) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-photo/send-photo.mjs

@@ -5,7 +5,7 @@ export default {
   key: "telegram_bot_api-send-photo",
   name: "Send a Photo",
   description: "Sends a photo to your Telegram Desktop application. [See the docs](https://core.telegram.org/bots/api#sendphoto) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-sticker/send-sticker.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-send-sticker",
   name: "Send a Sticker",
   description: "Sends a .webp sticker to you Telegram Desktop application. [See the docs](https://core.telegram.org/bots/api#sendsticker) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-text-message-or-reply/send-text-message-or-reply.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-send-text-message-or-reply",
   name: "Send a Text Message or Reply",
   description: "Sends a text message or a reply to your Telegram Desktop application. [See the docs](https://core.telegram.org/bots/api#sendmessage) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,
@@ -32,10 +32,10 @@ export default {
         "disable_notification",
       ],
     },
-    disable_web_page_preview: {
+    link_preview_options: {
       propDefinition: [
         telegramBotApi,
-        "disable_web_page_preview",
+        "link_preview_options",
       ],
     },
     reply_to_message_id: {
@@ -55,7 +55,7 @@ export default {
     const resp = await this.telegramBotApi.sendMessage(this.chatId, this.text, {
       parse_mode: this.parse_mode,
       disable_notification: this.disable_notification,
-      disable_web_page_preview: this.disable_web_page_preview,
+      link_preview_options: this.link_preview_options,
       reply_to_message_id: this.reply_to_message_id,
       reply_markup: this.reply_markup,
     });

package/actions/send-video/send-video.mjs

@@ -5,7 +5,7 @@ export default {
   key: "telegram_bot_api-send-video",
   name: "Send a Video",
   description: "Sends a video file to your Telegram Desktop application. [See the docs](https://core.telegram.org/bots/api#sendvideo) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-video-note/send-video-note.mjs

@@ -5,7 +5,7 @@ export default {
   key: "telegram_bot_api-send-video-note",
   name: "Send a Video Note",
   description: "As of v.4.0, Telegram clients support rounded square mp4 videos of up to 1 minute long. Use this method to send video messages. [See the docs](https://core.telegram.org/bots/api#sendvideonote) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/send-voice-message/send-voice-message.mjs

@@ -5,7 +5,7 @@ export default {
   key: "telegram_bot_api-send-voice-message",
   name: "Send a Voice Message",
   description: "Sends a voice message. [See the docs](https://core.telegram.org/bots/api#sendvoice) for more information",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     telegramBotApi,

package/actions/set-chat-permissions/set-chat-permissions.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-set-chat-permissions",
   name: "Set Chat Permissions",
   description: "Set default chat permissions for all members. [See the docs](https://core.telegram.org/bots/api#setchatpermissions) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/actions/unpin-message/unpin-message.mjs

@@ -4,7 +4,7 @@ export default {
   key: "telegram_bot_api-unpin-message",
   name: "Unpin a Message",
   description: "Unpins a message. [See the docs](https://core.telegram.org/bots/api#unpinchatmessage) for more information",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   props: {
     telegramBotApi,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/telegram_bot_api",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "Pipedream Telegram_bot_api Components",
   "main": "telegram_bot_api.app.mjs",
   "keywords": [
@@ -10,7 +10,7 @@
   "homepage": "https://pipedream.com/apps/telegram_bot_api",
   "author": "Pipedream <support@pipedream.com> (https://pipedream.com/)",
   "dependencies": {
-    "@pipedream/platform": "^0.9.0",
+    "@pipedream/platform": "^3.0.3",
     "node-telegram-bot-api": "^0.54.0",
     "uuid": "^8.3.2"
   },

package/sources/channel-updates/channel-updates.mjs

@@ -6,7 +6,7 @@ export default {
   key: "telegram_bot_api-channel-updates",
   name: "New Channel Updates (Instant)",
   description: "Emit new event each time a channel post is created or updated.",
-  version: "0.1.4",
+  version: "0.1.5",
 
   type: "source",
   dedupe: "unique",

package/sources/message-updates/message-updates.mjs

@@ -1,15 +1,42 @@
 import base from "../common/webhooks.mjs";
+import sampleEmit from "./test-event.mjs";
 
 export default {
   ...base,
   key: "telegram_bot_api-message-updates",
   name: "New Message Updates (Instant)",
   description: "Emit new event each time a Telegram message is created or updated.",
-  version: "0.1.3",
+  version: "0.1.6",
   type: "source",
   dedupe: "unique",
+  props: {
+    ...base.props,
+    chatId: {
+      propDefinition: [
+        base.props.telegramBotApi,
+        "chatId",
+      ],
+      optional: true,
+    },
+  },
+  hooks: {
+    ...base.hooks,
+    async deploy() {
+      if (this.chatId) {
+        const { id } = await this.telegramBotApi.sdk().getChat(this.chatId);
+        this._setChatId(id);
+      }
+      await base.hooks.deploy.call(this);
+    },
+  },
   methods: {
     ...base.methods,
+    _getChatId() {
+      return this.db.get("chatId");
+    },
+    _setChatId(chatId) {
+      this.db.set("chatId", chatId);
+    },
     getMeta(event, message) {
       return {
         id: event.update_id,
@@ -25,7 +52,14 @@ export default {
     },
     processEvent(event) {
       const message = event.edited_message ?? event.message;
+      if (this.chatId) {
+        const chatId = this._getChatId();
+        if (chatId && chatId != message?.chat?.id) {
+          return;
+        }
+      }
       this.$emit(event, this.getMeta(event, message));
     },
   },
+  sampleEmit,
 };

package/sources/message-updates/test-event.mjs

@@ -0,0 +1,23 @@
+export default  {
+  "update_id": 385937742,
+  "message": {
+   "message_id": 45,
+   "from": {
+    "id": 762444944,
+    "is_bot": false,
+    "first_name": "James",
+    "last_name": "Smith",
+    "username": "smithjames",
+    "language_code": "fr"
+   },
+   "chat": {
+    "id": 762444944,
+    "first_name": "James",
+    "last_name": "Smith",
+    "username": "smithjames",
+    "type": "private"
+   },
+   "date": 1787956925,
+   "text": "What's happening?"
+  }
+ }

package/sources/new-bot-command-received/new-bot-command-received.mjs

@@ -1,11 +1,12 @@
 import base from "../common/webhooks.mjs";
+import sampleEmit from "./test-event.mjs";
 
 export default {
   ...base,
   key: "telegram_bot_api-new-bot-command-received",
   name: "New Bot Command Received (Instant)",
   description: "Emit new event each time a Telegram Bot command is received.",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "source",
   dedupe: "unique",
   props: {
@@ -55,4 +56,5 @@ export default {
       this.$emit(event, this.getMeta(event, message));
     },
   },
+  sampleEmit,
 };

package/sources/new-bot-command-received/test-event.mjs

@@ -0,0 +1,30 @@
+export default  {
+  "update_id": 999999999,
+  "message": {
+   "message_id": 99,
+   "from": {
+    "id": 100000000,
+    "is_bot": false,
+    "first_name": "John",
+    "last_name": "Doe",
+    "username": "johndoe",
+    "language_code": "en"
+   },
+   "chat": {
+    "id": 100000000,
+    "first_name": "John",
+    "last_name": "Doe",
+    "username": "johndoe",
+    "type": "private"
+   },
+   "date": 2000000000,
+   "text": "/test",
+   "entities": [
+    {
+     "offset": 0,
+     "length": 5,
+     "type": "bot_command"
+    }
+   ]
+  }
+ }

package/sources/new-updates/new-updates.mjs

@@ -1,11 +1,12 @@
 import base from "../common/webhooks.mjs";
+import sampleEmit from "./test-event.mjs";
 
 export default {
   ...base,
   key: "telegram_bot_api-new-updates",
   name: "New Updates (Instant)",
   description: "Emit new event for each new Telegram event.",
-  version: "0.1.3",
+  version: "0.1.5",
   type: "source",
   dedupe: "unique",
   props: {
@@ -41,4 +42,5 @@ export default {
       this.$emit(event, this.getMeta(event));
     },
   },
+  sampleEmit,
 };

package/sources/new-updates/test-event.mjs

@@ -0,0 +1,23 @@
+export default  {
+  "update_id": 548364579,
+  "message": {
+   "message_id": 74,
+   "from": {
+    "id": 364712354,
+    "is_bot": false,
+    "first_name": "John",
+    "last_name": "Doe",
+    "username": "johndoe123",
+    "language_code": "en"
+   },
+   "chat": {
+    "id": 364712354,
+    "first_name": "John",
+    "last_name": "Doe",
+    "username": "johndoe123",
+    "type": "private"
+   },
+   "date": 1789758645,
+   "text": "Haha what is up?"
+  }
+ }

package/telegram_bot_api.app.mjs

@@ -62,10 +62,13 @@ export default {
       `),
       optional: true,
     },
-    disable_web_page_preview: {
-      type: "boolean",
-      label: "Disable Link Previews",
-      description: "Choose if to disable link previews for links in this message.",
+    link_preview_options: {
+      type: "string",
+      label: "Link Preview Options",
+      description: toSingleLineString(`
+        Link preview generation options for the message. Enter additional interface options that are a JSON-serialized object, 
+        e.g. \`{"is_disabled":false,"url":"https://botpress.org","prefer_small_media":true,"prefer_large_media":false,"show_above_text":false}\`
+      `),
       optional: true,
     },
     reply_to_message_id: {