SMS8 API للمطورين.
أرسل SMS وMMS عبر SMS8 API فتخرج من هاتفك الخاص. مفتاح API واحد لكل نقاط النهاية، وwebhooks للردود وتقارير التسليم، وSDK لـ Node، وفئات PHP وC# جاهزة، وخادم MCP لوكلاء الذكاء الاصطناعي.

npm install sms8-sdkclaude mcp add --transport http sms8 https://mcp.sms8.ioSMS8_API_KEY=your_api_key npx -y sms8-sdk mcphttps://mcp.sms8.ioClaude Desktop: الإعدادات، الموصلات، إضافة موصل مخصص
كيف يعمل الـ API
كل طلب يذهب إلى app.sms8.io. ترسل طلب نموذج بسيطًا بمفتاح API والحقول التي تحتاجها. ويعود إليك JSON فيه علامة نجاح واضحة وتفاصيل الرسالة.
خلف ذلك، تذهب الرسالة إلى هاتف أندرويد ربطته، ويرسلها ذلك الهاتف من شريحته الخاصة. وتعود إليك الردود وتقارير التسليم بالطريقة نفسها.
لا يوجد حد اصطناعي لمعدل الطلبات في الـ API. السرعة الفعلية تعتمد على شرائحك. أضف هواتف أو استخدم هاتفًا ثنائي الشريحة لترسل أكثر.
ما يمكنك فعله
نقطة نهاية لكل مهمة. والمرجع الكامل يسرد كل حقل.
أرسل SMS وMMS
أرسل رسالة واحدة، أو دفعة إلى أشخاص كثيرين، أو بثًا إلى قائمة جهات اتصال محفوظة. أضف روابط صور لـ MMS. جدول إرسالًا لوقت لاحق، أو اجعله يتخطى الطابور.
اختر المرسل
أرسل من هاتف وشريحة واحدة، أو تناوب على كل هواتفك، أو اختر هاتفًا عشوائيًا لكل رسالة لتوزيع الحمل.
اقرأ وأعد الإرسال
ابحث عن أي رسالة بمعرّفها لترى حالتها. وأعد الرسائل الفاشلة إلى الطابور باستدعاء واحد.
رموز OTP
أرسل رمزًا لمرة واحدة وتحقق مما كتبه المستخدم. الرموز محدودة لكل رقم هاتف يوميًا لحماية المستلمين.
الأجهزة وجهات الاتصال
اعرض هواتفك المرتبطة وشرائحها. وأنشئ جهات اتصال أو حدّثها باسم ووسوم وحقول مخصصة.
USSD
أرسل رمز USSD الخاص بالمشغّل، مثل الاستعلام عن الرصيد، من هاتف مرتبط واقرأ الرد.
المصادقة والاستجابات
مفتاح واحد لكل حساب، وشكل الإجابة نفسه في كل استدعاء.
أين يوجد المفتاح
يظهر مفتاحك في صفحة API في لوحة تحكم SMS8. تعامل مع المفتاح ككلمة مرور واحفظه على خادمك، لا في صفحة ويب عامة.
كيف ترسله
ضعه في ترويسة X-Api-Key، كما في ملف OpenAPI. ويعمل أيضًا رمز bearer في ترويسة Authorization أو حقل نموذج اسمه key.
ما الذي يعود
JSON فيه علامة نجاح. عند النجاح تحصل على الرسالة أو السجل. وعند الفشل تحصل على خطأ فيه رمز ورسالة قصيرة.
تحقق من العلامة
بعض الأخطاء، مثل حقول غير صحيحة أو نفاد الرصيد، تعود داخل استجابة عادية. اقرأ علامة النجاح قبل أن تثق بالنتيجة.
عندما يكون المفتاح خاطئًا
المفتاح المفقود أو غير الصالح يعيد 401. والحقول المفقودة أو المشوهة تعيد 400.
نقاط النهاية بنظرة سريعة
كلها تحت app.sms8.io. وملف OpenAPI فيه الحقول الدقيقة لكل منها.
| المسار | الطريقة | ما تفعله |
|---|---|---|
| /api/v1/messages | POST | أرسل SMS أو MMS إلى شخص واحد أو دفعة |
| /api/v1/messages/read | POST | اعرض الرسائل المرسلة والمستلمة، مصفاة حسب الرقم أو الاتجاه أو التاريخ |
| /api/v1/messages/resend | POST | أعد محاولة رسالة فشلت، بمعرّفها |
| /api/v1/devices | GET | اعرض الهواتف المرتبطة مع البطارية والإشارة والشرائح وآخر ظهور |
| /api/v1/contacts | POST | أنشئ جهة اتصال أو حدّثها بوسوم وحقول مخصصة |
| /api/v1/ussd/send | POST | شغّل رمز USSD من شريحة مرتبطة واحصل على إجابة المشغّل |
| /api/v1/ussd/list | POST | اعرض جلسات USSD الأخيرة |
إرسال رسالة، حقلًا بحقل
الرقم والنص فقط مطلوبان. ولكل ما عداهما قيمة افتراضية.
الرقم والنص
يُكتب الرقم بالصيغة الدولية، مثل +14155550100. ويمكن أن يصل النص إلى 1,000 حرف ويمكن أن يستخدم وسوم دمج مثل {first_name}.
SMS أو MMS
النوع sms افتراضيًا. ولـ MMS، أضف روابط صور HTTPS عامة. يغيّر SMS8 حجم كل صورة إلى 1,280 بكسل قبل الإرسال.
أي هاتف يرسلها
حدّد معرّف جهاز أو أكثر ومنفذ شريحة، حيث 0 هو الشريحة 1 و1 هو الشريحة 2. إن تركتها فارغة يرسل هاتفك الافتراضي.
التناوب
اضبط الخيار للتناوب على كل هواتفك، أو على كل شريحة في كل هاتف. ويمكن أيضًا اختيار هاتف عشوائي لكل رسالة.
تخطَّ الطابور
علّم الرسالة كأولوية فتسبق غيرها من الرسائل المنتظرة على ذلك الهاتف. مفيد للتنبيهات والرموز.
ما يعود إليك
معرّف رسالة للبحث لاحقًا، والهاتف والشريحة التي تولتها، ووقت إدخالها في الطابور. ثم تنتقل الحالة بين queued وsending وsent وdelivered أو failed.
Webhooks
سجّل عنوان URL فيرسل SMS8 الأحداث إليه لحظة وقوعها. كل webhook يختار أحداثه ويحصل على سر توقيع خاص به، فتستطيع التحقق أن كل طلب قادم فعلًا من SMS8.
مستلمة
وصل رد أو رسالة جديدة على أحد هواتفك. وهو الحدث الذي تحتاجه معظم إعدادات CRM.
مرسلة
تولى هاتفك الرسالة ووضعها في طابور شريحته. مناسب لسجلات التدقيق.
مُسلَّمة
أكد مشغّل المستلم التسليم.
فاشلة
تعذر إرسال الرسالة بعد عدة محاولات، مثلًا بسبب رقم خاطئ أو انعدام الإشارة.
رد USSD
أجاب المشغّل على رمز USSD أرسلته.
ربط هاتف
انضم هاتف جديد إلى حسابك.
موقّعة، ومعادة المحاولة، ومسجلة
كل طلب webhook يحمل ترويسة X-Signature. وهي تجزئة HMAC-SHA256 لنص الطلب الخام، مصنوعة بسر ذلك الـ webhook، لا بمفتاح API الخاص بك. احسب التجزئة نفسها على خادمك، وقارن بينهما بفحص ثابت الزمن، وتجاهل كل ما لا يتطابق.
يجب أن يستخدم المستقبِل لديك HTTPS وأن يجيب بحالة 2xx خلال 10 ثوانٍ. إن لم يفعل، يعيد SMS8 المحاولة وفق جدول يمتد من بضع دقائق حتى 30 يومًا. وتظهر كل محاولة في سجل التسليمات مع الحالة والاستجابة، ويمكنك إعادة محاولة أي صف يدويًا.
أجب أولًا وأجّل العمل البطيء، مثل البحث في CRM أو التصنيف بالذكاء الاصطناعي. واستخدم معرّف الرسالة كمفتاح فريد حتى لا يُعالَج حدث معاد مرتين أبدًا.
حزم SDK واللغات
أي لغة تستطيع إرسال طلب ويب تعمل. وهذه توفر عليك الإعداد.
Node وTypeScript
ثبّت sms8-sdk من npm. حزمة واحدة للـ SDK وأداة سطر أوامر ومساعدات React وجسر MCP.
02PHP
فئة PHP واحدة فيها دالة لكل نقطة نهاية. احفظ الملف، واستدعه بـ require وأرسل. تعمل على PHP 7.4 وما بعده ولا تحتاج إلا إلى امتداد curl، فتناسب Laravel وWordPress وSymfony أو سكربت عادي.
03C# و.NET
فئة واحدة مبنية على HttpClient بدوال غير متزامنة. تعمل على .NET الحديث، و.NET Framework 4.6.2 وما بعده، وUnity وXamarin وMAUI.
04Python ولغات أخرى
يعرض المرجع كل طلب جاهزًا للنسخ بلغتك. وتتيح لك أداة البناء في لوحة التحكم تجربة طلب على حسابك الحقيقي.
لوكلاء الذكاء الاصطناعي
يتيح خادم SMS8 MCP على mcp.sms8.io لـ Claude وCursor وأدوات الذكاء الاصطناعي الأخرى إرسال SMS، وإرسال رموز OTP والتحقق منها، وقراءة الرسائل، وعرض هواتفك، وإعداد الـ webhooks.
يستخدم مفتاح API نفسه، مرسلًا كرمز bearer. أضفه إلى أداة الذكاء الاصطناعي مرة واحدة فيستطيع وكيلك المراسلة من رقمك.
المرجع الكامل
كل شيء بالحقول الدقيقة والاستجابات ورموز الأخطاء موجود هنا.
أرسل مفتاح API مع كل طلب. تجده في صفحة API في لوحة التحكم. ويقبل خادم MCP المفتاح نفسه كرمز bearer.
لا يوجد في الـ API حد اصطناعي. شرائحك تحدد الوتيرة الفعلية. وللإرسال الكبير، أضف هواتف أو اضبط فاصلًا بين الرسائل في إعداداتك.
اشترك في webhook لأحداث التسليم والفشل، أو ابحث عن الرسالة بمعرّفها.
نعم. اضبط النوع على MMS وأضف روابط صور عامة. يغيّر SMS8 حجم الصور قبل الإرسال.
نعم. نقاط النهاية الحالية موجودة تحت /api/v1، والعناوين القديمة تواصل العمل للتطبيقات الحالية.
لا. لكل webhook سر توقيع خاص به، يُضبط عند إنشائه. ولا يغادر مفتاح API طلباتك إلى SMS8 أبدًا.
تنتظر الأحداث في طابور إعادة المحاولة ويواصل SMS8 المحاولة حتى 30 يومًا. ويمكنك أيضًا إعادة إرسال أي تسليم من السجل عند عودتك.
نعم. استورد ملف OpenAPI إلى Postman أو Insomnia أو مولّد كود لتحصل على كل نقطة نهاية وحقل.
نعم. مرّر معرّف جهاز ومنفذ شريحة، أو دع SMS8 يتناوب على هواتفك وشرائحك لتوزيع الحمل.
أرسل أول استدعاء API
أنشئ حسابًا، واربط هاتفًا، وانسخ مفتاح API. يستطيع الكود لديك الإرسال في دقائق.