پین کردن پیام در ربات تلگرام با API

telegram bot api pin chat message
01 دی 1403

آشنایی با API ربات تلگرام و نحوه استفاده از pinChatMessage


ربات‌های تلگرام ابزارهای فوق‌العاده‌ای برای ایجاد تعاملات و خدمات هوشمند در این پلتفرم هستند. یکی از ویژگی‌های جالبی که ربات‌ها می‌توانند داشته باشند، امکان چسباندن پیام‌ها (پین کردن) در یک چت است. این ویژگی به کاربران کمک می‌کند که به پیام‌های مهم دسترسی پیدا کنند و باعث می‌شود که توجه بیشتری به آن‌ها جلب شود.


ویژگی pinChatMessage در API ربات تلگرام به شما اجازه می‌دهد که یک یا چند پیام را در یک چت گروهی یا کانال پین کنید. این کار معمولاً در مواقعی استفاده می‌شود که بخواهید یک اعلان مهم، خبر یا پیام حاوی اطلاعات ضروری را به شکلی ماندگار در بالای چت نگه دارید.


برای استفاده از این ویژگی، شما باید از متد pinChatMessage استفاده کنید. برای این کار، نیاز به شناسایی چت و پیام مورد نظر دارید. به طور کلی، این متد به شما یک کنترل عمیق‌تر روی پیام‌ها می‌دهد و می‌توانید با آن تجربه کاربری بهتری را فراهم کنید.


در این مثال، ما با استفاده از متد pinChatMessage یک پیام را در چتی مشخص پین خواهیم کرد. توجه داشته باشید که برای انجام این کار، ربات شما باید مجوزهای لازم را برای پین کردن پیام‌ها در چت داشته باشد.


نمونه کد استفاده از پنچت مسیج


// این آدرس API تلگرام برای استفاده از متد pinChatMessage است
const telegramBotApiUrl = 'https://api.telegram.org/bot<توکن_ربات>/pinChatMessage';

// داده‌هایی که برای این متد ارسال می‌شود
const data = {
chat_id: '<آیدی_چت>',
message_id: '<آیدی_پیام>'
};

// ارسال درخواست به API
fetch(telegramBotApiUrl, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => {
console.log('پیام با موفقیت پین شد:', data);
})
.catch(error => {
console.error('خطا در پین کردن پیام:', error);
});

توضیحات خط به خط کد



خط 1: این آدرس API ربات تلگرام است که برای پین کردن پیام استفاده می‌شود.


خط 2: توکن ربات خود را در URL قرار دهید.


خط 4: داده‌هایی که می‌خواهید به API ارسال کنید، شامل chat_id و message_id است.


خط 8: با استفاده از fetch، درخواست API به صورت متد POST ارسال می‌شود.


خط 12: در header، نوع محتوا را به JSON تنظیم می‌کنیم.


خط 14: داده‌ها را به فرمت JSON در body درخواست قرار می‌دهیم.


خط 16: پس از دریافت پاسخ، آن را به فرمت JSON تبدیل می‌کنیم.


خط 17: اگر درخواست با موفقیت انجام شود، لاگ می‌کنیم که پیام با موفقیت پین شد.


خط 19: در صورت وجود خطا، آن را لاگ می‌کنیم تا بتوانیم مشکل را بررسی کنیم.

سوالات متداول

؟

چرا نمی‌توانم پیام‌ها را در ربات تلگرام پین کنم؟

؟

آیا می‌توانم چند پیام را همزمان پین کنم؟

؟

آیا می‌توانم پیام‌های قدیمی را پین کنم؟

؟

چگونه می‌توانم یک پیام پین شده را حذف کنم؟