View as Markdown
Telegram icon

Telegram ACTION

Send an Audio File

Sends an audio 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 an Audio File 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-audio-file",
  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 an Audio File 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 audio caption.
Optional
filename File Name string
Enter a filename.
Optional
audio Audio 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
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
duration Duration integer
Enter duration of sent audio in seconds.
Optional
performer Performer string
Enter a performer.
Optional
title Title string
Enter a track name.
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
contentType Content Type string
Select or enter the MIME type of data.
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-audio-file
Version
0.0.9
App
Telegram
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes