منصة Scale للمطورين

API واتساب للبرمجيات التي تبنيها

أرسل رموز التحقق والإشعارات والمحادثات من أرقام واتساب الخاصة بعملائك — كل عميل وكل رقم تحت مفتاح API واحد، مع webhooks موقّعة لكل ما يعود إليك.

أنشئ حساب مطوّر اقرأ التوثيق

خطوات الربط الرسمية من Meta
بدون رسوم من Scale على الرسالة
توثيق بالعربية والإنجليزية

أرسل رمز تحققHTTP

POST /wp-json/scale/v1/messages
Authorization: Bearer sk_live_…
Idempotency-Key: login-attempt-7731
Content-Type: application/json

{
  "number_id": "num_XXXX",
  "to": "201012345678",
  "type": "template",
  "template": {
    "name": "otp_code",
    "language": "en_US",
    "components": [
      {
        "type": "body",
        "parameters": [{ "type": "text", "text": "482913" }]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "0",
        "parameters": [{ "type": "text", "text": "482913" }]
      }
    ]
  }
}

لمن هذه المنصة

للمطورين — منتج مختلف عن Scale AI

يرد Scale AI على عملاء النشاط التجاري نفسه بمساعد ذكي. أما منصة المطورين فهي للفرق التي تبني منتجها الخاص وتحتاج واتساب داخله.

منصة Scale للمطورين

API من نوع REST وwebhooks — برنامجك يقرر كل رسالة
عملاء كثيرون، لكل منهم أرقام واتساب الخاصة به
نقل فقط: لا يرد أي ذكاء اصطناعي على رقم أي عميل
اشتراك ثابت، بدون رسوم من Scale على الرسالة

Scale AI

مساعد ذكي يرد على واتساب وإنستجرام وماسنجر
صندوق وارد مشترك وCRM لفريقك
حملات ومتابعات وتحويلات إعلانات Meta
باقة واحدة برسائل منصة غير محدودة، والذكاء الاصطناعي برصيد مدفوع مقدمًا

تبحث عن المساعد الذكي لنشاطك التجاري؟

الاستخدامات

ماذا تبني الفرق بها

كل ما يحتاج برنامجك أن يقوله على واتساب — يُرسل من رقم النشاط التجاري الصحيح، وتتابعه حتى التسليم.

رموز التحقق (OTP)

أرسل رموز الدخول والتحقق بقالب مصادقة معتمد، ثم تابع التسليم على الـwebhook الخاص بك.

إشعارات المعاملات

تأكيد الطلبات وتحديثات الشحن وتذكير المواعيد والإيصالات — تنطلق من أحداث في نظامك.

تنبيهات ورسائل مخصّصة

نصوص وصور وفيديو وصوت ومستندات وقوالب، لكل من راسل الرقم خلال آخر 24 ساعة، أو بقالب معتمد.

أتمتة عبر الـAPI

إرسال لا يتكرر، وتقسيم الصفحات بمؤشّر، وأعداد الاستخدام، وأحداث موقّعة — مصمّم ليعمل من المهام والطوابير.

داخل منصتك أو CRM أو موقعك أو تطبيقك

أضف واتساب إلى المنتج الذي يستخدمه عملاؤك أصلاً، بواجهتك أنت.

عملاء كثيرون، تكامل واحد

تربط الوكالات والمنصات رقم كل عميل مرة واحدة، وترسل لهم جميعاً بمفتاح واحد.

طريقة العمل

من التسجيل إلى أول رسالة

أنت تنشئ الحساب وتكتب الكود؛ وكل نشاط تجاري يربط رقمه بنفسه عبر Meta.

