الموقع فى النسخه التجربيه الان
واتساب API والربط البرمجي

ابدأ مع WhatsApp API: مفاتيح الربط وإرسال أول رسالة من تطبيقك

فريق دعم سمارت ون جروبآخر تحديث: 5 دقائق قراءة

الإجابة المختصرة

لإرسال رسالة واتساب من تطبيقك عبر WhatsApp API من سمارت ون جروب اربط رقمك أولًا، ثم انسخ «مفتاح API» و«المفتاح السري» من تبويب «ربط API» في خدمات واتساب. أرسل طلب POST إلى https://sog.sog.eg/api/whatsapp/create-message بالحقول appkey وauthkey وto وmessage. الرد الناجح يكون 200 ومعه message_id، والرسالة تخرج من رقمك المربوط.

في هذه الصفحة

خطوات إرسال أول رسالة

  1. الخطوة 1: اربط رقم واتساب

    الإرسال يخرج من رقم مربوط بحالة متصل. إن لم تفعل بعد، اتبع شرح ربط رقم واتساب.

  2. الخطوة 2: انسخ المفاتيح ورابط الإرسال

    افتح خدمات واتساب ← تبويب ربط API. انسخ مفتاح API (يُرسل باسم appkey) والمفتاح السري (يُرسل باسم authkey) ورابط الإرسال. احفظهما في متغيرات بيئة على سيرفرك وليس داخل الكود.

  3. الخطوة 3: أرسل أول رسالة

    أرسل طلب POST بالحقول appkey وauthkey وto (رقم المستلم بالصيغة الدولية مثل 201012345678) وmessage. أضف الهيدر Accept: application/json ليرجع أي خطأ بصيغة JSON.

    curl -X POST https://sog.sog.eg/api/whatsapp/create-message \
      -H "Accept: application/json" \
      -d appkey=YOUR_API_KEY \
      -d authkey=YOUR_SECRET_KEY \
      -d to=201012345678 \
      -d message="Hello from Example Store 👋"
  4. الخطوة 4: اقرأ الرد

    الرد 200 يعني أن واتساب استلم الرسالة من رقمك، واحتفظ بـ data.id لمتابعة حالتها لاحقًا. أي رد آخر يحمل message يشرح السبب، ومعه غالبًا code تجده في جدول الأخطاء.

    {
      "message_status": "Success",
      "data": {
        "id": 4182,
        "to": "201012345678",
        "status_code": 200,
        "message_id": "3EB0A1C2D3E4F5A6B7C8"
      }
    }

ما الحدود التي تطبقها باقتك على الـ API؟

تبويب الباقة والاستخدام يعرض اسم الباقة وتاريخ انتهائها، والرسائل المستخدمة من الحد، وعدد الأجهزة والتطبيقات، وكل ميزة مشمولة. أهم ما يؤثر على تطبيقك:

  • حد الرسائل: عند الوصول إليه يرجع 403 بالكود quota_exceeded، وقد يقترح الرد باقة أعلى.
  • أقل مدة بين الرسائل (ثانية): لو أرسلت أسرع منها يرجع 429 بالكود rate_limited؛ انتظر ثم أعد المحاولة.
  • حد الطلبات: حتى 60 طلبًا في الدقيقة من نفس عنوان IP على كل روابط الـ API.
  • الميزات: إرسال الملفات والقوالب والحملات والـ Webhook تعمل فقط إن كانت مشمولة في الباقة، وإلا يرجع feature_disabled.

كيف أحمي مفاتيح الـ API؟

  • استدعِ الـ API من سيرفرك فقط. لا تضع المفاتيح في JavaScript يعمل في المتصفح أو داخل تطبيق موبايل.
  • لكل نظام تطبيق مستقل: اكتب اسمًا في اسم التطبيق (اختياري) واضغط إضافة تطبيق في حدود عدد التطبيقات في باقتك.
  • إذا تسرب مفتاح اضغط إعادة توليد المفاتيح فورًا؛ المفاتيح القديمة تتوقف في الحال، فحدّث سيرفرك بالجديدة.

كيف أجرّب الربط بدون إرسال رسائل حقيقية؟

اطلب مفاتيح Sandbox مرة واحدة بمفاتيحك الحالية. أي إرسال بمفاتيح الـ Sandbox يرجع 200 ومعرّف رسالة يبدأ بـ sandbox- دون أن يصل شيء إلى واتساب، فتختبر الكود بأمان. مفاتيح الـ Sandbox تُحسب تطبيقًا من حد التطبيقات في باقتك، فإذا كان الحد ممتلئًا يرجع الطلب quota_exceeded.

curl -X POST https://sog.sog.eg/api/whatsapp/sandbox \
  -H "Accept: application/json" \
  -d appkey=YOUR_API_KEY \
  -d authkey=YOUR_SECRET_KEY

# → 201 {"data":{"appkey":"…","authkey":"…","sandbox":true}}
# Use the returned keys while testing: every send answers 200 with a
# message_id like "sandbox-12", and nothing is delivered to WhatsApp.

أسئلة متكررة

الأفضل الصيغة الدولية بالأرقام فقط مثل 201012345678 أو +201012345678. الرقم المصري المحلي مثل 01012345678 مقبول ويُحوّل تلقائيًا إلى الصيغة الدولية.

create-message أبسط طريقة لإرسال نص فقط. send يدعم النصوص والصور والملفات والقوالب وهيدر Idempotency-Key لمنع التكرار، وتفاصيله في مرجع WhatsApp API.

المفتاحان غير صحيحين أو أُعيد توليدهما، أو اشتراك الباقة غير نشط. انسخ المفتاحين من جديد من تبويب ربط API وتأكد من حالة اشتراكك في قسم الاشتراكات.

لا تفعل ذلك؛ أي كود يعمل في المتصفح يكشف مفاتيحك لأي زائر. أرسل الطلب من سيرفر موقعك، واجعل الصفحة تطلب من سيرفرك.

جاهز تبدأ؟

ابدأ مع WhatsApp API: مفاتيح الربط وإرسال أول رسالة من تطبيقك

افتح مفاتيح الـ API