الإجابة المختصرة
لإرسال رسالة واتساب من تطبيقك عبر WhatsApp API من سمارت ون جروب اربط رقمك أولًا، ثم انسخ «مفتاح API» و«المفتاح السري» من تبويب «ربط API» في خدمات واتساب. أرسل طلب POST إلى https://sog.sog.eg/api/whatsapp/create-message بالحقول appkey وauthkey وto وmessage. الرد الناجح يكون 200 ومعه message_id، والرسالة تخرج من رقمك المربوط.
في هذه الصفحة
خطوات إرسال أول رسالة
الخطوة 1: اربط رقم واتساب
الإرسال يخرج من رقم مربوط بحالة متصل. إن لم تفعل بعد، اتبع شرح ربط رقم واتساب.
الخطوة 2: انسخ المفاتيح ورابط الإرسال
افتح خدمات واتساب ← تبويب ربط API. انسخ مفتاح API (يُرسل باسم
appkey) والمفتاح السري (يُرسل باسمauthkey) ورابط الإرسال. احفظهما في متغيرات بيئة على سيرفرك وليس داخل الكود.الخطوة 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: اقرأ الرد
الرد
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.جاهز تبدأ؟
ابدأ مع WhatsApp API: مفاتيح الربط وإرسال أول رسالة من تطبيقك

