View as Markdown
Telegram icon

Telegram ACTION

Send a Text Message or Reply

Sends a text message or a reply to your Telegram Desktop application. See the docs for more information
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Telegram account once, then configure and run Send a Text Message or Reply from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "telegram_bot_api-send-text-message-or-reply",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    telegram_bot_api: { authProvisionId: "apn_xxxxxxx" },
    chatId: "Chat ID",
    text: "Text",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Send a Text Message or Reply inputs
Property Type Description
chatId Chat ID string
Enter the unique identifier for the target chat (e.g. 1035597319) or username of the target public chat (in the format @channelusername or @supergroupusername). For example, if the group's public link is t.me/mygroup, the username is @mygroup.
Required
text Text string
Enter or map the message text to send.
Optional
parse_mode Parse Mode string
Select MarkdownV2-style, HTML-style, or Markdown-style of the text if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message.
Optional
disable_notification Disable Notifications boolean
Choose if to send the message silently. iOS users will not receive a notification, Android users will receive a notification with no sound.
Optional
link_preview_options Link Preview Options string
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
reply_to_message_id Original Message ID string
Enter the ID of the original message.
Optional
reply_markup Reply Markup string
Enter additional interface options that are a JSON-serialized object including an inline keyboard, a custom reply keyboard, instructions to remove the reply keyboard or instructions to force a reply from the user, e.g. {"inline_keyboard":[[{"text":"Some button text 2","url":"https://botpress.org"}]]} or {"keyboard":[["Yes","No"],["Maybe"]]}. Note: keyboard cannot be used with channels. See the docs for more information.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
telegram_bot_api-send-text-message-or-reply
Version
0.0.8
App
Telegram
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes