Send an Album (Media Group) with Telegram API

Pipedream makes it easy to connect APIs for Telegram and 2,500+ other apps remarkably fast.

Trigger workflow on

HTTP requests, schedules and app events

Next, do this

Send an Album (Media Group) with the Telegram API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

Create a workflow to Send an Album (Media Group) with the Telegram API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Send an Album (Media Group) action
1. Connect your Telegram account
2. Configure Chat ID
3. Configure Media
4. Optional- Configure Disable Notifications
Select a trigger to run your workflow on HTTP requests, schedules or app events
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Integrations#

Send an Album (Media Group) with Telegram API on New Requests (Payload Only) from HTTP / Webhook API

HTTP / Webhook + Telegram

Try it

Send an Album (Media Group) with Telegram API on New Item in Feed from RSS API

RSS + Telegram

Try it

Send an Album (Media Group) with Telegram API on New Message (Instant) from Discord API

Discord + Telegram

Try it

Send an Album (Media Group) with Telegram API on New Message In Channels (Instant) from Slack API

Slack + Telegram

Try it

Send an Album (Media Group) with Telegram API on New Message in Channel from Discord Bot API

Discord Bot + Telegram

Try it

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Send an Album (Media Group) on Telegram

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.6

Key:telegram_bot_api-send-album

View on GitHub

Code#

import telegramBotApi from "../../telegram_bot_api.app.mjs";
import { toSingleLineString } from "../../common/utils.mjs";

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.6",
  type: "action",
  props: {
    telegramBotApi,
    chatId: {
      propDefinition: [
        telegramBotApi,
        "chatId",
      ],
    },
    media: {
      type: "any",
      label: "Media",
      description: toSingleLineString(`
        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](https://core.telegram.org/bots/api#inputmedia) for more information about the
        input media object.
      `),
      optional: false,
    },
    disable_notification: {
      propDefinition: [
        telegramBotApi,
        "disable_notification",
      ],
    },
  },
  async run({ $ }) {
    let media = this.media;
    if (typeof media === "string") {
      try {
        media = JSON.parse(media);
      } catch (err) {
        throw new Error("media must be deserializable to JSON");
      }
    }
    const resp = await this.telegramBotApi.sendMediaGroup(this.chatId, media, {
      disable_notification: this.disable_notification,
    });
    // eslint-disable-next-line multiline-ternary
    $.export("$summary", `Successfully sent an album of ${resp.length} media file${resp.length === 1 ? "" : "s"} to chat, "${this.chatId}"`);
    return resp;
  },
};

Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Telegram	`telegramBotApi`	`app`	This component uses the Telegram app.
Chat ID	`chatId`	`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`.
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.
Disable Notifications	`disable_notification`	`boolean`	Choose if to send the message silently. iOS users will not receive a notification, Android users will receive a notification with no sound.