MegaSender — واجهة المطوّرين

تكامل مع منصات أخرى لإرسال واستقبال رسائل واتساب وإنشاء الحسابات تلقائياً.

المحتويات: المصادقة إرسال رسالة إرسال جماعي استقبال الرسائل إنشاء حساب الأخطاء

الرابط الأساسي

https://wa.c4c-eg.com/api

المصادقة

نقاط الرسائل تستخدم مفتاحين:

إنشاء الحساب يستخدم مفتاحاً رئيسياً للأدمن (master_key). يولّده الأدمن من هنا: https://wa.c4c-eg.com/admin/api-access

إرسال رسالة

POST https://wa.c4c-eg.com/api/create-message
الحقلمطلوبالوصف
appkeyنعممفتاح التطبيق
authkeyنعممفتاح الحساب
toنعمرقم المستلم مع مفتاح الدولة
messageلانص (مطلوب إن لم يوجد template_id)
template_idلامعرّف القالب (مطلوب إن لم توجد رسالة)
fileلارابط وسائط (jpg, png, pdf, ...)
curl -X POST 'https://wa.c4c-eg.com/api/create-message' \
  -F 'appkey=YOUR_APP_KEY' \
  -F 'authkey=YOUR_AUTH_KEY' \
  -F 'to=201000000001' \
  -F 'message=Hello from the API'
{ "message_status": "Success", "data": { "to": "201000000001", "status_code": 200 } }

إرسال جماعي (دعائي)

POST https://wa.c4c-eg.com/api/send-bulk
الحقلمطلوبالوصف
appkey / authkeyنعمكما أعلاه
recipientsنعممصفوفة أرقام (بحد 500)
message / template_idنعمنص أو معرّف قالب
delayلاميلي ثانية بين الرسائل (افتراضي 2000)
curl -X POST 'https://wa.c4c-eg.com/api/send-bulk' \
  -F 'appkey=YOUR_APP_KEY' \
  -F 'authkey=YOUR_AUTH_KEY' \
  -F 'recipients[]=201000000001' \
  -F 'recipients[]=966500000002' \
  -F 'message=Promo message'

استقبال الرسائل (Webhook)

اضبط رابط Webhook على جهازك (أجهزتي ← تعديل). كل رسالة واردة تُرسَل (POST) إلى رابطك:

{
  "payload": { "type": "MESSAGES_UPSERT",
    "data": [ { "key": { "remoteJid": "201234567890@s.whatsapp.net", "fromMe": false },
               "message": { "conversation": "incoming text" } } ] },
  "sender": "201234567890",
  "receiver": "YOUR_DEVICE_NUMBER"
}

يجب أن يقبل رابطك POST ويُرجِع HTTP 200.

إنشاء حساب تلقائياً

POST https://wa.c4c-eg.com/api/register

للمنصات/الموزّعين لإنشاء حسابات برمجياً. يتطلب المفتاح الرئيسي للأدمن.

الحقلمطلوبالوصف
master_keyنعمالمفتاح الرئيسي للأدمن (أو ترويسة X-Master-Key)
nameنعمالاسم الكامل
emailنعمبريد فريد
passwordنعم8 أحرف على الأقل
phoneلارقم الهاتف
plan_idلاتعيين خطة عند الإنشاء
curl -X POST 'https://wa.c4c-eg.com/api/register' \
  -F 'master_key=YOUR_MASTER_KEY' \
  -F 'name=John Doe' \
  -F 'email=john@example.com' \
  -F 'password=secret123'
{ "message": "Account created",
  "data": { "user_id": 42, "email": "john@example.com", "authkey": "xxxxxxxx..." } }
القيمة المُعادة authkey هي ما يستخدمه الحساب الجديد لواجهة الإرسال أعلاه.

الأخطاء

الرمزالمعنى
401مفتاح مصادقة/تطبيق أو رئيسي غير صالح
400الجهاز غير متصل أو فشل الطلب
422خطأ تحقق (حقول ناقصة/غير صالحة)