10DLC مہم رجسٹر کریں

اس کی مہم رجسٹر کرنے سے پہلے برانڈ کو اہل بنائیں

10DLC مہم ان پیغامات کو بیان کرتی ہے جو ایک رجسٹرڈ کاروبار بھیجنے کا ارادہ رکھتا ہے, وصول کنندگان کس طرح رضامندی دیتے ہیں اور وہ کس طرح مدد حاصل کر سکتے ہیں یا پیغامات بند کر سکتے ہیں. یہ API رجسٹری ریکارڈ بناتا ہے; پروڈکشن کیریئر ایکٹیویشن مکمل کرنا اکاؤنٹ سیٹ اپ کا الگ مرحلہ ہے. اپنی ملکیت کا ایک برانڈ استعمال کریں جو برانڈ رجسٹریشن سے حاصل کیا گیا ہو, پھر لوڈ کریں اس کی دستیاب استعمال کی صورتیں اور منتخب استعمال کی صورت کی موجودہ ضروریات.

موجودہ اہلیت کے نتیجے کو ذیلی استعمال کی صورتیں, اہل نیٹ ورک شناخت کنندگان, پیغام کے نمونے اور آپٹ ان/آؤٹ/ہیلپ اعلانات منتخب کرنے کے لیے استعمال کریں. شرائط برانڈ اور نیٹ ورک کے لحاظ سے مختلف ہو سکتی ہیں. مثال کے شناخت کنندگان جمع نہ کروائیں یا مختلف عمل والے کاروبار کے لیے اس کی رضامندی کی وضاحت نقل نہ کریں.

سینڈ باکس اور پروڈکشن کو الگ رکھیں

سینڈ باکس مشق کے لیے, اپنا فرضی برانڈ اور ایک موجودہ استعمال کی صورت استعمال کریں جس کے لیے وہ اہل ہو. TRIAL صرف اس وقت استعمال کریں جب وہ اہلیت اسے پیش کرے. پورٹل جانچتا ہے کہ منتخب برانڈ اور مہم کا ماحول متفق ہیں. براہ راست API درخواست آپ کے لیے پورٹل کی مکمل وزرڈ توثیق نہیں چلاتی, اس لیے اپنے انضمام میں اس علیحدگی کو برقرار رکھیں.

پروڈکشن مہم کی تخلیق قابل بل ہے اور خودکار طور پر کسی نمبر کو بھیجنے کے لیے تیار نہیں کرتی. مہم کے ماحول کو اس کے برانڈ کے مطابق رکھیں, اور لائیو مہم بنانے سے پہلے فیس اور قابل اطلاق شرائط کا جائزہ لیں.

مہم کا JSON جمع کروائیں

campaign.json کو اپنی اہل اقدار کے ساتھ تیار کریں. R000000 کا مطلب ہے کوئی ری سیلر نہیں; اسے صرف اس وقت استعمال کریں جب یہی مطلوبہ ترتیب ہو. عام MultiTEL ری سیلر ترتیب کے لیے, اپنے اکاؤنٹ کے ری سیلر مجموعے یا پورٹل تیاری کے بہاؤ سے اجازت یافتہ MultiTEL LLC ری سیلر شناخت کنندہ حاصل کریں بجائے کسی اور کے شناخت کنندہ کو ہارڈ کوڈ کرنے کے.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  'https://api.multitel.net/tcr/v2/reseller?companyName=MultiTEL%20LLC&recordsPerPage=500'

درج ذیل JSON آپ کی ملکیت کے فرضی برانڈ کے لیے آزمائشی مہم کی وضاحت کرتا ہے. برانڈ, استعمال کی صورت, ری سیلر اور رضامندی کے متن کو ان اقدار سے بدل دیں جو واقعی آپ کے ٹیسٹ کے لیے اہل ہوں.

{
  "brandId": "B123ABC",
  "channelId": "10DLC",
  "usecase": "TRIAL",
  "subUsecases": [],
  "resellerId": "R000000",
  "description": "Trial account notices requested by users of the example application.",
  "messageFlow": "Test users explicitly select an unchecked consent box before requesting these trial notices.",
  "sample1": "Example application: your requested account notice is available. Reply STOP to stop notices.",
  "subscriberOptin": true,
  "optinKeywords": "START",
  "optinMessage": "You are subscribed to the example application's requested account notices.",
  "subscriberOptout": true,
  "optoutKeywords": "STOP",
  "optoutMessage": "You will no longer receive the example application's account notices.",
  "subscriberHelp": true,
  "helpKeywords": "HELP",
  "helpMessage": "For help with example account notices, contact support@example.invalid.",
  "embeddedLink": false,
  "embeddedPhone": false,
  "numberPool": false,
  "ageGated": false,
  "directLending": false,
  "termsAndConditions": true,
  "autoRenewal": false,
  "mnoIds": [],
  "referenceId": "your-trial-reference"
}

termsAndConditions کو true پر صرف اس وقت سیٹ کریں جب مجاز شخص نے قابل اطلاق شرائط کا جائزہ لے لیا ہو اور انہیں قبول کر لیا ہو. مثال آپ کی طرف سے رضامندی نہیں ہے. جھنڈوں کے لیے JSON بولین استعمال کریں, اقتباس شدہ سٹرنگز نہیں.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @campaign.json \
  'https://api.multitel.net/tcr/v2/campaignBuilder'

مہم کے فیلڈز اور مشروط شرائط

