چطور با استفاده از API تلگرام یک کاربر را از گروه آزاد کنیم؟
بعضی اوقات ممکن است در یک گروه تلگرامی، نیاز به ممنوع کردن چند کاربر باشد. اما در مواقعی هم ممکن است بخواهید آن‌ها را دوباره به گروه برگردانید. برای این کار می‌توانید از متد unbanChatMember استفاده کنید که به شما اجازه می‌دهد تا کاربرانی که قبلاً ممنوع شده‌اند را دوباره آزاد کنید.
این متد به سادگی با ارسال یک درخواست به API تلگرام قابل استفاده است. کافیست chat_id گروه و user_id کاربری که می‌خواهید آزادی خود را به دست آورد، مشخص کنید. همچنین می‌توانید یک reason برای آزاد کردن کاربر تعیین کنید، هرچند این پارامتر اختیاری است.
برای شروع کار با API تلگرام، اولین قدم‌تان باید این باشد که یک bot ایجاد کنید و از توکن آن استفاده کنید. بعد از اینکه توکن را دریافت کردید، می‌توانید با متد unbanChatMember با استفاده از HTTP درخواست کنید. در اینجا یک مثال آورده شده است.
احتمالاً با مطالعه این اطلاعات، درک بهتری از چگونگی استفاده از این متد پیدا خواهید کرد. در ادامه به بررسی کد نمونه‌ای می‌پردازیم که می‌توانید با آن برای آزاد کردن یک کاربر از گروه استفاده کنید.
const axios = require('axios');
const token = 'YOUR_BOT_TOKEN';
const chatId = 'CHAT_ID'; // شناسه چت گروه
const userId = 'USER_ID'; // شناسه کاربر برای آزاد کردن
async function unbanUser() {
try {
const response = await axios.post(`https://api.telegram.org/bot${token}/unbanChatMember`, {
chat_id: chatId,
user_id: userId,
});
console.log(response.data);
} catch (error) {
console.error('Error unbanning user:', error);
}
}
unbanUser();توضیح کد
در این کد ابتدا ما با استفاده از require ماژول axios را وارد می‌کنیم که برای ارسال درخواست‌های HTTP استفاده می‌شود.
سپس توکن ربات خود و شناسه گروه و شناسه کاربری را که می‌خواهید آزاد کنید، مشخص می‌کنیم.
در تابع unbanUser یک درخواست POST به آدرس API تلگرام ارسال می‌شود، که در آن chat_id و user_id مشخص شده است.
اگر درخواست موفقیت‌آمیز باشد، نتیجه در کنسول چاپ می‌شود و در صورت بروز خطا، خطای مربوطه چاپ خواهد شد.
در نهایت تابع unbanUser را برای اجرای عملیات فراخوانی می‌کنیم.