شراء الأرقام وتسجيل الرسائل النصية عبر الـ API

يمكن للـ API البحث عن أرقام الهواتف المتاحة للشراء، وشرائها، وتسجيل عملك لرسائل 10DLC النصية — بنفس الفواتير والمتطلبات والنتائج تمامًا كما هو الحال عند القيام بذلك في التطبيق. يظهر الرقم الذي تم شراؤه عبر POST /v1/api/numbers في الإعدادات ← الأرقام على الفور، ويظهر التسجيل المقدم عبر الـ API في بطاقة إعداد الرسائل النصية، بحيث يمكنك التدخل وإدارة أي منهما من التطبيق في أي وقت.

قبل أن تبدأ

• يحتاج مفتاح الـ API الخاص بك إلى نطاق numbers:manage — شريحة شراء الأرقام و10DLC في الإعدادات ← Developer API. تتضمن مفاتيح الوصول الكامل هذا تلقائيًا. راجع الحصول على مفتاح Ody API الخاص بك.
• تنطبق نفس القواعد كما في التطبيق: تحتاج مساحة عملك إلى خطة نشطة للشراء، وإذا طلب منك Ody التحقق من هويتك، فيجب إكمال ذلك أولاً — يُرجع الـ API 409 failed_precondition حتى يتم ذلك.
• الفوترة مطابقة للفوترة داخل التطبيق: تتضمن خطتك رقمًا واحدًا، ويتم فوترة كل رقم إضافي كإضافة رقم إضافي بقيمة 5 دولارات شهريًا. راجع إضافة أرقام إضافية.

البحث عن الأرقام المتاحة

GET /v1/api/numbers/available يبحث عن الأرقام التي يمكنك شراؤها. قم بالتصفية باستخدام country (الولايات المتحدة افتراضيًا)، startsWith (مثل رمز المنطقة)، contains، locality، state، وlimit (20 افتراضيًا، 50 كحد أقصى):

curl "https://api.ody.co/v1/api/numbers/available?startsWith=512&limit=5" \
  -H "Authorization: Bearer ody_live_…"

يتضمن كل مرشح رقمه والسعر الشهري الذي ستدفعه فعليًا لـ Ody:

{
  "available": [
    {
      "phone_number": "+15125550123",
      "cost_information": { "monthly_cost": "5.00", "upfront_cost": "0.00", "currency": "USD" }
    }
  ]
}

شراء رقم

POST /v1/api/numbers يطلب رقمًا من نتائج البحث. أرسل رأس Idempotency-Key بحيث لا يمكن لمحاولة إعادة الاتصال بالشبكة شراء الرقم مرتين — إعادة محاولة خلال 24 ساعة تعيد تشغيل الاستجابة الأصلية مع رأس Idempotency-Replayed: true:

curl https://api.ody.co/v1/api/numbers \
  -H "Authorization: Bearer ody_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: onboarding-main-line" \
  -d '{"phoneNumber":"+15125550123"}'

يتم طلب الرقم وإضافته إلى مساحة عملك وفوترته على اشتراكك الحالي — تمامًا مثل النقر على شراء في التطبيق. يظهر في الإعدادات ← الأرقام على الفور، حيث يمكنك (أو فريقك) تكوين ترتيب الرنين، البريد الصوتي، قائمة الهاتف، أو وكيل الـ AI، تمامًا مثل أي رقم آخر. تعمل المكالمات على الفور؛ يتم تقييد الرسائل النصية من رقم محلي حتى يتم الموافقة على تسجيل 10DLC (أدناه).

التسجيل للرسائل النصية (10DLC)

تتطلب شركات الاتصالات الأمريكية تسجيل الأعمال قبل أن يتمكن الرقم المحلي من إرسال الرسائل النصية — يعكس الـ API سير عمل إعداد الرسائل النصية داخل التطبيق.

تحقق من الحالة باستخدام GET /v1/api/messaging. يوضح step في الاستجابة مراجعة العمل (العلامة التجارية) ثم مراجعة الحملة، ويتحول canText إلى true لحظة موافقة شركات الاتصالات — تعمل الرسائل النصية بعد ذلك في كل مكان، في التطبيق والـ API على حد سواء.

أرسل تسجيلك باستخدام POST /v1/api/messaging/registration. تتطلب كتلة business حقول displayName، email، vertical، street، city، state، وpostalCode — بالإضافة إلى companyName القانوني وEIN، ما لم تسجل كمالك فردي (entityType: "SOLE_PROPRIETOR" مع firstName، lastName، ورقم هاتف اتصال بدلاً من ذلك). كتلة campaign اختيارية؛ يتم تطبيق الإعدادات الافتراضية المعقولة (حالة استخدام مختلطة مع معالجة STOP/HELP المتوافقة):

curl https://api.ody.co/v1/api/messaging/registration \
  -H "Authorization: Bearer ody_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "business": {
      "displayName": "Acme Plumbing",
      "email": "[email protected]",
      "vertical": "PROFESSIONAL",
      "companyName": "Acme Plumbing LLC",
      "ein": "12-3456789",
      "street": "600 Congress Ave",
      "city": "Austin",
      "state": "TX",
      "postalCode": "78701"
    },
    "campaign": {
      "description": "Customer care and appointment notifications",
      "samples": ["Acme Plumbing: your appointment is confirmed for Tuesday at 9am."]
    }
  }'

يتم فوترة التقديم عبر الـ API تمامًا مثل التقديم داخل التطبيق، بما في ذلك رسوم التسجيل لمرة واحدة بقيمة 20 دولارًا. استخدم POST /v1/api/messaging/refresh لإعادة التحقق من مراجعة شركات الاتصالات وتقدم المسار؛ يتقدم الموافقة تلقائيًا أيضًا.

من مساعد AI (MCP)

تتوفر نفس الإمكانيات كأدوات MCP، بحيث يمكن لمساعد متصل تشغيل هذا التدفق بالكامل لك: search_numbers، buy_number، get_messaging_status، وsubmit_10dlc_registration. راجع ربط أدوات AI مع MCP.

وضع الاختبار

باستخدام مفتاح ody_test_…، تُرجع POST /numbers عملية شراء محاكاة ("simulated": true) — لا يتم طلب أي شيء أو توفيره أو تحصيله — ويتم تسجيل 10DLC في وضع المحاكاة: يتم تشغيل المسار الكامل دون تقديم إلى السجل ودون رسوم. راجع الإنشاء بأمان باستخدام وضع الاختبار.

مقالات ذات صلة

• شراء رقم هاتف
• التسجيل لرسائل 10DLC النصية
• إجراء مكالمات AI وإدارة Astra عبر الـ API
• الإنشاء بأمان باستخدام وضع الاختبار