راهنمای استفاده از API تبلیغات تلگرام: عملکرد، بودجه و جایگزین‌ها
Last updated: October 2026
API رسمی تبلیغات تلگرام امکان ایجاد و مدیریت خودکار پیامهای اسپانسری را فراهم میکند. قیمت آن از ۰.۱ TON به ازای هر ۱۰۰۰ بازدید (CPM) شروع میشود اما نیازمند بودجه‌ای کلان و استفاده از مجموعه‌ای از توابع خاص است که در پلتفرم اصلی تلگرام مستند شده‌اند (blockmm.ai). این راهنما واقعیت‌های فنی استفاده از API تبلیغات تلگرام را توضیح می‌دهد و پلتفرم رسمی را با APIهای شخص ثالث و ربات مقایسه میکند.
API تبلیغات تلگرام ابزاری برای مدیریت برنامه‌ریزی‌شده «پیامهای اسپانسری» (Sponsored Messages) در پلتفرم تبلیغاتی تلگرام است. این یک رابط کاربری محدود است که عمدتاً برای تبلیغ‌دهندگان بزرگی که می‌توانند الزامات بودجه‌ای قابل توجهی را برآورده کنند، در نظر گرفته شده است. هدف اصلی آن خودکارسازی ایجاد تبلیغ، کنترل بودجه و تحلیل عملکرد برای پست‌ها در کانالهای عمومی بزرگ است.
برای توسعهدهندگان، تفاوت بین Bot API، API اصلی (TDLib) و Ads API می‌تواند گیج‌کننده باشد. این راهنما این تمایزها را روشن میکند، موانع فنی و مالی را توضیح می‌دهد و جزئیات نحوه ساخت ویژگی‌های تبلیغاتی در سرویس‌های شما را تشریح میکند.
API تبلیغات تلگرام چیست (و چه چیزی نیست)؟
API تبلیغات تلگرام یک رابط کاربری خاص و احراز هویت شده برای مدیریت «پیامهای اسپانسری» در پلتفرم تبلیغاتی تلگرام است. این یک API عمومی با ثبت‌نام باز نیست. دسترسی به آن محدود است و عموماً برای تبلیغ‌دهندگانی که بودجه‌های بالایی دارند، رزرو شده است. عملکرد اصلی این API، خودکارسازی وظایف تبلیغاتی برای پست‌های اسپانسری است که در کانالهای عمومی در پلتفرمی با مخاطبان انبوه نمایش داده می‌شوند.
تمایز این API از سایر APIهای تلگرام که توسعهدهندگان اغلب از آنها استفاده می‌کنند، ضروری است:
- Bot API: این رایج‌ترین API برای ایجاد و مدیریت رباتهای تلگرام است. ربات‌ها می‌توانند پیام ارسال کنند، گروه‌ها را مدیریت کنند و خدمات تعاملی ارائه دهند. با این حال، Bot API هیچ تابعی برای ایجاد «پیامهای اسپانسری» رسمی ندارد. شما نمیتوانید کمپین‌های تبلیغاتی را از طریق یک ربات اجرا کنید.
- Telegram API (TDLib - Telegram Database Library): این یک کتابخانه قدرتمند برای ساخت کلاینت‌های سفارشی تلگرام است. در حالی که با بسیاری از ویژگی‌های اکوسیستم تلگرام تعامل دارد، برای قرار دادن تبلیغات طراحی نشده است. هدف آن توسعه کلاینت است، نه مدیریت تبلیغات.
API تبلیغات تلگرام یک سیستم بسته برای تبلیغ‌دهندگان با بودجه بالا جهت مدیریت برنامه‌ریزی‌شده «پیامهای اسپانسری» است. این API از نظر عملکردی از Bot API عمومی و کتابخانه توسعه کلاینت TDLib مجزا است.
به طور خلاصه، اگر هدف شما قرار دادن یک تبلیغ رسمی با برچسب «sponsored» است، Bot API و TDLib ابزارهای اشتباهی هستند. شما باید از پلتفرم تبلیغات تلگرام، یا از طریق رابط وب آن یا API محدود آن استفاده کنید.
API رسمی تبلیغات چگونه کار میکند؟
دسترسی مستقیم به API تبلیغات تلگرام از طریق یک ثبت‌نام ساده امکان‌پذیر نیست. این یک سیستم کنترل‌شده است که نیازمند تأیید دستی از سوی تلگرام و یک تعهد مالی جدی است. برای مثال، این فرآیند برای برندهای بزرگ و آژانس‌های تبلیغاتی طراحی شده است، نه کسب‌وکارهای کوچک.
پس از اعطای دسترسی، تعامل از طریق MTProto، پروتکل سفارشی تلگرام، انجام میشود، نه یک REST API ساده. توسعهدهندگان باید از کتابخانه‌هایی استفاده کنند که بتوانند درخواست‌های MTProto را برای فراخوانی متدهای خاص مرتبط با تبلیغات مدیریت کنند. توابع اصلی حول ایجاد، به‌روزرسانی و بازیابی آمار تبلیغات می‌چرخند.
متدهای کلیدی API عبارتند از:
ads.createAd: یک تبلیغ جدید، پارامترهای هدفگیری و بودجه را ارسال میکند.ads.updateAds: کمپین‌های تبلیغاتی موجود را اصلاح میکند.ads.getAdsAll: لیستی از تمام تبلیغات مرتبط با حساب را بازیابی میکند.ads.getAdsStatistics: دادههای عملکردی مانند بازدیدها را برای یک تبلیغ خاص دریافت میکند.
این متدها بخشی از عملکرد اصلی پلتفرم هستند، همانطور که در شمای رسمی MTProto مستند شده است. مانع فنی MTProto، همراه با نقطه ورود مالی بالا، دسترسی مستقیم به API را برای اکثر افراد غیرعملی میکند. در نتیجه، این امر بازاری را برای ارائه‌دهندگان خدمات تبلیغات تلگرام که به عنوان واسطه عمل می‌کنند، ایجاد کرده است.
مقایسه دسترسی به API رسمی و شخص ثالث
برای توسعهدهندگان و آژانس‌ها، انتخاب بین تلاش برای دسترسی مستقیم به API رسمی یا استفاده از یک API فروشنده شخص ثالث است. یک API فروشنده، پیچیدگی و هزینه بالای پلتفرم رسمی را مدیریت کرده و یک نقطه ورود در دسترس‌تر را فراهم میکند. جدول زیر تفاوت‌های کلیدی را مشخص میکند.
| ویژگی | API رسمی تبلیغات تلگرام | API فروشنده شخص ثالث (مانند TgFather) |
|---|---|---|
| حداقل بودجه | بالا (مثلاً حداقل هزینه ۲ میلیون یورو برای دسترسی مستقیم) (blockmm.ai) | پایین (پرداخت به ازای هر کمپین یا پیش‌پرداخت کم) |
| روش دسترسی | تأیید دستی، پروتکل MTProto | ثبت‌نام فوری، REST API |
| زمان راه‌اندازی | هفته‌ها یا ماه‌ها | چند دقیقه |
| گزینه‌های هدفگیری | موضوعات کانال، زبانها، کانالهای خاص | مشابه رسمی، از طریق رابط کاربری ساده‌شده |
| پشتیبانی | مدیر حساب اختصاصی (برای سطوح بالا) | سیستم تیکتینگ، مستندات توسعه‌دهنده |
| کاربر ایده‌آل | شرکت‌های بزرگ، آژانس‌های تبلیغاتی بزرگ | پنل‌های SMM، توسعهدهندگان، آژانس‌های کوچک |
ادغام تبلیغات برنامه‌ریزی‌شده: رویکرد API TgFather
برای توسعه‌دهندگانی که نیاز به ادغام تبلیغات تلگرام در برنامه‌های خود بدون برآورده کردن الزامات سنگین رسمی دارند، یک API فروشنده راه‌حل عملی است. API TgFather این هدف را با عمل به عنوان یک لایه خدماتی بر روی پلتفرم رسمی برآورده میکند.
API ما به شما این امکان را می‌دهد که به صورت برنامه‌ریزی‌شده «پیامهای اسپانسری» رسمی را در تلگرام از طریق یک رابط REST ساده و مستند قرار دهید. به جای سر و کار داشتن با MTProto و بودجه‌ای عظیم، میتوانید سفارشات تبلیغاتی را از طریق سیستم ما با تعهد مالی بسیار پایین‌تری مدیریت کنید. این رویکرد برای فروشندگان و توسعه‌دهندگانی طراحی شده است که می‌خواهند خدمات تبلیغاتی را به کاربران خود ارائه دهند.
برای شفاف‌سازی، API TgFather همان API خام تبلیغات تلگرام نیست. این سرویسی است که سفارشات تبلیغاتی را از طرف شما در پلتفرم رسمی اجرا میکند. مزایای آن مانع ورود کمتر، صورتحساب ترکیبی برای چندین سرویس و یکپارچه‌سازی ساده است. این مدل برای هر کسی که در حال ساخت یک ابزار مدیریت رسانه‌های اجتماعی چند سرویسه است، ایده‌آل است.
محدودیت‌ها و هزینه‌های کلیدی چیست؟
درک محدودیت‌های سیستم تبلیغاتی تلگرام قبل از سرمایه‌گذاری در توسعه، حیاتی است. رویکرد حریم خصوصی-محور پلتفرم، محدودیت‌های قابل توجهی را در مقایسه با سایر شبکه‌های اجتماعی ایجاد میکند.
هزینه‌های تبلیغات
هزینه‌های شما بر اساس روش دسترسی شما متفاوت خواهد بود.
-
پلتفرم رسمی: این مسیر نیازمند یک تعهد مالی اولیه بزرگ است. به عنوان مثال، تلگرام قبلاً برای دسترسی آژانس‌ها، ودیعه ۱ میلیون یورویی درخواست کرده است. خود تبلیغات بر اساس مدل CPM اجرا می‌شوند.
-
APIهای فروشنده: این سرویس‌ها نیاز به ودیعه بزرگ را از بین می‌برند. شما هزینه کمپین‌های خود را به صورت مرحله‌ای پرداخت می‌کنید، اما CPM شامل حاشیه سود ارائه‌دهنده خواهد بود. این یک مصالحه برای دسترسی بیشتر و هزینه اولیه کمتر است.
محدودیت‌های پلتفرم
- هدفگیری حریم خصوصی-محور: این مهم‌ترین تفاوت با پلتفرم‌هایی مانند متا است. شما نمیتوانید کاربران را بر اساس دادههای شخصی هدف قرار دهید. در عوض، هدفگیری به زمینه کانالهای عمومی محدود میشود. شما میتوانید کاربران (بر اساس کشور، زبان، موضوعات، دستگاه)، کانالهای خاص (با بیش از ۱۰۰۰ مشترک)، رباتهای خاص یا جستجوهای خاص را هدف قرار دهید (Adsly).
- سیاست‌های محتوایی سخت‌گیرانه: تلگرام انواع محتوای تبلیغاتی را به شدت محدود میکند. دسته‌های ممنوعه شامل محصولات فریبنده، قمار، بدافزار و محتوای سیاسی است. تیم تلگرام همه تبلیغات را به صورت دستی بازبینی میکند و تأیید تضمین شده نیست. شما میتوانید لیست کامل قوانین را در پلتفرم رسمی تبلیغات بخوانید.
- محدودیت‌های نرخ API: همه APIها برای جلوگیری از سوءاستفاده، محدودیت نرخ اعمال می‌کنند. در حالی که محدودیت‌های نرخ رسمی تلگرام عمومی نیست، هر API فروشنده‌ای محدودیت‌های مشخص خود را در مورد تعداد درخواست‌هایی که میتوانید در هر دقیقه یا ساعت انجام دهید، خواهد داشت.
چگونه باید برای ادغام آماده شوم؟
قبل از تخصیص منابع به یک پروژه ادغام، این نکات کلیدی را ارزیابی کنید تا ببینید آیا API تبلیغات تلگرام، چه به صورت مستقیم و چه از طریق یک فروشنده، با اهداف شما مطابقت دارد یا خیر.
- بودجه خود را ارزیابی کنید. آیا میتوانید حداقل سپرده‌ها و هزینه‌های بالای مورد نیاز برای دسترسی مستقیم را تأمین کنید؟ اگر نه، یک API فروشنده تنها مسیر عملی شما برای اتوماسیون است.
- سیاست‌های تبلیغاتی تلگرام را مرور کنید. محدودیت‌های محتوایی را در سایت
promote.telegram.orgبا دقت بخوانید. اطمینان حاصل کنید که محصول یا خدمات شما برای جلوگیری از اتلاف وقت، سازگار است. - مخاطبان هدف خود را تعریف کنید. آیا میتوانید با استفاده از هدفگیری گسترده تلگرام بر اساس موضوع و کانال، به طور مؤثر به مخاطبان خود دسترسی پیدا کنید؟ اگر به هدفگیری جمعیتی دقیق نیاز دارید، این پلتفرم مناسبی نیست.
- ظرفیت فنی خود را ارزیابی کنید. آیا تیم شما تخصص کار با پروتکل MTProto را دارد؟ یا یک REST API استاندارد از یک ارائه‌دهنده مانند API TgFather مسیر عملی‌تری است؟
- جایگزین‌ها را در نظر بگیرید. برای اهداف خاص، خرید پیامهای اسپانسری رسمی از طریق یک سرویس مدیریت‌شده یا مذاکره برای تبلیغات خصوصی به طور مستقیم با صاحبان کانال‌ها می‌تواند بازده بهتری نسبت به تبلیغات برنامه‌ریزی‌شده داشته باشد.
گام بعدی چیست؟
آماده شروع کار با تبلیغات برنامه‌ریزی‌شده تلگرام هستید؟ در اینجا چهار گام اساسی برای برداشتن آورده شده است:
۱. بودجه خود را تخمین بزنید: از حداقل CPM ۰.۱ TON برای پیش‌بینی هزینه‌های بالقوه کمپین استفاده کنید (blockmm.ai). تصمیم بگیرید که آیا بودجه شما با دسترسی مستقیم هماهنگ است یا یک فروشنده گزینه بهتری است. ۲. مسیر خود را انتخاب کنید: بر اساس بودجه و منابع فنی خود، بین پیگیری دسترسی مستقیم به API یا ادغام با یک API فروشنده تصمیم بگیرید. ۳. مستندات API را مرور کنید: اگر یک فروشنده را انتخاب می‌کنید، مستندات API آنها را مطالعه کنید تا نقاط پایانی (endpoints)، فرمت‌های درخواست و روش‌های احراز هویت مورد نیاز برای ادغام را درک کنید.
سوالات متداول
آیا میتوانم از Bot API تلگرام برای اجرای تبلیغات استفاده کنم؟
خیر. Bot API برای ایجاد رباتهای تعاملی و مدیریت پیامها است. این API هیچ تابعی برای ایجاد، مدیریت یا پرداخت هزینه برای «پیامهای اسپانسری» در پلتفرم رسمی تبلیغات تلگرام ندارد. تبلیغات نیازمند استفاده مستقیم از پلتفرم تبلیغات یا از طریق یک واسطه مجاز است.
حداقل قیمت تبلیغات تلگرام از طریق API چقدر است؟
دسترسی مستقیم به API نیازمند یک تعهد مالی قابل توجه است. به عنوان مثال، تلگرام از آژانس‌ها ودیعه ۱ میلیون یورویی درخواست کرده است. خود تبلیغات بر اساس مدل CPM (هزینه به ازای هر هزار بازدید) با شروع از ۲ یورو قیمت‌گذاری می‌شوند. APIهای فروشنده نقطه ورود بسیار پایین‌تری را ارائه میدهند و به شما امکان میدهند کمپین‌ها را با بودجه‌های کوچکتر و انعطاف‌پذیر اجرا کنید.
آیا کتابخانه پایتون رسمی برای API تبلیغات تلگرام وجود دارد؟
خیر، تلگرام کتابخانههای کلاینت رسمی برای API تبلیغات در زبانهایی مانند پایتون یا جاوا اسکریپت ارائه نمیدهد. ادغام مستقیم نیازمند کار با پروتکل MTProto است که یک کار پیچیده است. این مانع فنی دلیل اصلی انتخاب APIهای فروشنده توسط بسیاری از توسعهدهندگان است که نقاط پایانی REST استاندارد را ارائه میدهند.
API تبلیغات تلگرام چه تفاوتی با API تبلیغات متا دارد؟
API تبلیغات تلگرام بسیار محدودتر است. این API فاقد هدفگیری در سطح کاربر بر اساس دادههای شخصی است که API تبلیغات متا را تعریف میکند. هدفگیری تلگرام حریم خصوصی-محور است و فقط بر اساس موضوعات کانالهای عمومی و زبانها انجام میشود. همچنین دسترسی عمومی به این API بسیار کمتر است.
آیا میتوانم با API تبلیغات کاربران را مستقیماً هدف قرار دهم؟
خیر. سیستم تبلیغاتی تلگرام از حریم خصوصی کاربران محافظت میکند. شما نمیتوانید کاربران فردی یا هیچ یک از اطلاعات شخصی آنها را هدف قرار دهید. شما فقط میتوانید مخاطبان کانالهای عمومی با بیش از ۱۰۰۰ مشترک را هدف قرار دهید، یا با انتخاب کانالهای خاص یا با انتخاب موضوع کلی آنها.