From 60a184b8d475cad0f5ad58bb7f3a53dcf2deef64 Mon Sep 17 00:00:00 2001
From: Mayuri-Chan chat_id (Message.copy()
int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
caption (string
, optional) – New caption for media, 0-1024 characters after entities parsing.
If not specified, the original caption is kept.
Pass “” (empty string) to remove the caption.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_thread_id (int
, optional) – Unique identifier of a message thread to which the message belongs; for supergroups only
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
-for reply message in another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/bound-methods/Message.reply_animation.html b/staging/api/bound-methods/Message.reply_animation.html
index 4e98ba8ef..a129dc2a4 100644
--- a/staging/api/bound-methods/Message.reply_animation.html
+++ b/staging/api/bound-methods/Message.reply_animation.html
@@ -1987,8 +1987,9 @@
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
-for reply message in another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/bound-methods/Message.reply_audio.html b/staging/api/bound-methods/Message.reply_audio.html
index 2ce12fe38..9ddb0b1fd 100644
--- a/staging/api/bound-methods/Message.reply_audio.html
+++ b/staging/api/bound-methods/Message.reply_audio.html
@@ -1986,7 +1986,8 @@
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
-for reply message in another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/bound-methods/Message.reply_venue.html b/staging/api/bound-methods/Message.reply_venue.html
index 45650c0b4..27fbdece2 100644
--- a/staging/api/bound-methods/Message.reply_venue.html
+++ b/staging/api/bound-methods/Message.reply_venue.html
@@ -1965,7 +1965,8 @@
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_in_chat_id (int
, optional) – Unique identifier of target chat.
+
reply_in_chat_id – Union[int, str] = None, +Unique identifier of target chat. for reply message in another chat.
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
chat_id (int
| str
) – The group, supergroup or channel id
chat_id (int
| str
) – The group, supergroup or channel id or chat/channel public link
user_ids (int
| str
| List of int
or str
) – Users to add in the chat
You can pass an ID (int), username (str) or phone number (str).
-Multiple users can be added by passing a list of IDs, usernames or phone numbers.
forward_limit (int
, optional) – How many of the latest messages you want to forward to the new members. Pass 0 to forward none of them.
Only applicable to basic groups (the argument is ignored for supergroups or channels).
Defaults to 100 (max amount).
user_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
user_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
+You can also use user profile link in form of t.me/<username> (str).
first_name (str
) – User’s first name.
last_name (str
, optional) – User’s last name.
phone_number (str
, optional) – User’s phone number.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
invite_link (str
, optional) – Pass an invite link to approve only its join requests.
By default, all join requests are approved.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
user_id (int
) – Unique identifier of the target user.
user_id (int
) – Unique identifier of the target user.
+You can also use user profile link in form of t.me/<username> (str).
chat_ids (int
| str
| List[int
, str
]) – Unique identifier (int) or username (str) of the target chat.
-You can also pass a list of ids (int) or usernames (str).
bool
– On success, True is returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
user_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
-For a contact that exists in your Telegram address book you can use his phone number (str).
until_date (datetime
, optional) – Date when the user will be unbanned.
If user is banned for more than 366 days or less than 30 seconds from the current time they are
considered to be banned forever. Defaults to epoch (ban forever).
user_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
For you yourself you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
bool
– True on success
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
topic_id (int
) – Unique identifier (int) of the target forum topic.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
bool – On success, a True is returned.
diff --git a/staging/api/methods/copy_media_group.html b/staging/api/methods/copy_media_group.html index 87a5666e2..fe9395a3d 100644 --- a/staging/api/methods/copy_media_group.html +++ b/staging/api/methods/copy_media_group.html @@ -2213,10 +2213,12 @@chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
from_chat_id (int
| str
) – Unique identifier (int) or username (str) of the source chat where the original media group was sent.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – Message identifier in the chat specified in from_chat_id.
captions (str
| List of str
, optional) – New caption for media, 0-1024 characters after entities parsing for each media.
If not specified, the original caption is kept.
diff --git a/staging/api/methods/copy_message.html b/staging/api/methods/copy_message.html
index c74e18bab..60308e3f1 100644
--- a/staging/api/methods/copy_message.html
+++ b/staging/api/methods/copy_message.html
@@ -2215,10 +2215,12 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
from_chat_id (int
| str
) – Unique identifier (int) or username (str) of the source chat where the original message was sent.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – Message identifier in the chat specified in from_chat_id.
caption (string
, optional) – New caption for media, 0-1024 characters after entities parsing.
If not specified, the original caption is kept.
diff --git a/staging/api/methods/create_chat_invite_link.html b/staging/api/methods/create_chat_invite_link.html
index f365681fc..9c11f63cd 100644
--- a/staging/api/methods/create_chat_invite_link.html
+++ b/staging/api/methods/create_chat_invite_link.html
@@ -1734,7 +1734,8 @@
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
name (str
, optional) – Invite link name.
expire_date (datetime
, optional) – Point in time when the link will expire.
Defaults to None (no expiration date).
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
title (str
) – The forum topic title.
icon_color (int
, optional) – The color of forum topic icon.
icon_emoji_id (int
, optional) – Unique identifier of the custom emoji shown as the topic icon
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
invite_link (str
, optional) – Pass an invite link to decline only its join requests.
By default, all join requests are declined.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
user_id (int
) – Unique identifier of the target user.
user_id (int
) – Unique identifier of the target user.
+You can also use user profile link in form of t.me/<username> (str).
chat_id (int
| str
) – The id of the channel to be deleted.
chat_id (int
| str
) – The id of the channel to be deleted.
+You can also use chat public link in form of t.me/<username> (str).
bool
– On success, True is returned.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
admin_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
For you yourself you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
invite_link (str
) – The revoked invite link to delete.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
bool
– True on success.
user_ids (int
| str
| List of int
or str
) – A single user id/username or a list of user identifiers (id or username).
user_ids (int
| str
| List of int
or str
) – A single user id/username or a list of user identifiers (id or username).
+You can also use user profile link in form of t.me/<username> (str).
User
| List of User
| None
– In case user_ids was an
diff --git a/staging/api/methods/delete_forum_topic.html b/staging/api/methods/delete_forum_topic.html
index b5bf47b24..5b7b78217 100644
--- a/staging/api/methods/delete_forum_topic.html
+++ b/staging/api/methods/delete_forum_topic.html
@@ -2241,7 +2241,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
topic_id (int
) – Unique identifier (int) of the target forum topic.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_ids (int
| Iterable of int
) – An iterable of message identifiers to delete (integers) or a single message id.
revoke (bool
, optional) – Deletes messages on both parts.
This is only for private cloud chats and normal groups, messages on
diff --git a/staging/api/methods/delete_stories.html b/staging/api/methods/delete_stories.html
index 52b1adce0..ae34fc097 100644
--- a/staging/api/methods/delete_stories.html
+++ b/staging/api/methods/delete_stories.html
@@ -1613,7 +1613,8 @@
story_ids (int
| Iterable of int
) – Pass a single story identifier or an iterable of story ids (as integers) to get the content of the
story themselves.
chat_id (int
, optional) – Unique identifier (int) of the target channel.
chat_id (int
, optional) – Unique identifier (int) or username (str) of the target channel.
+You can also use channel public link in form of t.me/<username> (str).
chat_id (int
| str
) – The id of the supergroup to be deleted.
chat_id (int
| str
) – The id of the supergroup to be deleted.
+You can also use chat public link in form of t.me/<username> (str).
bool
– On success, True is returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
user_id (int
| str
) – Unique identifier (int) or username (str) of the user whose messages will be deleted.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
user_id (int
| str
) – Unique identifier (int) or username (str) of the user whose messages will be deleted.
+You can also use user profile link in form of t.me/<username> (str).
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
invite_link (str
) – The invite link to edit
name (str
, optional) – Invite link name.
expire_date (datetime
, optional) – Point in time when the link will expire.
diff --git a/staging/api/methods/edit_forum_topic.html b/staging/api/methods/edit_forum_topic.html
index 052bceb81..f3265bddd 100644
--- a/staging/api/methods/edit_forum_topic.html
+++ b/staging/api/methods/edit_forum_topic.html
@@ -2241,7 +2241,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
topic_id (int
) – Unique identifier (int) of the target forum topic.
title (str
, optional) – The forum topic title.
icon_emoji_id (int
, optional) – Unique identifier of the custom emoji shown as the topic icon
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
title (str
) – The general forum topic title.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – Message identifier in the chat specified in chat_id.
caption (str
) – New caption of the media message.
parse_mode (ParseMode
, optional) – By default, texts are parsed using both Markdown and HTML styles.
diff --git a/staging/api/methods/edit_message_media.html b/staging/api/methods/edit_message_media.html
index 5fb6f0910..aeca23d16 100644
--- a/staging/api/methods/edit_message_media.html
+++ b/staging/api/methods/edit_message_media.html
@@ -2215,7 +2215,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – Message identifier in the chat specified in chat_id.
media (InputMedia
) – One of the InputMedia objects describing an animation, audio, document, photo or video.
reply_markup (InlineKeyboardMarkup
, optional) – An InlineKeyboardMarkup object.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – Message identifier in the chat specified in chat_id.
reply_markup (InlineKeyboardMarkup
, optional) – An InlineKeyboardMarkup object.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – Message identifier in the chat specified in chat_id.
text (str
) – New text of the message.
parse_mode (ParseMode
, optional) – By default, texts are parsed using both Markdown and HTML styles.
diff --git a/staging/api/methods/edit_story.html b/staging/api/methods/edit_story.html
index aff76607c..da952f9ba 100644
--- a/staging/api/methods/edit_story.html
+++ b/staging/api/methods/edit_story.html
@@ -1626,7 +1626,8 @@
story_id (int
) – Unique identifier (int) of the target story.
chat_id (int
, optional) – Unique identifier (int) of the target channel.
chat_id (int
, optional) – Unique identifier (int) of the target channel.
+You can also use channel public link in form of t.me/<username> (str).
animation (str
| BinaryIO
, optional) – New story Animation.
Pass a file_id as string to send a animation that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get a animation from the Internet,
diff --git a/staging/api/methods/export_chat_invite_link.html b/staging/api/methods/export_chat_invite_link.html
index dbf496b99..4927bc434 100644
--- a/staging/api/methods/export_chat_invite_link.html
+++ b/staging/api/methods/export_chat_invite_link.html
@@ -1740,7 +1740,8 @@
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
str
– On success, the new invite link as string is returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target user/channel.
For your personal story you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
story_id (int
) – Pass a single story identifier of story (as integers).
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
from_chat_id (int
| str
) – Unique identifier (int) or username (str) of the source chat where the original message was sent.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_ids (int
| Iterable of int
) – An iterable of message identifiers in the chat specified in from_chat_id or a single message id.
message_thread_id (int
, optional) – Unique identifier of a message thread to which the message belongs.
for supergroups only
from_chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat/user.
For your personal story you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
from_story_id (int
) – Unique identifier of original story.
chat_id (int
, optional) – Unique identifier (int) of the target channel.
-If you want to forward story to a channel.
chat_id (int
| str
, optional) – Unique identifier (int) or username (str) of the target channel.
+If you want to forward story to a channel.
+You can also use channel public link in form of t.me/<username> (str).
privacy (StoriesPrivacyRules
, optional) – Story privacy.
Defaults to PUBLIC
allowed_users (List of int
, optional) – List of user_id whos allowed to view the story.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
-Unique identifier for the target chat in form of a t.me/joinchat/ link, identifier (int) or username
-of the target channel/supergroup (in the format @username).
Chat
| ChatPreview
– On success, if you’ve already joined the chat, a chat object is returned,
diff --git a/staging/api/methods/get_chat_admin_invite_links.html b/staging/api/methods/get_chat_admin_invite_links.html
index 26d76d153..efb9426ff 100644
--- a/staging/api/methods/get_chat_admin_invite_links.html
+++ b/staging/api/methods/get_chat_admin_invite_links.html
@@ -1751,10 +1751,12 @@
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
admin_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
For you yourself you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
revoked (bool
, optional) – True, if you want to get revoked links instead.
Defaults to False (get active links only).
limit (int
, optional) – Limits the number of invite links to be retrieved.
diff --git a/staging/api/methods/get_chat_admin_invite_links_count.html b/staging/api/methods/get_chat_admin_invite_links_count.html
index d679c4109..256491b2f 100644
--- a/staging/api/methods/get_chat_admin_invite_links_count.html
+++ b/staging/api/methods/get_chat_admin_invite_links_count.html
@@ -1732,10 +1732,12 @@
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
admin_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
For you yourself you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
revoked (bool
, optional) – True, if you want to get revoked links instead.
Defaults to False (get active links only).
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
List of ChatAdminWithInviteLink
– On success, the list of admins that have exported
diff --git a/staging/api/methods/get_chat_event_log.html b/staging/api/methods/get_chat_event_log.html
index 9739e40e5..4b72d664a 100644
--- a/staging/api/methods/get_chat_event_log.html
+++ b/staging/api/methods/get_chat_event_log.html
@@ -2243,7 +2243,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
query (str
, optional) – Search query to filter events based on text.
By default, an empty query is applied and all events will be returned.
offset_id (int
, optional) – Offset event identifier from which to start returning results.
diff --git a/staging/api/methods/get_chat_history.html b/staging/api/methods/get_chat_history.html
index a18250d70..2ad5967a3 100644
--- a/staging/api/methods/get_chat_history.html
+++ b/staging/api/methods/get_chat_history.html
@@ -2214,7 +2214,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
limit (int
, optional) – Limits the number of messages to be retrieved.
By default, no limit is applied and all messages are returned.
offset (int
, optional) – Sequential number of the first message to be returned..
diff --git a/staging/api/methods/get_chat_history_count.html b/staging/api/methods/get_chat_history_count.html
index ec93dfa4d..7309eebaa 100644
--- a/staging/api/methods/get_chat_history_count.html
+++ b/staging/api/methods/get_chat_history_count.html
@@ -2216,7 +2216,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
int
– On success, the chat history count is returned.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
invite_link (str) – The invite link.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
invite_link (str) – The invite link.
limit (int
, optional) – Limits the number of invite links to be retrieved.
By default, no limit is applied and all invite links are returned.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
invite_link (str) – The invite link.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
limit (int
, optional) – Limits the number of invite links to be retrieved.
By default, no limit is applied and all invite links are returned.
query (str
, optional) – Query to search for a user.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
user_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
For you yourself you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
query (str
, optional) – Query string to filter members based on their display names and usernames.
Only applicable to supergroups and channels. Defaults to “” (empty string).
A query string is applicable only for SEARCH
,
diff --git a/staging/api/methods/get_chat_members_count.html b/staging/api/methods/get_chat_members_count.html
index 53287e128..da15e5512 100644
--- a/staging/api/methods/get_chat_members_count.html
+++ b/staging/api/methods/get_chat_members_count.html
@@ -2254,7 +2254,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
int
– On success, the chat members count is returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use user profile/chat public link in form of t.me/<username> (str).
If not specified, default bot’s menu button will be returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
int
– On success, the chat members online count is returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
limit (int
, optional) – Limits the number of profile photos to be retrieved.
By default, no limit is applied and all profile photos are returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
int
– On success, the user profile photos count is returned.
user_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
List of Chat
– On success, a list of the common chats is returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
message_id (int
) – Message id.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
message_id (int
) – Message id.
limit (int
, optional) – Limits the number of messages to be retrieved.
By default, no limit is applied and all messages are returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
message_id (int
) – Message id.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
limit (int
, optional) – Limits the number of topics to be retrieved.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
topic_ids (int
| Iterable of int
, optional) – Pass a single topic identifier or an iterable of topic ids (as integers) to get the information of the
topic themselves.
user_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
chat_id (int
| str
, optional) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
For a contact that exists in your Telegram address book you can use his phone number (str).
diff --git a/staging/api/methods/get_inline_bot_results.html b/staging/api/methods/get_inline_bot_results.html
index 815e28287..7722a045e 100644
--- a/staging/api/methods/get_inline_bot_results.html
+++ b/staging/api/methods/get_inline_bot_results.html
@@ -1762,7 +1762,8 @@
bot (int
| str
) – Unique identifier of the inline bot you want to get results from. You can specify
-a @username (str) or a bot ID (int).
query (str
, optional) – Text of the query (up to 512 characters).
Defaults to “” (empty string).
offset (str
, optional) – Offset of the results to be returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – The id of one of the messages that belong to the media group.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_ids (int
| Iterable of int
, optional) – Pass a single message identifier or an iterable of message ids (as integers) to get the content of the
message themselves.
reply_to_message_ids (int
| Iterable of int
, optional) – Pass a single message identifier or an iterable of message ids (as integers) to get the content of
diff --git a/staging/api/methods/get_peer_stories.html b/staging/api/methods/get_peer_stories.html
index 12b271e68..a16f33cc9 100644
--- a/staging/api/methods/get_peer_stories.html
+++ b/staging/api/methods/get_peer_stories.html
@@ -1626,7 +1626,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target user/channel.
For your personal story you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
Generator
– On success, a generator yielding Story
objects is returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
List[Chat
] – The list of chats.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target user/channel.
For your personal story you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
story_ids (int
| Iterable of int
, optional) – Pass a single story identifier or an iterable of story ids (as integers) to get the content of the
story themselves.
chat_id (int
, optional) – Unique identifier (int) of the target channel.
chat_id (int
, optional) – Unique identifier (int) of the target channel.
+You can also use user profile/channel public link in form of t.me/<username> (str).
limit (int
, optional) – Limits the number of stories to be retrieved.
By default, no limit is applied and all stories are returned.
offset_id (int
, optional) – Identifier of the first story to be returned.
user_ids (int
| str
| Iterable of int
or str
) – A list of User identifiers (id or username) or a single user id/username.
-For a contact that exists in your Telegram address book you can use his phone number (str).
User
| List of User
– In case user_ids was not a list,
diff --git a/staging/api/methods/hide_general_topic.html b/staging/api/methods/hide_general_topic.html
index 74f2d03a5..b6dc69c01 100644
--- a/staging/api/methods/hide_general_topic.html
+++ b/staging/api/methods/hide_general_topic.html
@@ -2240,7 +2240,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
bool – On success, a True is returned.
diff --git a/staging/api/methods/join_chat.html b/staging/api/methods/join_chat.html index 568c88344..836358b94 100644 --- a/staging/api/methods/join_chat.html +++ b/staging/api/methods/join_chat.html @@ -2240,8 +2240,8 @@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).
chat_id (int
| str
) – Unique identifier for the target chat in form of a t.me/joinchat/ or t.me/<username> link,
+a username of the target channel/supergroup (in the format @username) or a chat id of a linked chat (channel or supergroup).
Chat
– On success, a chat object is returned.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
delete (bool
, optional) – Deletes the group chat dialog after leaving (for simple group chats, not supergroups).
Defaults to False.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
bool
– On success, True is returned.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
message_id (int
) – Identifier of a message to pin.
disable_notification (bool
, optional) – Pass True, if it is not necessary to send a notification to all chat members about the new pinned
message. Notifications are always disabled in channels.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
user_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
-For a contact that exists in your Telegram address book you can use his phone number (str).
privileges (ChatPrivileges
, optional) – New user privileges.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
max_id (int
, optional) – The id of the last message you want to mark as read; all the messages before this one will be marked as
read as well. Defaults to 0 (mark every unread message as read).
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
topic_id (int
) – Unique identifier (int) of the target forum topic.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
bool – On success, a True is returned.
diff --git a/staging/api/methods/request_callback_answer.html b/staging/api/methods/request_callback_answer.html index 4ee457aad..2becd8884 100644 --- a/staging/api/methods/request_callback_answer.html +++ b/staging/api/methods/request_callback_answer.html @@ -1763,7 +1763,8 @@chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – The message id the inline keyboard is attached on.
callback_data (str
| bytes
) – Callback data associated with the inline button you want to get the answer from.
timeout (int
, optional) – Timeout in seconds.
peer_id (int
| str
) – The peer id you want to extract the InputPeer from.
-Can be a direct id (int), a username (str) or a phone number (str).
InputPeer
– On success, the resolved peer id is returned in form of an InputPeer object.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
user_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
-For a contact that exists in your Telegram address book you can use his phone number (str).
permissions (ChatPermissions
) – New user permissions.
until_date (datetime
, optional) – Date when the user will be unbanned.
If user is banned for more than 366 days or less than 30 seconds from the current time they are
diff --git a/staging/api/methods/retract_vote.html b/staging/api/methods/retract_vote.html
index 8e19a0f89..79cc2185f 100644
--- a/staging/api/methods/retract_vote.html
+++ b/staging/api/methods/retract_vote.html
@@ -2213,7 +2213,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
message_id (int
) – Identifier of the original message with the poll.
chat_id (int
| str
) – Unique identifier for the target chat or username of the target channel/supergroup
-(in the format @username).
invite_link (str
) – The invite link to revoke.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
query (str
, optional) – Text query string.
Required for text-only messages, optional for media messages (see the filter
argument).
When passed while searching for media messages, the query will be applied to captions.
diff --git a/staging/api/methods/search_messages_count.html b/staging/api/methods/search_messages_count.html
index f91a99a9d..348cac418 100644
--- a/staging/api/methods/search_messages_count.html
+++ b/staging/api/methods/search_messages_count.html
@@ -2214,7 +2214,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
query (str
, optional) – Text query string.
Required for text-only messages, optional for media messages (see the filter
argument).
When passed while searching for media messages, the query will be applied to captions.
diff --git a/staging/api/methods/send_animation.html b/staging/api/methods/send_animation.html
index 423ad9db8..1beb240e2 100644
--- a/staging/api/methods/send_animation.html
+++ b/staging/api/methods/send_animation.html
@@ -2227,7 +2227,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
animation (str
| BinaryIO
) – Animation to send.
Pass a file_id as string to send an animation that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get an animation from the Internet,
@@ -2255,8 +2256,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_audio.html b/staging/api/methods/send_audio.html
index a57504e28..cd0d31b09 100644
--- a/staging/api/methods/send_audio.html
+++ b/staging/api/methods/send_audio.html
@@ -2228,7 +2228,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
audio (str
| BinaryIO
) – Audio file to send.
Pass a file_id as string to send an audio file that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get an audio file from the Internet,
@@ -2253,8 +2254,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_cached_media.html b/staging/api/methods/send_cached_media.html
index fa5624e1c..64d436b2a 100644
--- a/staging/api/methods/send_cached_media.html
+++ b/staging/api/methods/send_cached_media.html
@@ -2216,7 +2216,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
file_id (str
) – Media to send.
Pass a file_id as string to send a media that exists on the Telegram servers.
caption (str
, optional) – Media caption, 0-1024 characters.
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_chat_action.html b/staging/api/methods/send_chat_action.html
index c7f969958..0282564b0 100644
--- a/staging/api/methods/send_chat_action.html
+++ b/staging/api/methods/send_chat_action.html
@@ -2227,7 +2227,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
action (ChatAction
) – Type of action to broadcast.
message_thread_id (`int`
) – Unique identifier for the target message thread (topic) of the forum.
for forum supergroups only.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
phone_number (str
) – Contact’s phone number.
first_name (str
) – Contact’s first name.
last_name (str
, optional) – Contact’s last name.
message_thread_id (int
, optional) – Unique identifier for the target message thread (topic) of the forum.
for forum supergroups only.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_dice.html b/staging/api/methods/send_dice.html
index 49930eb42..6f6131f0c 100644
--- a/staging/api/methods/send_dice.html
+++ b/staging/api/methods/send_dice.html
@@ -2213,7 +2213,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
emoji (str
, optional) – Emoji on which the dice throw animation is based.
Currently, must be one of “🎲”, “🎯”, “🏀”, “⚽”, “🎳”, or “🎰”.
Dice can have values 1-6 for “🎲”, “🎯” and “🎳”, values 1-5 for “🏀” and “⚽”, and
@@ -2225,8 +2226,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_document.html b/staging/api/methods/send_document.html
index 7b382c04b..b17b7d6e2 100644
--- a/staging/api/methods/send_document.html
+++ b/staging/api/methods/send_document.html
@@ -2227,7 +2227,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
document (str
| BinaryIO
) – File to send.
Pass a file_id as string to send a file that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get a file from the Internet,
@@ -2252,8 +2253,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_game.html b/staging/api/methods/send_game.html
index b8eb88bc3..2f370f742 100644
--- a/staging/api/methods/send_game.html
+++ b/staging/api/methods/send_game.html
@@ -1748,7 +1748,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
game_short_name (str
) – Short name of the game, serves as the unique identifier for the game. Set up your games via Botfather.
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
query_id (int
) – Unique identifier for the answered query.
result_id (str
) – Unique identifier for the result that was chosen.
disable_notification (bool
, optional) – Sends the message silently.
diff --git a/staging/api/methods/send_location.html b/staging/api/methods/send_location.html
index e4ffdea81..85ac7f0a9 100644
--- a/staging/api/methods/send_location.html
+++ b/staging/api/methods/send_location.html
@@ -2213,15 +2213,17 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
latitude (float
) – Latitude of the location.
longitude (float
) – Longitude of the location.
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
message_thread_id (int
, optional) – Unique identifier for the target message thread (topic) of the forum.
for forum supergroups only.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
media (List of InputMediaPhoto
, InputMediaVideo
, InputMediaAudio
, InputMediaDocument
and InputMediaAnimation
) – A list describing photos and videos to be sent, must include 2–10 items.
disable_notification (bool
, optional) – Sends the message silently.
Users will receive a notification with no sound.
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_message.html b/staging/api/methods/send_message.html
index 93850edc4..887b00006 100644
--- a/staging/api/methods/send_message.html
+++ b/staging/api/methods/send_message.html
@@ -2213,7 +2213,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
text (str
) – Text of the message to be sent.
parse_mode (ParseMode
, optional) – By default, texts are parsed using both Markdown and HTML styles.
You can combine both syntaxes together.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_photo.html b/staging/api/methods/send_photo.html
index 4ecee21a8..6f2fda2c8 100644
--- a/staging/api/methods/send_photo.html
+++ b/staging/api/methods/send_photo.html
@@ -2227,7 +2227,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
photo (str
| BinaryIO
) – Photo to send.
Pass a file_id as string to send a photo that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get a photo from the Internet,
@@ -2247,8 +2248,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_poll.html b/staging/api/methods/send_poll.html
index 5cbf1be8b..21bc32036 100644
--- a/staging/api/methods/send_poll.html
+++ b/staging/api/methods/send_poll.html
@@ -2213,7 +2213,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
question (str
) – Poll question, 1-255 characters.
options (List of str
) – List of answer options, 2-10 strings 1-100 characters each.
is_anonymous (bool
, optional) – True, if the poll needs to be anonymous.
@@ -2243,8 +2244,9 @@
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_reaction.html b/staging/api/methods/send_reaction.html
index 162952da8..672487c62 100644
--- a/staging/api/methods/send_reaction.html
+++ b/staging/api/methods/send_reaction.html
@@ -2211,7 +2211,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
message_id (int
, optional) – Identifier of the message.
story_id (int
, optional) – Identifier of the story.
emoji (int
| str
| List of int
| str
, optional) – Reaction emoji.
diff --git a/staging/api/methods/send_sticker.html b/staging/api/methods/send_sticker.html
index 18ba12040..d32202a9f 100644
--- a/staging/api/methods/send_sticker.html
+++ b/staging/api/methods/send_sticker.html
@@ -2227,7 +2227,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
sticker (str
| BinaryIO
) – Sticker to send.
Pass a file_id as string to send a sticker that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get a .webp sticker file from the Internet,
@@ -2239,8 +2240,9 @@
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message.
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_story.html b/staging/api/methods/send_story.html
index 03822bf3e..3da720b25 100644
--- a/staging/api/methods/send_story.html
+++ b/staging/api/methods/send_story.html
@@ -1626,7 +1626,8 @@
chat_id (int
, optional) – Unique identifier (int) of the target channel.
chat_id (int
| str
, optional) – Unique identifier (int) or username (str) of the target channel.
+You can also use channel public link in form of t.me/<username> (str).
animation (str
| BinaryIO
, optional) – Animation to send.
Pass a file_id as string to send a animation that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get a animation from the Internet,
diff --git a/staging/api/methods/send_venue.html b/staging/api/methods/send_venue.html
index 2d387f261..8b62ac4f0 100644
--- a/staging/api/methods/send_venue.html
+++ b/staging/api/methods/send_venue.html
@@ -2213,7 +2213,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
latitude (float
) – Latitude of the venue.
longitude (float
) – Longitude of the venue.
title (str
) – Name of the venue.
reply_to_message_id (int
, optional) – If the message is a reply, ID of the original message
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_video.html b/staging/api/methods/send_video.html
index e19d0e04b..f3d7faf70 100644
--- a/staging/api/methods/send_video.html
+++ b/staging/api/methods/send_video.html
@@ -2227,7 +2227,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
video (str
| BinaryIO
) – Video to send.
Pass a file_id as string to send a video that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get a video from the Internet,
@@ -2258,8 +2259,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_video_note.html b/staging/api/methods/send_video_note.html
index fba50e436..90df43304 100644
--- a/staging/api/methods/send_video_note.html
+++ b/staging/api/methods/send_video_note.html
@@ -2227,7 +2227,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
video_note (str
| BinaryIO
) – Video note to send.
Pass a file_id as string to send a video note that exists on the Telegram servers,
pass a file path as string to upload a new video note that exists on your local machine, or
@@ -2245,8 +2246,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_voice.html b/staging/api/methods/send_voice.html
index ceaa4576e..d6ae545a7 100644
--- a/staging/api/methods/send_voice.html
+++ b/staging/api/methods/send_voice.html
@@ -2227,7 +2227,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
voice (str
| BinaryIO
) – Audio file to send.
Pass a file_id as string to send an audio that exists on the Telegram servers,
pass an HTTP URL as a string for Telegram to get an audio from the Internet,
@@ -2245,8 +2246,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/send_web_page.html b/staging/api/methods/send_web_page.html
index 1e02b8de9..ccff1f0a7 100644
--- a/staging/api/methods/send_web_page.html
+++ b/staging/api/methods/send_web_page.html
@@ -2213,7 +2213,8 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
For your personal cloud (Saved Messages) you can simply use “me” or “self”.
-For a contact that exists in your Telegram address book you can use his phone number (str).
url (str
) – Link that will be previewed.
text (str
, optional) – Text of the message to be sent.
parse_mode (ParseMode
, optional) – By default, texts are parsed using both Markdown and HTML styles.
@@ -2227,8 +2228,9 @@
reply_to_story_id (int
, optional) – Unique identifier for the target story.
reply_to_chat_id (int
, optional) – Unique identifier for the origin chat.
-for reply to message from another chat.
reply_to_chat_id (int
| str
, optional) – Unique identifier for the origin chat.
+for reply to message from another chat.
+You can also use chat public link in form of t.me/<username> (str).
quote_text (str
, optional) – Text to quote.
for reply_to_message only.
quote_entities (List of MessageEntity
, optional) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.
diff --git a/staging/api/methods/set_administrator_title.html b/staging/api/methods/set_administrator_title.html
index 0e848907d..f4cc1f2aa 100644
--- a/staging/api/methods/set_administrator_title.html
+++ b/staging/api/methods/set_administrator_title.html
@@ -2243,9 +2243,11 @@
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
user_id (int
| str
) – Unique identifier (int) or username (str) of the target user.
-For a contact that exists in your Telegram address book you can use his phone number (str).
title (str
, optional) – A custom title that will be shown to all members instead of “Owner” or “Admin”.
Pass None or “” (empty string) to remove the custom title.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
description (str
) – New chat description, 0-255 characters.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
permissions (ChatPermissions
) – New default chat permissions.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
photo (str
| BinaryIO
, optional) – New chat photo. You can pass a Photo
file_id, a file path to upload a new photo
from your local machine or a binary file-like object with its attribute
“.name” set for in-memory uploads.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
enabled (bool
) – Pass True to enable the protected content setting, False to disable.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
chat_id (int
| str
) – Unique identifier (int) or username (str) of the target chat.
+You can also use chat public link in form of t.me/<username> (str).
title (str
) – New chat title, 1-255 characters.
chat_id (