View as Markdown
Telegram icon

Telegram ACTION

Send an Album (Media Group)

Sends a group of photos or videos as an album. 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 an Album (Media Group) 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-album",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    telegram_bot_api: { authProvisionId: "apn_xxxxxxx" },
    chatId: "Chat ID",
    media: "Media",
  },
})

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 an Album (Media Group) 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
media Media any
A JSON-serialized array describing photos and videos to be sent, must include 2–10 items (e.g., [{"type":"photo","media":"https://example.com/myImage.jpeg"},{"type":"video","media":"/tmp/myVideo.mp4"}]). See the docs for more information about the input media object.
Required
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

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-album
Version
0.0.9
App
Telegram
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes