join_chat()

async Client.join_chat()

Join a group chat or channel.

Usable by Users Bots

Parameters:

chat_id (int | str) – Unique identifier for the target chat in form of a t.me/joinchat/ link, a username of the target channel/supergroup (in the format @username) or a chat id of a linked chat (channel or supergroup).

Returns:

Chat | ChatJoinResult – On success, a chat object is returned. When a guard bot has to approve the join first, a ChatJoinResultGuardBotApprovalRequired is returned instead.

Example

# Join chat via invite link
await app.join_chat("https://t.me/+AbCdEf0123456789")

# Join chat via username
await app.join_chat("pyrogram")

# Join a linked chat
await app.join_chat(app.get_chat("pyrogram").linked_chat.id)