1
أنشئ حساب المطوّر
سجّل وأكّد بريدك الإلكتروني. يبدأ حسابك في وضع الإعداد: مفتاح الـAPI والـwebhooks والعملاء والرقمان المشمولان والقوالب والتجارب تعمل فوراً؛ أما الرسائل الحقيقية فتُرسل عند تأكيد أول دفعة.
2
أضف عميلاً
عميل واحد لكل نشاط تجاري تخدمه — من اللوحة أو عبر POST /customers — ومعه معرّفك الخاص.
3
النشاط التجاري يربط رقمه
أنشئ رابط ربط وأرسله. يفتح الصفحة المستضافة لدى Scale التي تشغّل خطوات الربط الرسمية من Meta: يسجّل النشاط دخوله إلى فيسبوك، ويختار حساب واتساب للأعمال الخاص به أو ينشئه، ويتحقق من الرقم.
4
أرسل واستقبل
استدعِ POST /messages من الرقم المربوط number_id. تصل الردود وحالات التسليم إلى الـwebhook الخاص بك، موقّعة.

مفتاح واحد، عملاء كثيرون

مصمّمة للمنتجات متعددة العملاء

مفتاح API واحد يصل إلى كل عميل وكل رقم في حسابك — ولا شيء في حساب غيرك.

مفتاح API واحد

يُصدر ويُدوَّر ويُلغى من لوحتك. تخزّن Scale بصمته SHA-256 فقط، ويظهر لك مرة واحدة.

معرّفات ثابتة

معرّفات Scale لا تتغير أبداً ولا يُعاد استخدامها — احفظها بجوار سجلاتك.

عزل العملاء

كل عميل ورقم ورسالة ورابط يتبع حساب مطوّر واحداً فقط. ومعرّف حساب آخر يُجاب عليه بـ404، تماماً كمعرّف غير موجود.

عدة أرقام لكل عميل

يمكن للعميل ربط أكثر من رقم، كلها على حساب واتساب للأعمال الخاص به. ويشمل اشتراكك رقمين للحساب كله؛ وكل رقم زيادة له اشتراك رقم إضافي.

المعرّفات التي تحفظها

dev_…: حساب المطوّر الخاص بك
ws_…: عميل — نشاط تجاري تخدمه
num_…: رقم من أرقام واتساب الخاصة بالعميل
msg_…: رسالة أرسلتها
onb_…: رابط ربط
evt_…: حدث webhook

الـWebhooks

Webhooks لكل ما يعود إليك

عنوان HTTPS واحد يستقبل أحداث كل عملائك وأرقامك.

message.receivedشخص راسل أحد أرقامك
message.sentقبل واتساب رسالة
message.deliveredوصلت إلى الهاتف
message.readقرأها المستلم
message.failedتعذّر تسليمها — مع السبب
number.connectedعميل ربط رقماً
number.disconnectedتوقف توجيه رقم
onboarding.completedاكتمل رابط ربط
onboarding.failedفشل رابط ربط

موقّعة بـHMAC-SHA256 على الطابع الزمني والجسم الخام
تُعاد حتى 8 محاولات، على مدى نحو أربع ساعات
مرة واحدة على الأقل: أزل التكرار باستخدام id الحدث
العنوان يُضبط من لوحتك — ولا يستطيع مفتاح API مسرّب تغييره

الـAPI

API صغير ويمكن التنبؤ به

JSON في الطلب والرد، وغلاف واحد لكل رد، ورمز ثابت لكل خطأ.

المصادقة

أرسل مفتاحك في ترويسة Authorization مع كل طلب. والمفتاح المرسل في الرابط مرفوض.

Authorization: Bearer sk_live_…

أخطاء يمكنك التعامل معها برمجياً

كل فشل يحمل حالة HTTP، ورمزاً ثابتاً code، ورسالة مقروءة message، وrequest_id تذكره للدعم الفني.

403 SUBSCRIPTION_INACTIVEوضع الإعداد: الإرسال يُفتح مع أول دفعة
422 OUTSIDE_MESSAGING_WINDOWأرسل قالباً معتمداً بدلاً منها
429 RATE_LIMITEDانتظر Retry-After ثانية

في التوثيق

أرسل رسالةcURL

curl -X POST https://getscale.me/wp-json/scale/v1/messages \
  -H "Authorization: Bearer $SCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1001-shipped" \
  -d '{"number_id":"num_XXXX","to":"201012345678","type":"text","text":{"body":"Your order 1001 has shipped."}}'

الردJSON

{
  "success": true,
  "message": {
    "id": "msg_…",
    "wamid": "wamid.…",
    "status": "accepted",
    "type": "text",
    "to": "201012345678",
    "created_at": "2026-11-10T12:00:00Z",
    "number_id": "num_XXXX",
    "customer_id": "ws_…",
    "phone_number_id": "1234567890"
  },
  "replayed": false
}

SUBSCRIPTION_INACTIVE · 403JSON

{
  "success": false,
  "error": {
    "code": "SUBSCRIPTION_INACTIVE",
    "message": "Your account is in setup mode: keys, webhooks, numbers and templates can be configured and tested, but real messages are sent only once your Scale Developer subscription is active. Test with POST /test/messages and POST /test/webhook.",
    "details": {
      "status": "pending_payment",
      "mode": "setup",
      "grace_ends_at": null,
      "migration": null
    }
  },
  "request_id": "req_…"
}

الأسعار

اشتراك واحد ثابت

للحساب كله — كل عميل، ويشمل رقمَي واتساب.

شهري

EGP 1,200/ شهر

ابدأ بالاشتراك الشهري

سنوي

EGP 12,000/ سنة

ابدأ بالاشتراك السنوي

بدون رسوم من Scale على الرسالة — الاستخدام يُحسب ولا يُحاسب عليه
لا يُخصم أي رصيد رسائل
رقما واتساب ضمن الاشتراك؛ ولا تضع Scale حداً لعدد العملاء أو الرسائل
الـAPI والـwebhooks واللوحة والتوثيق باللغتين

كل رقم واتساب إضافي: EGP 300 شهرياً أو EGP 3,000 سنوياً، باشتراك خاص به تضيفه من لوحتك (الاشتراك والفواتير) — مثلاً 3 أرقام على الخطة الشهرية تكلّف EGP 1,500 شهرياً.

رسوم محادثات واتساب نفسها رسوم Meta، وتُحصَّل من كل نشاط تجاري وفق ترتيب حسابه في واتساب للأعمال. ولا تضيف Scale عليها شيئاً.

متى تدفع

1سجّل، وأنشئ مفتاح الـAPI، واضبط الـwebhooks، وأضف العملاء، واربط الرقمين المشمولين، واكتب القوالب، وجرّب التكامل — كل ذلك قبل الدفع.
2تُرسل الرسائل الحقيقية عندما تُؤكَّد أول دفعة — وحتى ذلك الحين يجيب الـAPI بـ403 SUBSCRIPTION_INACTIVE (الوضع setup)، ويُجاب عن شراء رقم إضافي بـ402 PAYMENT_REQUIRED. تدفع عبر InstaPay عند الدفع، ويراجع شخص من Scale كل تحويل قبل تفعيل أي شيء؛ وتعرض لوحتك كل دفعة: قيد المراجعة أو مقبولة أو غير مؤكدة.
3إذا فات موعد التجديد، يظل كل شيء يعمل لمدة 3 أيام تقويمية؛ وبعدها يتوقف الإرسال حتى تجدّد. وتظل الرسائل الواردة تصل إلى الـwebhook لمدة 14 يومًا أخرى — وقت للتجديد أو نقل أرقامك — وتظل تُخزَّن بعد ذلك. ولا يُحذف شيء.

أسئلة

أسئلة يطرحها المطورون

هل هذا هو Scale AI نفسه؟

لا. Scale AI مساعد ذكي وCRM يستخدمه النشاط التجاري مع عملائه هو. أما منصة المطورين فهي API لبرنامجك: لا يرد الذكاء الاصطناعي في Scale على رقم أي عميل من عملاء المطورين، ولا يتصرف نيابة عنه أبداً.

هل تفرض Scale رسوماً على كل رسالة؟

لا. تدفع الاشتراك الثابت فقط؛ تحسب Scale استخدامك لكنها لا تفرض أي رسوم على الرسالة ولا تخصم أي رصيد. أما رسوم محادثات واتساب نفسها فهي رسوم Meta، وتتبع فوترة كل نشاط تجاري مع Meta.

من أي رقم واتساب تُرسل الرسائل؟

من رقم عميلك. كل نشاط تجاري يربط رقمه بحساب واتساب للأعمال الخاص به عبر خطوات الربط الرسمية من Meta على الصفحة المستضافة لدى Scale؛ ولا تتعامل أنت أبداً مع كلمة مرور Meta الخاصة به أو رمزه.

هل يمكنني إضافة عملاء قبل الدفع؟

نعم — يبدأ حسابك في وضع الإعداد. أنشئ مفتاح الـAPI والـwebhooks، وأضف العملاء، واربط الرقمين المشمولين، واكتب القوالب، وجرّب عبر POST /test/webhook وPOST /test/messages قبل الدفع. ما ينتظر تأكيد أول دفعة هو إرسال الرسائل الحقيقية (403 SUBSCRIPTION_INACTIVE، الوضع setup، حتى ذلك الحين) وشراء الأرقام الإضافية (402 PAYMENT_REQUIRED).

كيف أدفع؟

عبر InstaPay عند الدفع: حوّل المبلغ المعروض بالضبط، ثم ارفع إيصال التحويل مع الرقم الذي حوّلت منه والرقم المرجعي. يراجع شخص من Scale كل تحويل، ولا يُفعَّل شيء قبل ذلك. وتعرض لوحتك (الاشتراك والفواتير ← المدفوعات) كل دفعة: قيد المراجعة أو مقبولة أو غير مؤكدة — مع السبب والخطوة التالية.

ماذا يحدث إذا انتهى اشتراكي؟

يظل الإرسال يعمل لمدة 3 أيام تقويمية بعد الفترة المدفوعة. بعدها يُجاب على كل إرسال بـ403 SUBSCRIPTION_INACTIVE مع الموعد النهائي في details.migration: لمدة 14 يومًا تظل الرسائل الواردة تصل إلى الـwebhook (وقت للتجديد أو نقل أرقامك)، وبعدها تظل تُخزَّن لكنها لا تُرسل إليه. وتظل مسارات القراءة تعمل، ولا يُحذف شيء، والتجديد يعيد كل شيء بالمعرّفات نفسها.

ماذا يحدث إذا حذفت حساب المطوّر؟

تؤكد الحذف من رابط يُرسل إلى بريد حسابك. وخلال الـ14 يومًا التالية يصبح الحساب للاستقبال فقط — تظل الرسائل الواردة تصل إلى الـwebhook، بينما يُرفض الإرسال وإضافة عملاء أو روابط ربط جديدة (403 ACCOUNT_RECEIVE_ONLY) — حتى تنقل أرقام عملائك؛ فـScale لا تنقلها نيابةً عنك. ويمكنك الإلغاء حتى ذلك الحين. وبعد الـ14 يومًا تُحذف بياناتك، وتُحفظ سجلات الفوترة كما تقتضي قوانين الضرائب.

ما أنواع الرسائل التي يمكنني إرسالها؟

النص والصورة والفيديو والصوت والمستند والقوالب المعتمدة. الرسائل الحرة تُرسل لمن راسل هذا الرقم خلال آخر 24 ساعة؛ وخارج هذه النافذة أرسل قالباً معتمداً.

كم رقم واتساب يمكنني ربطه؟

رقمان ضمن اشتراكك، لكل عملائك معاً. وكل رقم بعدهما له اشتراك رقم إضافي تضيفه من لوحتك؛ وقد تتفق Scale معك أيضاً على حد أقصى لحسابك. وإذا انتهى اشتراك رقم إضافي، يظل الرقم متصلاً ويستمر في الاستقبال، لكنه لا يرسل حتى تجدّد.

أضف واتساب إلى منتجك

أنشئ حساب المطوّر، واقرأ التوثيق بالعربية أو الإنجليزية، وأرسل أول رسالة اليوم.

أنشئ حساب مطوّر التوثيق بالإنجليزية التوثيق بالعربية