Telegram Ads API اور انضمام: اپنے ورک فلو کو خودکار بنائیں

Telegram مشتہرین کے لیے کوئی API شائع نہیں کرتا: اس کی ڈویلپر سائٹ پر Bot API، کلائنٹ API، TDLib، Gateway API اور Payments API درج ہیں، اور ان میں سے کوئی بھی اشتہاری مہم نہ بناتا ہے، نہ ان کی رپورٹ دیتا ہے۔ ADSLY ایک مجاز سیشن کے ذریعے آپ کے اشتہاری کیبنٹ سے جڑتا ہے اور اس کے اوپر انضمام کے تین راستے دیتا ہے — REST API، جو آپ کے اعداد و شمار پڑھتا ہے اور آپ اجازت دیں تو مہمات بھی سنبھالتا ہے؛ دستخط شدہ webhooks؛ اور ایک endpoint جو آپ کے ٹریکر سے کنورژنز لیتا ہے۔

Telegram Ads کا «API» کیسے کام کرتا ہے

Telegram کا اشتہاری پلیٹ فارم ads.telegram.org پر ہے اور ویب انٹرفیس سے چلایا جاتا ہے۔ ہم نے اکتوبر 2026 میں Telegram کی ڈویلپر دستاویزات دیکھیں: core.telegram.org پر Bot API (بوٹس کے لیے Payments API کے ساتھ)، TDLib، Gateway API اور کلائنٹ ایپس بنانے کے لیے Telegram API پیش کیے گئے ہیں۔ اشتہارات سے متعلق اس کے دو مضامین ہیں: Sponsored Messages کلائنٹ ایپس کو بتاتا ہے کہ اشتہار کیسے دکھائیں، اور دوسرا چینل اور بوٹ مالکان کی اشتہاری آمدنی کے بارے میں ہے؛ دونوں میں سے کوئی بھی مہمات سنبھالنے والے مشتہر کے لیے نہیں۔ پلیٹ فارم کی اپنی ابتدائی گائیڈ میں بھی کسی API کا ذکر نہیں۔

اسی لیے ADSLY اس Telegram اکاؤنٹ کے سیشن کے ذریعے کام کرتا ہے جس کے پاس اشتہاری کیبنٹ ہے۔ کیبنٹ جوڑنے کے تین طریقے ہیں: فون نمبر درج کر کے Telegram میں درخواست کی تصدیق کرنا، ads.telegram.org میں لاگ اِن رہتے ہوئے ہمارا براؤزر ایکسٹینشن استعمال کرنا، یا سیشن ٹوکن خود پیسٹ کرنا۔ یہ درخواست صرف اشتہاری کیبنٹ کو جوڑتی ہے، آپ کے ذاتی Telegram کو نہیں۔ Adstat سے آئے کیبنٹ آپ کے Adstat لاگ اِن سے جڑتے ہیں۔ جڑنے کے بعد Euro، TON اور Stars کیبنٹ ایک ہی طرح سنبھالے جاتے ہیں۔

کیبنٹ جڑنے کے بعد ADSLY کیا کرتا ہے

ویب انٹرفیس میں جو کچھ کلک در کلک ہوتا ہے، پینل میں وہ ایک ایکشن بن جاتا ہے:

مہم بنانا — پوری ترتیبات کے ساتھ ایک مہم، یا بلک تیاری: کئی ٹیکسٹ × کئی لنکس × چینلز کی فہرست، چاہیں تو ہر ملک، موضوع یا ڈیوائس کے لیے الگ مہم میں بانٹ کر۔

CPM اور بجٹ میں تبدیلی — ہر منتخب مہم پر بِڈ مقرر کرنا، اسے کسی رقم یا فیصد سے بڑھانا یا گھٹانا؛ بجٹ شامل کرنا، کم کرنا یا بچی ہوئی رقم واپس نکالنا۔

روکنا، دوبارہ چلانا اور حذف کرنا — کسی انتخاب، کسی گروپ یا موجودہ فلٹر پر پوری اترنے والی ہر مہم کے لیے۔

اعداد و شمار کا سنک — ہر مہم کے ویوز، کلکس، ایکشنز، خرچ، CTR اور CPM گھنٹے میں ایک بار محفوظ ہوتے ہیں۔

ٹیکسٹ، عنوان اور میڈیا میں ترمیم — بلک میں، مہمات دوبارہ بنائے بغیر۔

بیلنس کی نگرانی — ڈیش بورڈ پر ہر کیبنٹ اس کے بیلنس اور فعال، جائزے میں، مسترد اور رکی ہوئی مہمات کی تعداد کے ساتھ نظر آتا ہے؛ ہر سنک پر یہ تازہ ہوتا ہے۔

ڈیٹا ایکسپورٹ اور رپورٹنگ

پینل اس سے زیادہ تاریخ رکھتا ہے جتنی ایک اسٹیٹسٹکس ٹیب دکھاتی ہے، اور اسے باہر لے جانے دیتا ہے:

Excel، CSV اور PDF ایکسپورٹ — آپ کے منتخب کالموں والی ڈیٹا فائل، یا ایک PDF رپورٹ — پورے کیبنٹ، ایک گروپ یا منتخب مہمات کے لیے۔ Pro اور Agency پلان پر دستیاب۔

گھنٹہ وار کارکردگی کا ڈیٹا — ہر مہم کا ہر گھنٹے ایک اسنیپ شاٹ، 30 دن تک رکھا جاتا ہے؛ لمبی مدت روزانہ کے مجموعوں سے دکھائی جاتی ہے۔ دن کے گھنٹوں کے حساب سے ہمارے پاس تمام کیبنٹ کی کوئی پیمائش نہیں، اس لیے اپنے گھنٹے ڈھونڈنے کے لیے اپنی ہی مہمات کا گھنٹہ وار چارٹ دیکھیں۔

تمام کیبنٹ کا اینالیٹکس — اینالیٹکس صفحہ ان تمام کیبنٹ کے ویوز، کلکس اور ایکشنز جمع کرتا ہے جن تک آپ کی رسائی ہے۔ خرچ کرنسی کے حساب سے الگ رہتا ہے: یورو، TON اور Stars کبھی آپس میں جمع نہیں کیے جاتے۔

تبدیلیوں کی تاریخ — مہم کے اسٹیٹس، بِڈ اور بجٹ کی ہر تبدیلی اس معلومات کے ساتھ درج ہوتی ہے کہ اسے کس نے یا کس چیز نے کیا — رولز اور Auto CPM بھی شامل۔

آٹومیشن ہکس

رولز اور خودکار ایکشنز ہر گھنٹے کے سنک کے بعد چلتے ہیں، بغیر اس کے کہ کوئی ڈیش بورڈ پر نظر رکھے:

IF/THEN رولز — شرطیں ویوز، کلکس، ایکشنز، CTR، CVR، خرچ، CPC، CPA، CPM اور بجٹ پر لگتی ہیں، اور ہر شرط پورے وقت پر یا پچھلے 1–168 گھنٹوں پر ناپی جاتی ہے۔ ایکشنز: روکنا، چالو کرنا، CPM مقرر کرنا، CPM کو کسی رقم یا فیصد سے بڑھانا یا گھٹانا، بجٹ شامل یا کم کرنا، یا صرف اطلاع دینا۔ مثال: اگر پچھلے 6 گھنٹوں میں CPM €2.50 سے اوپر ہے، تو بِڈ 15% کم کر دو۔ رول ایک مہم، ایک گروپ، کسی انتخاب یا پورے کیبنٹ پر لگ سکتا ہے۔

آپ کی اپنی کنورژنز پر رولز — جب آپ کا ٹریکر postbacks بھیجنے لگتا ہے تو وہی انجن لیڈز، کنورژنز، خریداریوں، ریونیو، ROAS، فی لیڈ لاگت اور فی فروخت لاگت پر بھی کام کر سکتا ہے۔ جو کیبنٹ postbacks نہیں بھیجتا، اسے ایسا رول کبھی نہیں روکتا: ڈیٹا نہ ہونا «نامعلوم» مانا جاتا ہے، صفر نہیں۔

کئی کیبنٹ کے لیے رولز کے ڈرافٹ — محفوظ کیا ہوا ڈرافٹ آپ کے ADSLY لاگ اِن پر رہتا ہے، اور کیبنٹ پر لاگو کریں (Apply to cabinets) اسے ہر نشان زد کیبنٹ میں کاپی کر دیتا ہے۔

Auto CPM — پینل گھنٹے میں ایک بار جانچتا ہے کہ اشتہار ان چینلز اور بوٹس میں واقعی دکھ رہا ہے یا نہیں جنہیں وہ ٹارگٹ کرتا ہے۔ زیادہ تر میں دکھ رہا ہے: بِڈ 10% کم ہوتی ہے۔ زیادہ تر میں نہیں دکھ رہا: 10% بڑھتی ہے۔ اس کے لیے لگاتار دو جانچوں کا ایک ہی نتیجہ چاہیے؛ دو تبدیلیوں کے درمیان تین گھنٹے کا وقفہ رہتا ہے اور ایک مہم پر دن میں زیادہ سے زیادہ چھ تبدیلیاں ہوتی ہیں۔

Recreate اور AI Recreate — مسترد اشتہار خودکار طور پر دوبارہ جمع ہوتا ہے؛ AI Recreate میں ہر کوشش پر ٹیکسٹ نئے الفاظ میں لکھا جاتا ہے۔ اس کے لیے ہم کوئی بحالی کا فیصد شائع نہیں کرتے۔

ایجنسیوں کے لیے انضمام کے استعمال

ان حصوں سے چار طرح کے سیٹ اپ بنتے ہیں:

کلائنٹ رپورٹنگ — ہر کلائنٹ کیبنٹ یا گروپ کی PDF یا Excel فائل ایکسپورٹ کریں، یا /v1/stats کو اس رپورٹنگ ٹول میں کھینچ لیں جو آپ پہلے سے استعمال کرتے ہیں۔

الرٹس — «اطلاع» ایکشن والا رول گھنٹہ وار ڈائجسٹ میں آتا ہے، جو Telegram، ای میل یا ایپ کے اندر پہنچتا ہے۔ آپ کے اپنے سسٹمز کے لیے status_change webhook اس وقت چلتا ہے جب کوئی مہم Declined، Active یا کسی اور اسٹیٹس میں جاتی ہے۔

اپنے ڈیش بورڈ — /v1/stats/total ہر کیبنٹ کے مجموعے اور چارٹ پوائنٹس لوٹاتا ہے؛ ایک عام سنک میں تین چار ریکویسٹس لگتی ہیں، جو ایک key کی 60 ریکویسٹس فی منٹ کی حد سے بہت کم ہے۔

ٹریکر کے ساتھ لوپ بند کرنا — لیڈز اور فروخت postback endpoint پر بھیجیں تو مہمات کا جدول Telegram کے اپنے کالموں کے ساتھ فی لیڈ اور فی فروخت لاگت دکھاتا ہے۔ پینل میں Keitaro، RedTrack، Binom اور Voluum کے لیے پیسٹ کرنے کے قابل تیار postback ٹیمپلیٹس ہیں۔

ADSLY REST API اور webhooks

API، Pro اور Agency اکاؤنٹس کے لیے فعال ہے۔ مینو میں API کھولیں، نئی key (+ New key) دبائیں اور چنیں کہ key کن کیبنٹس تک پہنچے گی — ایک، کئی یا سب — اور کیا وہ مہمات بھی سنبھال سکے گی۔ ایک وقت میں زیادہ سے زیادہ پانچ keys فعال رہ سکتی ہیں۔

بیس URL: https://app.adsly.pro/api/v1 · تصدیق: ہیڈر X-API-Key · حد: ہر key پر 60 ریکویسٹس فی منٹ

ہر key یہ پڑھ سکتی ہے:

• GET /v1/account/info — وہ کیبنٹ جو یہ key دیکھ سکتی ہے

• GET /v1/campaigns — مہمات اور ان کے میٹرکس؛ اسٹیٹس، عنوان، بوٹ یا چینل کے یوزرنیم، لینڈنگ پیج کے ڈومین اور اشتہار کی قسم کے فلٹر؛ cursor pagination

• GET /v1/stats — کسی مدت کے لیے ہر مہم کے اعداد و شمار، کیبنٹ کے حساب سے گروپ شدہ

• GET /v1/stats/total — ہر کیبنٹ کے مجموعے اور چارٹ پوائنٹس

• GET /v1/stats/analytics — ٹاپ مہمات کے ساتھ مدت کا اینالیٹکس

• GET /v1/campaigns/:adId/history — ایک مہم، ایک مدت میں

• GET /v1/conversions — postback سے ملی کنورژنز، مہم کے حساب سے

مہمات سنبھالیں (Manage campaigns)۔ جب تک آپ کسی key کے لیے یہ آپشن آن نہیں کرتے، وہ صرف پڑھتی ہے۔ آن کرنے پر key مہمات بنا بھی سکتی ہے (ایک کال میں 100 تک)، متن، لنک، CPM اور یومیہ حد بدل سکتی ہے، مہم روک کر دوبارہ چلا سکتی ہے، بجٹ ڈال سکتی ہے یا بچا ہوا بجٹ واپس لے سکتی ہے، کاپی کر سکتی ہے، ایک بار میں 1,000 تک مہمات پر بلک ایکشن چلا سکتی ہے، مہمات حذف کر سکتی ہے اور میڈیا اپ لوڈ کر سکتی ہے۔ کوئی بھی key کیبنٹ سے پیسہ باہر نہیں نکال سکتی: بجٹ صرف کیبنٹ کے بیلنس اور اس کی مہمات کے درمیان گھومتا ہے۔ API سے کی گئی ہر تبدیلی پینل میں مہم کی تاریخ میں نظر آتی ہے، اور بنانے، بجٹ، کاپی اور بلک والی کالز Idempotency-Key قبول کرتی ہیں — ٹائم آؤٹ کے بعد دوبارہ بھیجنے پر کام دو بار نہیں ہوتا۔

مکمل دستاویزات adsly.pro/docs/api پر ہیں (انگریزی میں)، ہر صفحے کے Markdown ورژن اور AI اسسٹنٹس کے لیے llms.txt انڈیکس کے ساتھ۔

پہلی بار انضمام کرنے والے دو جگہ اٹکتے ہیں۔ رقم والے فیلڈز (spent، budget، cpm، cpc، cpa، ctr) درستگی بچانے کے لیے اسٹرنگ کی صورت میں آتے ہیں، اس لیے حساب سے پہلے انہیں پارس کریں۔ اور ad_id صرف ایک کیبنٹ کے اندر منفرد ہے — Telegram آئی ڈیز دوبارہ استعمال کرتا ہے — اس لیے اسے ہمیشہ account_id کے ساتھ محفوظ کریں۔

Webhooks۔ key پر ایک Postback URL لگائیں تو ADSLY اس پر دستخط شدہ JSON بھیجتا ہے: سنک کے وقت کسی مہم کا اسٹیٹس بدلنے پر status_change، اور ہر گھنٹے کے پانچ منٹ بعد hourly_digest، جس میں ابھی بند ہوئے گھنٹے کے لیے ہر مہم کے ویوز، کلکس، خرچ اور ایکشنز ہوتے ہیں۔ ہر ریکویسٹ میں X-Adsly-Signature ہیڈر میں HMAC-SHA256 دستخط، ایک ٹائم اسٹیمپ اور ایک منفرد ڈیلیوری آئی ڈی ہوتی ہے۔ endpoint عوامی HTTPS ہونا چاہیے؛ ناکام ڈیلیوری ایک بار دہرائی جاتی ہے۔

