پیغام رسانی کی مہم غیر فعال کریں

پیغام رسانی کی موجودہ مہم غیر فعال کریں

جب اکاؤنٹ کی ملکیت والی کسی مہم کا استعمال ختم کیا جا رہا ہو تو یہ راستہ استعمال کریں۔ ریکارڈ کا حساب ملانے اور سابقہ معلومات محفوظ رکھنے کے لیے مہم کا شناخت کنندہ محفوظ رکھیں۔ مواد کی اصلاح یا رضامندی کے متن میں تبدیلی کے لیے پیغام رسانی کی مہم کو اپ ڈیٹ کرنے کا طریقہ اس کے بجائے استعمال کریں۔

کسی اجازت یافتہ ماخذ IP پتے سے HTTPS کے ذریعے فعال API اکاؤنٹ استعمال کرتے ہوئے اپنی شناخت کی تصدیق کرائیں۔ پہلے مہم کی تفصیلات حاصل کریں اور متعلقہ برانڈ اور پیغامات بھیجنے والے نمبروں کی جانچ کریں۔ غیر فعال کرنے سے رجسٹریشن تبدیل ہوتی ہے؛ اس سے متبادل مہم نہیں بنتی اور نہ ہی نمبر کسی دوسری مہم میں منتقل ہوتے ہیں۔

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/campaign/$CAMPAIGN_ID"

پہلے متاثرہ نمبروں کی وابستگیاں ختم کریں

مہم کی عوامی DELETE کارروائی فون نمبروں کو پیغام رسانی کے آپریٹر سے الگ نہیں کرتی اور نہ ہی ان کی مقامی وابستگی ختم کرتی ہے۔ اس مقصد کے لیے نمبر کی مہم سے وابستگی ختم کرنے کا طریقہ اکاؤنٹ کی ملکیت والے ہر متاثرہ نمبر کے لیے استعمال کریں، پھر اس کی وابستگی کی تصدیق کریں۔ وابستگی ختم کرنے سے فون نمبر کی ملکیت یا کرایے کا حق ترک نہیں ہوتا۔

پورٹل میں برانڈ حذف کرنے کا زیادہ جامع طریقہ، برانڈ حذف کرنے سے پہلے اس کی مہموں اور نمبروں کی صفائی کرتا ہے۔ اگر آپ برانڈ اور اس کی دوسری مہمیں برقرار رکھنا چاہتے ہیں تو یہ کارروائی استعمال نہ کریں۔ موجودہ عام مہم ایڈیٹر میں مہم حذف کرنے کا ایسا الگ بٹن موجود نہیں جو اس براہ راست API راستے کے برابر ہو۔

مطلوبہ مہم غیر فعال کرنے کی درخواست بھیجیں

مہم کے شناخت کنندہ اور پیغامات بھیجنے کی متاثرہ ترتیبات کا جائزہ لینے کے بعد، JSON باڈی کے بغیر DELETE بھیجیں:

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/campaign/$CAMPAIGN_ID"

دستاویزات کے مطابق کامیاب جواب HTTP 204 ہے، جس کی باڈی خالی ہوتی ہے۔ JSON کی status/response ساخت کی توقع کرنے کے بجائے HTTP کی حیثیت جانچیں۔ حذف کرنے کی درخواست قبول ہونے پر موجودہ سروس مقامی طور پر مہم کے وسیلے کو حذف شدہ اور میعاد ختم شدہ قرار دیتی ہے، اور پرانے نظام میں اس مہم کے ریکارڈ کو بھی میعاد ختم شدہ قرار دیتی ہے۔ یہ حذف کرنے کی کارروائی برانڈ تک نہیں پھیلتی۔

اس مطلوبہ درخواست کے لیے ایک ہی ایڈیم پوٹینسی کلید استعمال کریں اور دوبارہ بھیجنے کے لیے طریقہ، راستہ، کوئری اور باڈی کے بائٹس بعینہٖ محفوظ رکھیں۔ اگر اصل درخواست ابھی زیر کارروائی ہو تو اس کی نقل Retry-After کے ساتھ 409 لوٹا سکتی ہے؛ مکمل ہو چکی درخواستوں کے لیے محفوظ شدہ نتیجہ دوبارہ لوٹایا جا سکتا ہے۔ کیش میں محفوظ خرابی یا رابطہ منقطع ہونے سے یہ ثابت نہیں ہوتا کہ رجسٹری پہلے ہی کارروائی کر چکی ہے یا نہیں۔ مہم کا شناخت کنندہ اور، اگر موجود ہو، requestId محفوظ رکھیں۔

رجسٹریشن اور وابستگیوں، دونوں کی تصدیق کریں

درخواست کے بعد پورٹل میں مہم کی موجودہ حالت اور متاثرہ نمبر جانچیں۔ API استعمال ختم ہونے کے بعد بھی ملکیت سے متعلق مقامی میٹا ڈیٹا محفوظ رکھ سکتی ہے، تاکہ اکاؤنٹ کی ملکیت والے شناخت کنندہ کی جانچ اب بھی کی جا سکے؛ یہ نتیجہ اخذ نہ کریں کہ اسی شناخت کنندہ سے ہمیشہ مقامی 404 ہی ملنا چاہیے۔ استعمال سے ہٹائے گئے ریکارڈ کی دستیابی یا واپس ملنے والی حیثیت کا فیصلہ رجسٹری کرتی ہے۔

اگر کوئی نمبر اب بھی وابستہ ہو تو اس موجودہ وابستگی کا ریکارڈ ملا کر درست کریں۔ محض غیر فعال کرنے کی دوبارہ کوشش کے لیے دوسری مہم نہ بنائیں، اور یہ فرض نہ کریں کہ HTTP 204 سے آپریٹر کے ہاں صفائی ہو جانے کا ثبوت ملتا ہے۔ اگر رجسٹری کے درخواست قبول کرنے کے بعد مقامی ہم وقت سازی ناکام ہو جائے تو API سے 500 مل سکتا ہے، حالانکہ بیرونی نظام میں مہم پہلے ہی غیر فعال ہو چکی ہو۔

استعمال ختم کرنا اکاؤنٹ کے مالی تصفیے سے الگ ہے

موجودہ DELETE سروس مہم کی رجسٹریشن کے لیے فوری رقم کاٹنے کی ہدایت نہیں بھیجتی۔ اس سے رقم کی واپسی کا وعدہ نہیں ہوتا، کوئی موجودہ مالی ذمہ داری ختم نہیں ہوتی اور نہ ہی کرایے پر لیے گئے نمبر واپس کیے جاتے ہیں۔ پورٹل میں اکاؤنٹ کی مہم سے متعلق شرائط اور غیر ادا شدہ بل جانچیں۔ نمبروں کا کرایہ اور پیغامات کا استعمال مہم کی رجسٹریشن سے الگ ہیں۔

اگر مہموں اور وابستگیوں کے ریکارڈ کا حساب ملانے کے بعد کاروبار کی پوری رجسٹریشن کا استعمال ختم کیا جا رہا ہو تو اگلا مرحلہ ہے: برانڈ کا استعمال ختم کرنا۔