نحوه استفاده از API ربات تلگرام برای گرفتن مدیران چت
ربات‌های تلگرام ابزاری قدرتمند برای تعامل با کاربران و گروه‌ها هستند. یکی از قابلیت‌های مهم این ربات‌ها، امکان مدیریت کاربران در گروه‌ها و کانال‌هاست. با استفاده از متد getChatAdministrators در API ربات تلگرام، می‌توانید لیستی از مدیران فعلی یک چت (مانند گروه یا کانال) را دریافت کنید. این متد به شما اجازه می‌دهد تا اطلاعات دقیقی در مورد مدیران، شامل شناسه کاربری، نام کاربری و وضعیت آنها داشته باشید.
برای شروع، لازم است که یک ربات تلگرام داشته باشید. اگر هنوز ربات خود را ایجاد نکرده‌اید، می‌توانید به مستندات تلگرام مراجعه کنید. پس از آن، به کمک توکن ربات خود، می‌توانید درخواست‌های API را ارسال کنید.
متد getChatAdministrators به صورت زیر عمل می‌کند: ابتدا باید شناسه چت (چت ID) را داشته باشید. شناسایی این چت می‌تواند به شکل شماره گروه، لینک به گروه یا نام کاربری کانال باشد. سپس با ارسال درخواست GET به آدرس مخصوص این متد، می‌توانید اطلاعات مدیران را دریافت کنید.
حال به بخش کد می‌رسیم. در اینجا یک مثال از نحوه استفاده از این متد با استفاده از PHP را ارائه می‌دهیم. این کد به شما کمک می‌کند تا لیست مدیران یک گروه را دریافت کنید.
$token = "YOUR_BOT_TOKEN";
$chat_id = "YOUR_CHAT_ID";
$response = file_get_contents("https://api.telegram.org/bot" . $token . "/getChatAdministrators?chat_id=" . $chat_id);
$data = json_decode($response, true);
if ($data['ok']) {
foreach ($data['result'] as $administrator) {
echo "Username: " . $administrator['user']['username'] . "\n";
}
} else {
echo "Error fetching administrators";
}
?>
در این کد:
1. $token = "YOUR_BOT_TOKEN";در اولین خط توکن ربات خود را که از ربات
BotFather دریافت کردید، وارد کنید.2. $chat_id = "YOUR_CHAT_ID";در این خط، شناسه چت گروه یا کانال را مشخص کنید.
3. $response = file_get_contents(...);در این خط، درخواست API برای گرفتن لیست مدیران ارسال می‌شود.
4. $data = json_decode($response, true);در اینجا، پاسخ JSON را به آرایه PHP تبدیل می‌کنیم تا بتوانیم به راحتی به اطلاعات آن دسترسی پیدا کنیم.
5. if ($data['ok']) { ... } این بخش بررسی می‌کند که آیا درخواست موفقیت‌آمیز بود یا خیر. اگر موفق بود، لیست مدیران به دست آمده و برای هر مدیر نام کاربری آن چاپ می‌شود.
6. echo "Error fetching administrators";اگر خطایی پیش بیاید، پیام خطا نمایش داده می‌شود.