View as Markdown
Telegram icon

Telegram ACTION

Send a Video

Sends a video file 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 Video 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-video",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    telegram_bot_api: { authProvisionId: "apn_xxxxxxx" },
    chatId: "Chat ID",
    caption: "Caption",
  },
})

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 Video 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
caption Caption string
Enter the video caption.
Optional
filename File Name string
Enter a filename.
Optional
video Video string
File to send. Pass a file_id to send a file that exists on the Telegram servers, pass an HTTP URL for Telegram to get a file from the Internet, or pass the path to the file (e.g., /tmp/myFile.ext) to upload a new one using a file downloaded to /tmp. File must meet Telegram's requirements for MIME type and size.
Required
contentType Content Type string
Select or enter the MIME type of data.
Optional
duration Duration integer
Enter duration of sent video in seconds.
Optional
width Width integer
Enter the video width.
Optional
height Height integer
Enter the video height.
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-video
Version
0.0.9
App
Telegram
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes