العودة إلى لوحة التحكم ←

توثيق Momken WhatsApp Local API

واجهة REST تعمل على خادمك الخاص. لا تحتاج إلى حساب SaaS أو خادم تراخيص خارجي. أنشئ مفتاح API من لوحة التحكم → مفاتيح API.

المصادقة

Authorization: Bearer mw_live_YOUR_API_KEY

أنشئ المفاتيح وألغها من لوحة التحكم. تُخزّن المفاتيح على شكل Hash ولا تظهر قيمتها إلا مرة واحدة عند الإنشاء.

جلسة واتساب

GET /v1/whatsapp/session — قراءة حالة الاتصال والربط.

POST /v1/whatsapp/session/pair — بدء ربط الحساب وإنشاء QR.

GET /v1/whatsapp/session/qr.png — جلب صورة رمز QR.

الرسائل والمحادثات

POST /v1/messages — إرسال رسالة نصية أو مرفق (صورة، مستند، ملف صوت أو فيديو).

لإرسال مرفق استخدم multipart/form-data بالحقول to وmessage وfile. الحد الأقصى للمرفق 16 MB، ويُكتشف نوع الملف تلقائياً.

curl -X POST http://127.0.0.1:19100/v1/messages \
  -H 'Authorization: Bearer mw_live_YOUR_API_KEY' \
  -F 'to=15551234567' -F 'message=See attached' \
  -F 'file=@/path/to/photo.jpg'
curl -X POST http://127.0.0.1:19100/v1/messages \
  -H 'Authorization: Bearer mw_live_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"to":"15551234567","message":"Hello from Momken"}'

GET /v1/messages — قراءة آخر الرسائل.

GET /v1/chats — قراءة آخر المحادثات.

تدعم لوحة التحكم صندوق رسائل لحظياً عبر اتصال SSE داخلي موثّق بجلسة المالك؛ تُحدّث الرسائل الواردة والصادرة دون إعادة تحميل الصفحة.

Webhooks

من لوحة التحكم → الويب هوكس، أضف رابط نظامك ومفتاح التوقيع. تُرسل أحداث message.received مع ترويسة X-Momken-Signature وتتم إعادة المحاولة تلقائياً عند فشل التسليم.

فحص الخادم

GET /api/health — حالة تشغيل البرنامج.

GET /api/bootstrap — حالة التهيئة ومعرّف الجهاز.

يحتاج ربط واتساب وإرسال الرسائل إلى اتصال إنترنت مع WhatsApp. هذا المنتج ليس WhatsApp Cloud API الرسمي، ولا يحتاج الاتصال بمنصة Momken السحابية.