کنورژنز کی وصولی۔ key پر postbacks وصول کریں (Receive postbacks) چالو کریں، پھر یا تو اپنے بیک اینڈ سے ہیڈر میں key کے ساتھ POST /v1/postback بھیجیں، یا ٹریکر URL بنائیں (Generate tracker URL) سے ملا صرف لکھنے والا URL اپنے ٹریکر کو دیں۔ ایونٹس lead، conversion اور purchase ہیں، رقم اور کرنسی اختیاری؛ ایک ریکویسٹ میں 1,000 تک ایونٹس آ سکتے ہیں اور ایک key ہر سیکنڈ 20 ایونٹس لیتی ہے۔ ایونٹ اپنی مہم سے اس ویلیو کے ذریعے ملایا جاتا ہے جو اشتہار کے لنک میں جاتی ہے: بوٹ اشتہارات میں ?start= پیرامیٹر، ویب سائٹ اشتہارات میں آپ کے ٹریکر کا پیرامیٹر۔

سیکیورٹی اور رسائی

ان کیبنٹ میں اصل بجٹ ہوتا ہے، اس لیے ہر راستہ جان بوجھ کر تنگ رکھا گیا ہے:

پاس ورڈ نہیں، سیشن — Telegram Ads کیبنٹ Telegram میں درخواست کی تصدیق سے، براؤزر ایکسٹینشن سے یا سیشن ٹوکن سے جڑتا ہے۔ کنکشن اشتہاری کیبنٹ تک محدود ہے، آپ کے ذاتی Telegram تک نہیں۔

ڈیفالٹ طور پر صرف پڑھنے والی، ہیش میں محفوظ keys — جب تک مالک مہمات سنبھالیں آن نہ کرے، key صرف پڑھتی ہے، اور آن ہونے پر بھی کیبنٹ سے پیسہ نہیں نکال سکتی۔ keys SHA-256 ہیش کی صورت میں رکھی جاتی ہیں، اس لیے کھوئی ہوئی key واپس نہیں مل سکتی — اسے صرف منسوخ کر کے نئی بنائی جا سکتی ہے۔

دستخط شدہ webhooks — HMAC دستخط جانچیں اور جن ریکویسٹس کا ٹائم اسٹیمپ پانچ منٹ سے پرانا ہو، انہیں مسترد کر دیں۔ ADSLY بغیر HTTPS والے، loopback یا پرائیویٹ پتوں پر ڈیلیوری نہیں کرتا۔

کیبنٹ کے حساب سے ٹیم کی رسائی — Agency پلان پر ٹیم کے ہر رکن کے لیے ہر کیبنٹ پر تین میں سے ایک سطح طے ہوتی ہے: Viewer، Manager یا بغیر رسائی۔ ارکان اپنی API keys خود بناتے ہیں، اور key صرف انہی کیبنٹس تک پہنچتی ہے جو اس رکن کے ساتھ شیئر کیے گئے ہیں: جہاں وہ Viewer ہے وہاں صرف پڑھنا، جہاں Manager ہے وہاں تبدیلیاں بھی۔

اپنے Telegram Ads ورک فلو کو خودکار بنائیں۔ ADSLY 500,000+ مہمات سنبھالتا ہے — اور Euro کیبنٹ کسی بھی ملک کے لیے کھلتا ہے۔ کیبنٹ کی تینوں اقسام (TON، Euro، Stars)۔ IF/THEN رولز، بلک آپریشنز، اعداد و شمار اور مہمات کے انتظام کے لیے API، webhooks اور ایکسپورٹ۔ مفت شروع کریں — 3 دن کا Pro ٹرائل →

اکثر پوچھے جانے والے سوالات

کیا Telegram Ads کا کوئی عوامی API ہے؟

مشتہرین کے لیے نہیں۔ Telegram کی ڈویلپر سائٹ پر Bot API، کلائنٹ API، TDLib، Gateway API اور Payments API درج ہیں (اکتوبر 2026 میں دیکھا گیا)؛ ان میں سے کوئی بھی اشتہاری مہمات نہیں سنبھالتا، اور Sponsored Messages سیکشن ان ایپس کے لیے ہے جو اشتہار دکھاتی ہیں۔ ads.telegram.org کا اشتہاری پلیٹ فارم ویب انٹرفیس سے چلتا ہے۔ ADSLY اس کے اوپر ایک مجاز سیشن کے ذریعے کام کرتا ہے۔

