سجّل حملة 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 الخاص بك.

تنص البوابة الحالية على حد أدنى من الالتزام لمدة ثلاثة أشهر لحملات الإنتاج غير السياسية. راجع الشروط المنطبقة وخيار التجديد قبل التأكيد. ويُعد التسجيل واستئجار الرقم والتدقيق الإضافي واستخدام الرسائل رسوما منفصلة. ولا تثبت استجابة الإنشاء الناجحة وحدها أن كل خطوات الفوترة أو تفعيل الناقل قد اكتملت.

معالجة أخطاء التحقق والفشل الجزئي

اقرأ status الخاص بـ HTTP وJSON المعاد. وقد تكون أخطاء التحقق مصفوفات من كائنات code/description؛ وقد تكون الأخطاء المحلية بدلا من ذلك كائنات تحتوي على message وstatus، ولبعض أخطاء المعالجة requestId.