المفاهيم الأساسية
المؤسسة
Section titled “المؤسسة”كل ما تنشئه ينتمي إلى مؤسسة: الهواتف والرسائل وجهات الاتصال والمفاتيح وwebhooks. ينضم الأشخاص إلى المؤسسة بدعوة، ويمكن للشخص الواحد أن ينتمي إلى أكثر من مؤسسة. ولا تنتقل البيانات أبدًا بين المؤسسات.
الأدوار والصلاحيات
Section titled “الأدوار والصلاحيات”لكل عضو دور: owner أو admin أو developer أو campaign_manager أو agent أو viewer أو billing. الدور مجموعة من الصلاحيات مثل messages:send أو devices:manage. راجع الفريق والأدوار للجدول الكامل.
الجهاز
Section titled “الجهاز”الجهاز هاتف Android يعمل بتطبيق SMSFabric ومقترن بمؤسستك. يرسل الرسائل ويستقبلها عبر شرائحه، ويبقى متصلًا ما دام يرسل نبضته الدورية.
الشريحة
Section titled “الشريحة”كل شريحة (أو eSIM) في الجهاز قناة إرسال لها رقمها وشركة الاتصالات الخاصة بها وحد يومي اختياري واسم. وتكون شريحة واحدة في المؤسسة هي المرسل الافتراضي. ويمكنك اختيار شريحة لكل رسالة عبر simId.
المجموعة
Section titled “المجموعة”المجموعة (pool) عدة أجهزة تتقاسم العمل. أرسل مع poolId فيوزع SMSFabric الرسائل على هواتف المجموعة المتصلة. وإذا فشل أحدها أو انقطع، تنتقل رسائله إلى هاتف آخر في المجموعة.
الرسالة
Section titled “الرسالة”للرسالة اتجاه (outbound أو inbound) وحالة وسجل زمني من الأحداث. حالات الرسائل الصادرة هي queued ثم routed ثم sending ثم sent، ثم حالة نهائية واحدة: delivered أو failed أو blocked. وحالة الرسائل الواردة received. ونصوص الرسائل مشفرة عند التخزين.
الأجزاء والترميز
Section titled “الأجزاء والترميز”تنتقل النصوص الطويلة على شكل عدة أجزاء SMS يعيد هاتف المستلم جمعها. الرسالة التي لا تستخدم إلا أبجدية GSM-7 تتسع لـ 160 حرفًا في جزء واحد، أو 153 حرفًا لكل جزء عند التقسيم. وأي حرف آخر، كالحروف العربية أو الرموز التعبيرية، يحوّل الرسالة كلها إلى UCS-2: سبعون حرفًا في جزء واحد، أو 67 حرفًا لكل جزء عند التقسيم. وغالبًا ما تحاسبك شركة الاتصالات على كل جزء. ويمكن أن يصل النص إلى 1,600 حرف.
مفتاح API
Section titled “مفتاح API”يتيح مفتاح API لخادمك استدعاء الواجهة البرمجية. له وضع ومجموعة صلاحيات وقيود اختيارية:
- مفاتيح الإنتاج (
sf_live_…) ترسل رسائل حقيقية عبر هواتفك. - مفاتيح الاختبار (
sf_test_…) تذهب إلى جهاز افتراضي ولا تصل إلى أي شركة اتصالات. - الصلاحيات تحدد ما يستطيع المفتاح فعله، ولا يحمل المفتاح إلا صلاحيات يملكها منشئه.
- قائمة عناوين IP وتاريخ الانتهاء قيود إضافية اختيارية.
يظهر السر مرة واحدة عند إنشاء المفتاح، ولا يحفظ SMSFabric إلا بصمته. راجع المصادقة.
Webhook
Section titled “Webhook”الـ webhook عنوان HTTPS خاص بك يستدعيه SMSFabric عند وقوع حدث ما، مثل message.delivered أو device.offline. وكل استدعاء موقّع حتى تتأكد أنه صادر من SMSFabric. راجع Webhooks.
جهات الاتصال والقوالب والحملات
Section titled “جهات الاتصال والقوالب والحملات”جهات الاتصال هم الأشخاص الذين تراسلهم، مع الوسوم والمجموعات والحقول المخصصة وسجل الموافقة. والقوالب نصوص رسائل قابلة لإعادة الاستخدام فيها متغيرات مثل {{firstName}}. والحملة ترسل قالبًا إلى مجموعة من جهات الاتصال بسرعة مضبوطة وخارج ساعات الهدوء. راجع الحملات.
Verify
Section titled “Verify”يرسل Verify رموز تحقق لمرة واحدة عبر الرسائل النصية ويتحقق منها، مع حدود تمنع احتيال ضخ الرسائل. راجع Verify (رموز التحقق).