View as Markdown
Telegram icon

Telegram ACTION

Set Chat Permissions

Set default chat permissions for all members. See the docs for more information
  • Action
  • Writes data
  • Destructive
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Telegram account once, then configure and run Set Chat Permissions 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-set-chat-permissions",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    telegram_bot_api: { authProvisionId: "apn_xxxxxxx" },
    chatId: "Chat ID",
    canSendMessages: true,
  },
})

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.

Set Chat Permissions 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
canSendMessages Send text messages boolean
If the user is allowed to send text messages, contacts, locations and venues
Optional
canSendMediaMessages Send media messages boolean
If the user is allowed to send audios, documents, photos, videos, video notes and voice notes
Optional
canSendPolls Send polls boolean
If the user is allowed to send polls
Optional
canSendOtherMessages Send other messages boolean
If the user is allowed to send animations, games, stickers and use inline bots
Optional
canAddWebPagePreviews Add web page previews boolean
If the user is allowed to add web page previews to their messages
Optional
canChangeInfo Change info boolean
If the user is allowed to change the chat title, photo and other settings. Ignored in public SuperGroups
Optional
canInviteUsers Send invite users boolean
If the user is allowed to invite new users to the chat
Optional
canPinMessages Pin messages boolean
If the user is allowed to pin messages. Ignored in public SuperGroups
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-set-chat-permissions
Version
0.0.8
App
Telegram
Authentication
API key
Read-only
No
Destructive
Yes
Open world
Yes