سجل تغييرات الوثائق
نسجّل هنا كل تغيير يلاحظه المستخدم أو المطور، الأحدث أولًا. أما ملاحظات إصدارات حزمة Node نفسها فراجع سجل تغييرات الحزمة.
2026-11-20
Section titled “2026-11-20”أدوات المطورين
Section titled “أدوات المطورين”- سطر الأوامر. يرسل
smsfabric sendرسالة SMS من الطرفية، ويرسلsmsfabric listenأحداث webhook إلى خادم على جهازك، موقعة كما في webhooks الحقيقية، دون عنوان عام ودون نفق. ويشرح دليل webhooks طريقة الاختبار بها. - مجموعات Postman وInsomnia. نزّلها من البدء السريع أو مرجع الواجهة البرمجية أو صفحة Postman وInsomnia. تُنشأ مع كل بناء للوثائق، فتطابق مرجع الواجهة البرمجية دائما.
- مثال الإرسال بثماني لغات. يعرض البدء السريع الآن Go وJava وC# وRuby إلى جانب cURL وNode وPython وPHP.
- الشيفرة في الصفحات العربية من اليسار إلى اليمين. على الهاتف لم تعد كتلة الشيفرة العريضة تفتح وهي ممررة إلى نهايتها.
2026-11-19
Section titled “2026-11-19”تطبيق الهاتف والأجهزة
Section titled “تطبيق الهاتف والأجهزة”- كتابة رمز الاقتران تعمل. صار رمز الاقتران 16 حرفًا ورقمًا في مجموعات من أربعة، مثل
K7Q2-M9XD-P4WN-8RTV، دون أحرف متشابهة. اكتبه بأحرف كبيرة أو صغيرة، بالشرطات أو دونها. وما زال الرمز يعمل مرة واحدة وصلاحيته 10 دقائق. راجع إقران هاتف. - مصطلح واحد للاقتران. تستخدم البوابة الآن «إقران» مثل تطبيق الهاتف، فصار الزر إقران هاتف.
- إلغاء اقتران الهاتف لم يعد يترك رسائل عالقة. سواء ألغيت الاقتران من الهاتف أو من الأجهزة، تنتقل الرسائل المنتظرة إلى هاتف آخر في مجموعته، وتفشل البقية مع
device_unpairedفتستطيع إعادة إرسالها. صار تطبيق الهاتف يبلغ الخادم عند إلغاء الاقتران من الإعدادات (POST /device/v1/unpair)، فلا تحتاج إلى إكماله من لوحة التحكم إلا إذا كان الهاتف غير متصل. - تطبيق الآيفون المرافق يسجل الدخول بمفتاح API. أنشئ مفتاحا تجريبيا بصلاحية
devices:readوحدها من المطوّرون › مفاتيح API والصقه في مفتاح API. راجع تطبيق iOS المرافق. - تغيّر اسم قراءة في البوابة. صارت في الطابور باسم قيد الإرسال: تعدّ الرسائل التي سلّمها الهاتف إلى أندرويد، لا طابور رسائلك.
- اتجاه نص الرسالة. تُقرأ الرسالة الإنجليزية من اليسار إلى اليمين في التطبيق العربي، والعربية من اليمين إلى اليسار في التطبيق الإنجليزي.
- تقليل الحركة. تعرض الأزرار المشغولة ساعة رملية ثابتة بدلا من الخيط المتحرك.
- الباقات. لكل مؤسسة باقة تحدد هواتفها ومقاعدها ومفاتيح API ونقاط نهاية webhook والرسائل في اليوم وفي الشهر والميزات. اقرأ قائمة الأسعار بالطلب
GET /v1/plans، وباقتك واستخدامك بالطلبGET /v1/org/plan(الباقات). الطلبات التي تتجاوز حدا تعيد403 plan_limit_reachedأو403 feature_not_in_planأو429 quota_exceeded، مع الأرقام فيparams(الأخطاء، الحدود). - صفحة الباقة والاستخدام في البوابة، تحت الإعدادات (الباقة والاستخدام).
- لوحة مجموعات الأجهزة في صفحة الأجهزة بالبوابة، ومجموعات الأجهزة في نافذة الإرسال (مجموعات الأجهزة).
- أحداث webhook على جهازك. ينقل
GET /v1/webhooks/listenأحداث مؤسستك إلى حاسوب لا يملك رابطا عاما، للتطوير (المرجع). ويستخدمه سطر الأوامر الجديد فيsmsfabric listenالذي يمرر كل حدث إلى خادمك المحلي موقّعا مثل التسليم الحقيقي، ويرسلsmsfabric sendمن الطرفية. وفي الحزمة الدالةwebhooks.listen(). - مجموعات Postman وInsomnia، والإرسال الأول برنامجا كاملا بثماني لغات (المجموعات والأمثلة).
- docs.smsfabric.com. مكان واحد لكل الوثائق، بالعربية والإنجليزية، بالوضعين الفاتح والداكن. ويغطي:
- بوابة العملاء وتطبيق الهاتف، مع لقطات شاشة لكل خطوة؛
- أدلة المطورين والمرجع الكامل للواجهة البرمجية؛
- حزمة Node وخادم MCP.
- حزمة Node بالإصدار 1.0.0 (
@smsfabric/sdk). تغطي كل نقاط نهاية العملاء، وتعمل مع ESM وCommonJS، ولا تعتمد على أي حزمة أخرى وقت التشغيل. - خادم MCP بالإصدار 1.0.0 (
@smsfabric/mcp-server). شغّله بالأمرnpx -y @smsfabric/mcp-server. - إضافة جهات اتصال موجودة إلى مجموعة من البوابة (جهات الاتصال › المجموعات).
- المعامل
qفيGET /v1/audit، وكائنactorيحمل الاسم المعروض في كل مدخل (مرجع سجل التدقيق). - حزمة Node بالإصدار 1.1.0. الدالتان
verifySignatureوconstructEventدون حاجة إلى عميل، ودعم محتوى خطافات الويب بصيغةUint8Array، والحقلانretryAfterوheadersفيSMSFabricError. وأصبحaccessTokenالممرر يتقدم علىSMSFABRIC_API_KEY، ولا تعاد إلا محاولة409 idempotency_in_progress. راجع سجل تغييرات الحزمة. - خادم MCP بالإصدار 1.1.0. تقبل
send_smsالمعاملidempotencyKeyوتطلب التأكيد قبل الإرسال، وتقبلcreate_campaignالمعاملscheduledAtوتتحقق من النص وساعات الهدوء، وتعرض أدوات القوائم حتى 200 عنصر، وتذكر أخطاء الشبكة سببها.
- صار حد الطلبات لمفتاح API هو معدل باقته: 60 في الدقيقة في Free، و300 في Starter، و1200 في Pro، و3000 في Business (حدود المعدل).
- أثناء صيانة SMSFabric تعيد الواجهة البرمجية
503 maintenanceمعRetry-After(الأخطاء)، ويعرض تطبيق الهاتف شاشة صيانة (استكشاف الأخطاء وإصلاحها). - صار إلغاء الاقتران من الهاتف يلغيه على الخادم أيضا، وصار التطبيق المرافق على iOS يسجّل الدخول بمفتاح API (الإعدادات، التطبيق المرافق على iOS).
- يتفق دائمًا شريط الأسطول في الشريط الجانبي مع مؤشر التحديثات المباشرة في الشريط العلوي، ويعرضان جارٍ الاتصال أثناء فتح الاتصال، ويصير الشريط سطرًا واحدًا على الشاشات القصيرة (النظرة العامة).
- يعرض جدول عمليات التسليم في webhook الوقت تحت الحدث وعدد المحاولات تحت النتيجة.
- انتقلت صفحة المطورين في smsfabric.com وصفحة البدء السريع في البوابة إلى هنا، وتحوّل عناوينهما القديمة إلى الصفحات المقابلة.
- تعرض البوابة لكل دور الصفحات التي يستطيع فتحها فقط، والصفحة التي تُفتح من رابط تذكر الصلاحية التي تحتاج إليها (الفريق).
- تُبرز معاينة القالب المتغير الذي لا قيمة له ولا بديل (القوالب).
- كانت الرسائل تعرض 8 صفوف فقط بعد فتح النظرة العامة أو الأجهزة.
- على عرض 1280 بكسل لم تعد أسماء المسارات في شاشة الإرسال ومسار الإرسال وخريطة التوجيه في النظرة العامة تُقطع.
- سجل التدقيق: يعمل عامل التصفية، ويُظهر كل مدخل من قام به بدلًا من «النظام».
- العربية: تحافظ أرقام الهواتف و
STOPوUCS-2والتواريخ وأرقام الأسطر وأسماء الهواتف على ترتيبها. - التخطيط: أعمدة الأعداد في تقرير الحملة، ودولة حقل الهاتف، وتجميع الأرقام المصرية (
0100 765 4321)، وبطاقات الأجهزة عند عرض 1280 بكسل.