botnest
Documentation
Guide

Telegram chat settings and invites

Appearance, default permissions, invites and chat details.

What these blocks change

These are group or channel settings, not the bot's profile. The bot needs access to the target chat and the required permissions.

  • Reading details changes nothing.
  • Permission changes affect members.
  • Revoking a link prevents joins through that link.
  • Leaving a chat removes the bot itself.

Do not accept an arbitrary chat ID from user input without checking access.

Telegram connections and permissions →

Set chat permissions

Changes the chat's default member permissions.

  1. Set the chat and allowed actions, such as sending messages or media.
  2. This changes shared chat rules. Use Restrict member for one person.

Replace primary invite link

Creates a new primary invite link, replacing the bot's previous primary link.

  1. Set the chat and keep the new link from the result.
  2. The previous primary link is revoked. Use Create invite link for an additional link without replacing the primary one.

Create invite link

Creates an additional invite link.

  1. Set the chat and optionally a name, expiry, member limit or join approval requirement.
  2. Keep the returned link to send it to the user. Check that your selected restrictions are compatible.

Edit invite link

Changes settings on the bot's invite link.

  1. Set the chat, existing link and new restrictions.
  2. A link created by another administrator may not be editable.

Create subscription invite

Creates a paid subscription invite link where the chat supports this entry method.

  1. Set the chat, price, subscription period and an optional link name.
  2. Check Telegram's requirements and permissions before sharing the link. This is not a botnest plan.

Edit subscription invite

Changes the editable settings of an existing subscription invite.

  1. Set the chat, link and new name.
  2. This action cannot change every subscription term. Use the fields available in the block.

Revoke invite link

Revokes an invite link to prevent further joins through it.

  1. Set the chat and exact link.
  2. People who already joined remain members. Removing them is a separate action.

Set chat photo

Sets a chat photo.

  1. Set the chat and the Telegram file_id of a suitable image.
  2. This changes the group or channel photo, not the bot's avatar. An ordinary image URL is not a file_id.

Delete chat photo

Removes the chat's current photo.

  1. Set the chat and check the bot's permission to change its appearance.
  2. The bot's own avatar is not affected.

Set chat title

Changes a group or channel title.

  1. Set the chat and new title.
  2. This is not the bot's name. Test the title in a test chat before broad use.

Set chat description

Changes a chat's description.

  1. Set the chat and new description text.
  2. Keep it concise and check the bot's permission to change chat information.

Set chat sticker set

Assigns a sticker set to a chat.

  1. Set the chat and sticker set name.
  2. Check that the chat supports this setting and the bot can change it.

Remove chat sticker set

Removes a chat's assigned sticker set.

  1. Set the chat and check the bot's permissions.
  2. The sticker set itself is not deleted; only its assignment to the chat is removed.

Get chat

Gets information about a chat.

  1. Supply an accessible chat ID and a result name.
  2. Use the returned fields in conditions and text. This reads chat details, not message history.

Get chat administrators

Gets a list of chat administrators.

  1. Set the chat; configure whether bots are included if needed.
  2. The result is a list. Use a loop to act on each administrator.

Get member count

Gets the number of members in a chat.

  1. Set the chat and result name.
  2. This is a count, not a user list. Compare it in a condition or insert it into a message.

Leave chat

Makes the bot leave a chat.

  1. Set the exact chat. Connect this action only after an explicit check or confirmation.
  2. After leaving, the bot cannot operate normally in that chat until it is added again.