saudi-telecom

name	saudi-telecom
description	واجهات شركات الاتصالات السعودية — Saudi telecom developer APIs for SMS, OTP, and payments via STC, Mobily, Zain
metadata	{"openclaw":{"emoji":"📱","requires":{"bins":"[Truncated]"}}}

واجهات شركات الاتصالات السعودية

دليل شامل لواجهات المطورين لدى شركات الاتصالات الثلاث في المملكة العربية السعودية: STC وموبايلي وزين.

---

مقارنة شاملة

الميزة	STC	موبايلي	زين
البوابة	developers.stc.com.sa	developer.mobily.com.sa	developer.sa.zain.com
SMS	✅	✅	✅ (SPS)
OTP	✅	✅	✅
الدفع	✅	✅	✅ (TABS)
IoT	✅	❌	❌
بيئة تجريبية	✅ مجانية	✅	✅ Sandbox
البريد الإلكتروني	❌	✅	❌
QR Code	❌	✅	❌

---

STC — اتصالات السعودية

بوابة المطورين: https://developers.stc.com.sa

الخدمات المتاحة

• SMS API: إرسال رسائل نصية فردية وجماعية
• OTP API: إرسال والتحقق من رموز التحقق
• Identity API: التحقق من هوية المشترك
• Payment API: الدفع عبر فاتورة STC
• IoT API: إدارة أجهزة إنترنت الأشياء
• Network Events API: أحداث الشبكة

الإعداد

1. سجّل في https://developers.stc.com.sa
2. أنشئ تطبيقًا واحصل على API Key
3. بيئة تجريبية مجانية (Sandbox) متاحة مباشرة

إرسال SMS عبر STC

curl -X POST "https://developers.stc.com.sa/api/sms/v1/send" \
  -H "Authorization: Bearer ${STC_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "مرحبًا من تطبيقنا",
    "recipients": ["[phone]"],
    "sender": "MyApp"
  }'

إرسال OTP عبر STC

curl -X POST "https://developers.stc.com.sa/api/otp/v1/send" \
  -H "Authorization: Bearer ${STC_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "[phone]",
    "template": "Your code is {otp}"
  }'

---

موبايلي (Mobily)

بوابة المطورين: https://developer.mobily.com.sa

الخدمات المتاحة

• OTP API: إرسال والتحقق من رموز التحقق
• Payment API: الدفع عبر فاتورة موبايلي
• SMS API: إرسال رسائل نصية
• Email API: إرسال بريد إلكتروني
• QR Code API: إنشاء رموز QR

الإعداد

1. سجّل في https://developer.mobily.com.sa
2. احصل على App ID و App Secret

إرسال SMS عبر موبايلي

curl -X POST "https://developer.mobily.com.sa/api/sms/send" \
  -H "Authorization: Bearer ${MOBILY_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "966550000000",
    "message": "مرحبًا من تطبيقنا",
    "sender": "MyApp"
  }'

إرسال OTP عبر موبايلي

curl -X POST "https://developer.mobily.com.sa/api/otp/send" \
  -H "Authorization: Bearer ${MOBILY_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "966550000000",
    "lang": "ar"
  }'

---

زين السعودية (Zain KSA)

بوابة المطورين: https://developer.sa.zain.com

الخدمات المتاحة

• SPS (SMS Premium Service): رسائل نصية مدفوعة
• TABS (Telecom Application Billing System): الدفع عبر الفاتورة
• SDP (Service Delivery Platform): منصة تقديم الخدمات

الإعداد

1. سجّل في https://developer.sa.zain.com
2. أنشئ تطبيقًا واحصل على بيانات الاعتماد
3. بيئة Sandbox متاحة للاختبار

إرسال SMS عبر زين

curl -X POST "https://developer.sa.zain.com/api/sps/v1/send" \
  -H "Authorization: Bearer ${ZAIN_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationAddress": "tel:[phone]",
    "message": "مرحبًا من تطبيقنا",
    "senderAddress": "MyApp"
  }'

الدفع عبر TABS

curl -X POST "https://developer.sa.zain.com/api/tabs/v1/charge" \
  -H "Authorization: Bearer ${ZAIN_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "msisdn": "[phone]",
    "amount": "5.00",
    "currency": "SAR",
    "description": "اشتراك شهري"
  }'

---

عرض النتيجة

📱 تم إرسال الرسالة بنجاح
المزود: {{ provider }}
الرقم: {{ recipient }}
معرّف الرسالة: {{ messageId }}
الحالة: {{ status }}

---

متى تستخدم

استخدم هذه المهارة عندما يسأل المستخدم عن:

• إرسال رسائل SMS في السعودية
• خدمات OTP ورموز التحقق عبر الاتصالات
• واجهات مطوري STC أو موبايلي أو زين
• الدفع عبر فاتورة الاتصالات (Carrier Billing)
• بوابات المطورين لشركات الاتصالات السعودية

---

المراجع

• STC Developers: https://developers.stc.com.sa
• Mobily Developer: https://developer.mobily.com.sa
• Zain KSA Developer: https://developer.sa.zain.com