شائع شدہ اسکیما میں وضاحتی جدولوں میں کچھ متضاد بڑے حروف ہیں. موجودہ پورٹل درخواست subscriberOptin اور subscriberOptout استعمال کرتی ہے جیسا کہ اوپر دکھایا گیا ہے. اسی درست کیسنگ کو برقرار رکھیں. یہ گائیڈ اکاؤنٹ کے صارفین کے لیے 10DLC ورک فلو کا احاطہ کرتی ہے; یہ اندازہ نہ لگائیں کہ مختلف چینل کے مطلوبہ فیلڈز یا ایکٹیویشن مراحل وہی ہیں.

اسی مطلوبہ درخواست کو محفوظ طریقے سے دوبارہ آزمائیں

اس مطلوبہ تخلیق کے لیے ایک Idempotency-Key استعمال کریں. کلید 1–128 قابل طباعت ASCII حروف بغیر خالی جگہوں کے ہے اور مالک اکاؤنٹ تک محدود ہے. دوبارہ کوشش پر HTTP طریقہ, راستہ, استفسار سٹرنگ اور درست باڈی بائٹس کو تبدیل نہ کریں. دوبارہ فارمیٹ شدہ JSON فائل متصادم ہوتی ہے چاہے اس کی اقدار مساوی ہوں.

جاری نقل HTTP 409 کے ساتھ Retry-After واپس کر سکتی ہے; مکمل درخواستیں اپنا محفوظ شدہ جواب دوبارہ چلا سکتی ہیں. کیچ شدہ خرابی ثابت نہیں کرتی کہ رجسٹری نے کچھ نہیں بنایا. نئی کلید پر غور کرنے سے پہلے campaignId, requestId اور کوئی ارتباط ہیڈرز محفوظ کریں, موجودہ مہم کا معائنہ کریں اور اصل حالت کی جانچ کر کے جزوی ناکامی کے نتیجے میں پیدا ہونے والے اختلافات دور کریں.

مہم کی شناخت حتمی ترسیلی سیٹ اپ نہیں ہے

جواب HTTP حیثیت اور براہ راست JSON استعمال کرتا ہے. کامیاب تخلیق پر, campaignId رکھیں اور اس کی موجودہ حالت پڑھیں:

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

موجودہ پورٹل کا پروڈکشن ورک فلو مہم کو پیغام رسانی کیریئر کے ساتھ بھی شیئر کرتا ہے اور برانڈ/مہم کو بھیجنے والے اکاؤنٹ میں لوڈ کرتا ہے. یہ اس عوامی تخلیق کال سے الگ کارروائیاں ہیں. رجسٹری مہم موجود ہو سکتی ہے چاہے بعد میں شیئرنگ یا کیریئر لوڈنگ مرحلہ ناکام ہو جائے.

پورٹل کے مربوط پروڈکشن تخلیق ورک فلو کو استعمال کریں جب آپ کو مشترکہ رجسٹریشن, شیئرنگ اور کیریئر لوڈنگ ترتیب کی ضرورت ہو. اس API کے ذریعے براہ راست پہلے سے بنائی گئی پروڈکشن مہم کے لیے, اس کی مہم شناخت برقرار رکھیں اور اکاؤنٹ کے کیریئر سیٹ اپ کو معاونت کے ذریعے ہم آہنگ کروائیں. موجودہ کسٹمر انٹرفیس ہر براہ راست بنائی گئی پروڈکشن مہم کے لیے عام ریزیوم بٹن ظاہر نہیں کرتا. اس کی ایکٹیویشن کی دوبارہ کوشش کے لیے دوسری رجسٹریشن نہ بنائیں. بھیجنے والا نمبر تفویض کرنے سے پہلے تصدیق کریں کہ مہم فعال ہے اور کیریئر سیٹ اپ مکمل ہو چکا ہے. نمبر بھی ملکیتی, فعال اور SMS فعال ہونا چاہیے. مہم کی تخلیق پیغامات نہیں بھیجتی.

پروڈکشن مہم فیسیں

یہ خوردہ رقوم 24 اکتوبر 2026 کو موجودہ پورٹل ترتیب کے خلاف جانچی گئیں. پروڈکشن جمع کروانے سے پہلے موجودہ اہل استعمال کی صورت اور ظاہر قیمت کی تصدیق کریں. رجسٹری اہلیت جواب میں monthlyFee خودکار طور پر آپ کی MultiTEL خوردہ قیمت نہیں ہے.

موجودہ پورٹل غیر سیاسی پروڈکشن مہموں کے لیے تین ماہ کے کم از کم عہد کا کہتا ہے. تصدیق سے پہلے قابل اطلاق شرائط اور تجدید انتخاب کا جائزہ لیں. رجسٹریشن, نمبر کرایہ, اضافی جانچ اور پیغام استعمال الگ چارجز ہیں. کامیاب تخلیق جواب آزادانہ طور پر ثابت نہیں کرتا کہ ہر بلنگ یا کیریئر ایکٹیویشن مرحلہ مکمل ہو چکا ہے.

توثیق اور جزوی ناکامیوں کو سنبھالیں

HTTP status اور واپس شدہ JSON پڑھیں. توثیقی ناکامیاں code/description آبجیکٹس کی صفیں ہو سکتی ہیں; مقامی ناکامیاں اس کے بجائے message, status اور, کچھ پروسیسنگ خرابیوں کے لیے, requestId کے ساتھ آبجیکٹس ہو سکتی ہیں.