setChatMemberTag
تگ عضو چت را تنظیم میکند (Bot API 9.5).
مقدار بازگشتی: در صورت موفقیت، True برمیگرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
chat_id | Integer or String | بله | شناسه چت یا @username |
user_id | Integer | بله | شناسه کاربر |
tag | String | اختیاری | تگ جدید عضو (0-16 کاراکتر، بدون ایموجی؛ رشته خالی = حذف) |
نمونه درخواست
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/setChatMemberTag" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"user_id":123456789}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/setChatMemberTag",
json={
"chat_id": 123456789,
"user_id": 123456789
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/setChatMemberTag`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"user_id": 123456789
}),
});
console.log(await res.json());
راهنمای گامبهگام: ساخت ربات تلگرام: آموزش قدمبهقدم از BotFather تا اولین پیام با Python
متدهای مرتبط
banChatMemberعضو چت را مسدود میکند.unbanChatMemberمسدودیت عضو چت را رفع میکند.restrictChatMemberعضو چت را محدود میکند.promoteChatMemberعضو چت را به ادمین ارتقا میدهد.setChatAdministratorCustomTitleعنوان سفارشی برای ادمین تنظیم میکند.banChatSenderChatیک کانال را در گروه/سوپرگروه مسدود میکند.unbanChatSenderChatمسدودیت یک کانال را در گروه/سوپرگروه رفع میکند.pinChatMessageپیامی را در چت سنجاق میکند.unpinChatMessageپیامی را در چت از سنجاق برمیدارد.unpinAllChatMessagesهمه پیامهای سنجاقشده چت را برمیدارد.