telegram.ChatJoinRequest

class telegram.ChatJoinRequest(chat, from_user, date, bio=None, invite_link=None, bot=None, **_kwargs)

Bases: telegram.base.TelegramObject

This object represents a join request sent to a chat.

Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their chat, from_user and date are equal.

Note

Since Bot API 5.5, bots are allowed to contact users who sent a join request to a chat where the bot is an administrator with the can_invite_users administrator right – even if the user never interacted with the bot before.

New in version 13.8.

Parameters
  • chat (telegram.Chat) – Chat to which the request was sent.

  • from_user (telegram.User) – User that sent the join request.

  • date (datetime.datetime) – Date the request was sent.

  • bio (str, optional) – Bio of the user.

  • invite_link (telegram.ChatInviteLink, optional) – Chat invite link that was used by the user to send the join request.

  • bot (telegram.Bot, optional) – The Bot to use for instance methods.

chat

Chat to which the request was sent.

Type

telegram.Chat

from_user

User that sent the join request.

Type

telegram.User

date

Date the request was sent.

Type

datetime.datetime

bio

Optional. Bio of the user.

Type

str

Optional. Chat invite link that was used by the user to send the join request.

Type

telegram.ChatInviteLink

approve(timeout=None, api_kwargs=None)

Shortcut for:

bot.approve_chat_join_request(chat_id=update.effective_chat.id,
user_id=update.effective_user.id, *args, **kwargs)

For the documentation of the arguments, please see telegram.Bot.approve_chat_join_request().

Returns

On success, True is returned.

Return type

bool

classmethod de_json(data, bot)

See telegram.TelegramObject.de_json().

decline(timeout=None, api_kwargs=None)

Shortcut for:

bot.decline_chat_join_request(chat_id=update.effective_chat.id,
user_id=update.effective_user.id, *args, **kwargs)

For the documentation of the arguments, please see telegram.Bot.decline_chat_join_request().

Returns

On success, True is returned.

Return type

bool

to_dict()

See telegram.TelegramObject.to_dict().