تسجيل علامة تجارية للمراسلة

سجّل النشاط التجاري الذي يقف وراء رسائلك

تحدد علامة المراسلة التجارية النشاط التجاري الذي يرسل رسائل US 10DLC. سجّل العلامة التجارية قبل اختيار حالة استخدام الحملة. استخدم البيانات القانونية للنشاط التجاري وجهة اتصال يمكنها إكمال أي تحقق مطلوب. إن معرف العلامة التجارية المعاد ليس وحده موافقة على إرسال الرسائل.

استخدم مسار الحساب الحالي المملوك للحساب عبر HTTPS مع حساب API ممكن وعنوان IP المصدر المسموح به. لا ترسل user_id أو username أو معرف مالك لعميل آخر. تسجل MultiTEL الملكية من الحساب المصادق على هويته.

ابدأ بطلب صريح لوضع الحماية

يُضبط الحقل mode في نموذج البوابة افتراضيا على وضع الحماية؛ ويجب أن يتضمن طلب API المباشر صراحة القيمة المنطقية JSON وهي mock: true عندما تنوي إنشاء علامة وهمية. إن إغفال تلك العلامة ليس ضمانا لوضع الحماية وقد ينشئ تسجيل إنتاج قابلا للفوترة. وحقل mode في البوابة ليس بديلا عن حقل mock في API.

جهز ملف brand.json محليا باستخدام الحقول أدناه. استبدل العناصر النائبة بتفاصيل اختبار مناسبة ورموز الفهرس الحالية. هذا المثال نشاط تجاري خاص هادف للربح؛ ولأنواع الكيانات الأخرى متطلبات مختلفة.

{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "Example business",
  "companyName": "Example legal business name",
  "ein": "YOUR_TAX_ID",
  "einIssuingCountry": "US",
  "phone": "+12025550123",
  "street": "123 Example Street",
  "city": "Example City",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "contact@example.invalid",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "CURRENT_VERTICAL_CODE",
  "referenceId": "your-business-reference",
  "mock": true
}

إن النشاط التجاري والعنوان والهاتف والمعرف أعلاه عناصر نائبة وليست هوية تجارية جاهزة للتسجيل. احصل على القيم الحالية لـ entityType وvertical وcountry وstate وbrandRelationship والتعدادات الأخرى من فهارس المراسلة.

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

حقول النشاط التجاري وجهات الاتصال

حقول تسجيل العلامة التجارية
الحقول	ما يجب تقديمه
entityType, displayName	رمز نوع الكيان الحالي واسم العلامة التجارية المعروف. الحد الأقصى للطول هو 20 و255 حرفا على التوالي.
country, street, city, state, postalCode	عنوان النشاط التجاري الفعلي. استخدم رمز البلد المكون من حرفين ورمز US الحالي لـ state عند الاقتضاء. الحدود: street 255 وcity 100 وstate 20 وpostalCode 10 أحرف.
email, phone	بريد إلكتروني صالح لجهة الاتصال حتى 100 حرف ورقم هاتف بالتنسيق الدولي مع رمز البلد + حتى 20 حرفا. حافظ على اتساق تفاصيل النشاط التجاري في جميع أنحاء التسجيل.
companyName, ein, einIssuingCountry	بالنسبة للمؤسسات، قدم الاسم القانوني للشركة والمعرف الضريبي للنشاط التجاري. إن بلد إصدار المعرف حقل منفصل من حرفين. الحدود: companyName 255 وein 21 حرفا. ويستخدم المالك الفردي حقول الاسم الشخصي بدلا من الهوية الضريبية للمؤسسة.
brandRelationship, vertical	العلاقة بالنشاط التجاري ومجاله باستخدام رموز الفهرس الحالية. تشترطها المؤسسات؛ أما قواعد المالك الفردي فتختلف. لا تستبدل رموز API بتسميات العرض المترجمة.
firstName, lastName, mobilePhone	مطلوبة للمالك الفردي. تسمح حقول الاسم بما يصل إلى 100 حرف لكل منها. قدم رقم هاتف محمول مؤهلا للتحقق المطلوب عبر OTP بالتنسيق الدولي.
stockSymbol, stockExchange, website, businessContactEmail	تحتاج الشركة المدرجة في البورصة أيضا إلى رمز الأسهم/البورصة وwebsite وبريد إلكتروني مؤهل لجهة الاتصال التجارية لعملية التحقق الإضافية. الحدود: stockSymbol 10 وwebsite 255 وbusinessContactEmail 255 حرفا.
altBusinessIdType, altBusinessId	معرف تجاري بديل اختياري. قدم نوعه وقيمته معا. استخدم فهرس الأنواع الحالي؛ وتسمح القيمة بما يصل إلى 50 حرفا.
referenceId	مرجع نشاطك التجاري حتى 50 حرفا. أدرجه لتسجيل المالك الفردي بموجب المتطلبات الحالية الخاصة بالكيان. وهو بيانات وصفية تجارية وليس مفتاح عدم التكرار الخاص بالطلب.
website, ipAddress, tag	قيم إضافية لموقع الويب والبيانات الوصفية لعنوان IP المصدر والوسوم عند الاقتضاء. وهي لا تثبت ملكية الحساب ولا تحل محل فحوص الهوية.
mock	قيمة منطقية JSON. استخدم true فقط لسير العمل الوهمي المقصود؛ واستخدم false لتسجيل الإنتاج الذي تمت مراجعته صراحة. لا ترسل السلسلة "false" بديلا عن قيمة JSON المنطقية.

يُدعم المالكون الأفراد لتسجيلات US أو كندا ويحتاجون إلى التحقق عبر OTP قبل الأهلية للحملة. وقد تتطلب الشركات المدرجة في البورصة خطوة تحقق لجهة الاتصال التجارية. إن GOVERNMENT مخصص للكيانات الحكومية التي مقرها US؛ فتأكد من فئة الكيان الصحيحة للمؤسسات الأخرى. اتبع المتطلبات الخاصة بالكيان وكذلك أخطاء التحقق المعادة.

حافظ على مفتاح ثابت لعدم التكرار

أنشئ Idempotency-Key واحدا لهذا التسجيل المقصود. يجب أن يحتوي على 1–128 حرفا ASCII قابلا للطباعة دون مسافات. أعد استخدام المفتاح نفسه فقط مع طريقة HTTP نفسها والمسار وسلسلة الاستعلام وبايتات متن الطلب نفسها تماما. إن إعادة تنسيق JSON حتى دون تغيير معناه تغير بصمة الطلب.

يمكن لطلب مكتمل بمفتاح أن يعيد تشغيل استجابته المخزنة دون تقديم تسجيل آخر. أما الطلب المكرر الذي لا يزال قيد المعالجة فيعيد HTTP 409 وقد يتضمن Retry-After. ويتعارض الطلب المغاير مع المفتاح نفسه. لا تنشئ مفتاحا جديدا لمجرد انتهاء مهلة الطلب أو إعادته خطأ: فقد يكون النشاط التجاري قد سجل بالفعل.

أبق brand.json دون تغيير أثناء حل ذلك الطلب. قد يعيد الخطأ المخزن مؤقتا 500 أو 502 تشغيل الخطأ الأصلي بدلا من إعادة محاولة التسجيل. احتفظ بأي brandId وrequestId معادين وترويسات الارتباط؛ وراجع الحالة الفعلية للعلامة التجارية الحالية وعالج أي اختلافات قبل بدء طلب مختلف.

اقرأ العلامة التجارية وحالتها

تستخدم واجهة API هذه رموز حالة HTTP ومتنا JSON مباشرا بدلا من مغلف v3 status/response. يعيد التسجيل الناجح كائن علامة تجارية يتضمن brandId. خزن ذلك المعرف وافحص حالة التحقق أو الهوية المعادة. وتعتمد الحقول الإضافية على الكيان وحالة التسجيل.

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

اقرأ فقط علامة تجارية تخص حسابك. قد يعني الخطأ 404 أن العلامة التجارية غير متاحة لهذا الحساب. أكمل أي تحقق مطلوب ثم استخدم تأهيل العلامة التجارية للعثور على حالات استخدام الحملات المتاحة لها. ولا يمكن افتراض أن الموارد الوهمية مؤهلة للإرسال الإنتاجي.

رسوم الإنتاج

رسوم تسجيل العلامات التجارية المهيأة الحالية
التسجيل	الرسم
مؤسسة قياسية	$5.00
مالك فردي	$4.45
علامة وهمية	لا خصم لتسجيل العلامة التجارية في سير العمل الوهمي

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

إن تغيير علامة وهمية إلى إنتاج سير عمل مؤكد بشكل منفصل وقد ينشئ هوية إنتاج ورسما جديدين. لا تفترض أن تحرير mock إلى false في طلب لاحق يحول العلامة التجارية الحالية.

عالج الأخطاء دون تكرار العلامة التجارية

حالات فشل التسجيل
نتيجة HTTP	ما يجب التحقق منه
400	اقرأ أخطاء الحقول. قد تكون أخطاء التحقق في السجل مصفوفة من كائنات code/description. وقد يعيد التحقق المحلي لمفتاح عدم التكرار 400 أيضا.
401, 403 أو 404	تحقق من بيانات اعتماد API وعنوان IP المصدر المسموح به لحساب API وأذونات العملاء والملكية. وقد تحمل استجابة السجل أيضا خطأ تخويل خاصا بها.
402	راجع التمويل وإذن الشراء. لا تعامل طلب الإنتاج غير الممول كاختبار في وضع الحماية.
409	احتفظ بالمفتاح نفسه والطلب دون تغيير أثناء انتظار طلب قيد التنفيذ. عند تعارض النص المغاير أو المفتاح، أو تعذر استرداد استجابة سابقة، يجب أولا مراجعة الحالة الفعلية للطلب ومعالجة أي اختلافات.
429 أو استجابة عدم توفر المحدد	احترم Retry-After عند وجوده. أعد محاولة الطلب المقصود نفسه والمفتاح بعد زوال الحد.
500 أو 502	ربما تم قبول العملية البعيدة. وقد يتضمن خطأ المعالجة المحلية requestId. احفظه وتحقق من المورد الحالي؛ ولا تفترض أن تسجيلا بديلا لازم.