ADSLY میرے Telegram Ads کیبنٹ سے کیسے جڑتا ہے؟

اس Telegram اکاؤنٹ کے سیشن کے ذریعے جس کے پاس اشتہاری کیبنٹ ہے۔ آپ فون نمبر درج کرنے کے بعد Telegram میں درخواست کی تصدیق کرتے ہیں، براؤزر ایکسٹینشن استعمال کرتے ہیں یا سیشن ٹوکن پیسٹ کرتے ہیں۔ درخواست صرف اشتہاری کیبنٹ کو جوڑتی ہے۔ Euro، TON اور Stars کیبنٹ اسی طرح جڑتے ہیں؛ Adstat سے آئے کیبنٹ Adstat لاگ اِن سے جڑتے ہیں۔

کیا میرا Telegram Ads ڈیٹا ADSLY کے پاس محفوظ ہے؟

انضمام کے راستے ڈیزائن ہی سے تنگ ہیں۔ API keys تب تک صرف پڑھتی ہیں جب تک آپ مہمات سنبھالیں آن نہ کریں، کبھی بھی کیبنٹ سے پیسہ نہیں نکال سکتیں اور ہیش کی صورت میں رکھی جاتی ہیں؛ API سے ہوئی ہر تبدیلی مہم کی تاریخ میں درج ہوتی ہے؛ webhooks ہر key کے اپنے سیکرٹ سے دستخط ہوتے ہیں اور صرف عوامی HTTPS endpoints پر جاتے ہیں؛ ٹریکر کا صرف لکھنے والا URL کنورژنز بھیج سکتا ہے مگر کچھ پڑھ نہیں سکتا؛ اور Agency پلان پر رسائی ہر کیبنٹ اور ہر فرد کے حساب سے دی جاتی ہے۔

کیا میں Telegram Ads کا ڈیٹا Google Sheets میں ایکسپورٹ کر سکتا ہوں؟

Google Sheets کا کوئی براہ راست کنیکٹر نہیں۔ پینل سے CSV یا Excel فائل ایکسپورٹ کر کے اسے امپورٹ کریں، یا کسی اسکرپٹ سے API پڑھیں — /v1/stats کسی بھی مدت کے لیے ہر مہم کے اعداد لوٹاتا ہے۔

کیا ADSLY، Telegram Ads کے لیے webhooks سپورٹ کرتا ہے؟

جی ہاں۔ Postback URL والی key کو مہم کا اسٹیٹس بدلنے پر ہر بار status_change ملتا ہے، اور گھنٹے میں ایک بار hourly_digest، جس میں ہر مہم کے ویوز، کلکس، خرچ اور ایکشنز ہوتے ہیں۔ دونوں HMAC-SHA256 سے دستخط ہوتے ہیں، اور key پر Test بٹن ایک ping بھیجتا ہے تاکہ آپ اپنا ریسیور جانچ سکیں۔

کیا ADSLY REST API ابھی دستیاب ہے؟

جی ہاں، Pro اور Agency پلان پر، اور keys آپ پینل میں خود بناتے ہیں۔ ہر key کیبنٹ کی فہرست، مہمات، اعداد و شمار، اینالیٹکس، ہر مہم کی تاریخ اور موصول شدہ کنورژنز پڑھتی ہے — ہر key پر 60 ریکویسٹس فی منٹ۔ جس key میں مہمات سنبھالیں آن ہو، وہ مہمات بنا، بدل، روک اور دوبارہ چلا سکتی ہے، ان میں بجٹ ڈال سکتی ہے، انہیں کاپی اور حذف کر سکتی ہے، اور میڈیا اپ لوڈ کر سکتی ہے۔ دستاویزات: adsly.pro/docs/api۔