API

الربط البرمجي

هاي الصفحة موجّهة فقط لمبرمج بدك تربط نظامه (متجر إلكتروني، تطبيق خاص) بواتساب تلقائياً. إذا ما عندك حدا يبرمج، تجاهل هاي الصفحة بالكامل — كل شي تحتاجه (الرد الآلي، الحملات، ربط واتساب) موجود جاهز بلوحة التحكم بدون أي برمجة.

أنا مبرمج، وريني التفاصيل
1
أنشئ مفتاحك الخاص من صفحة مفاتيح الـ API بلوحة التحكم — زر "+ مفتاح جديد".
2
الرابط الأساسي
https://whatsappsender.codenji.com/api/v1

مثال: إرسال رسالة واتساب

غيّر wsk_xxxxxxxx بمفتاحك، و962790000000 برقم المستلم:

curl -X POST https://whatsappsender.codenji.com/api/v1/messages \
  -H "Authorization: Bearer wsk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"to": "962790000000", "message": "مرحباً! طلبك جاهز 🎉"}'

إذا نجح الإرسال بيرجعلك:

{ "data": { "id": "msg_...", "status": "sent" } }

إيش فيه غير الإرسال؟

GET /meبيانات حسابك ورصيدك
GET /messagesآخر الرسائل المرسلة والمستقبلة
/auto-replyالتحكم بقواعد الرد الآلي برمجياً
/webhooksإشعار فوري كل ما توصل رسالة جديدة

أخطاء إرسال الرسائل

402insufficient_credits — الرصيد غير كافٍ
409no_connected_whatsapp_session — لا يوجد رقم متصل
503engine_not_configured — محرك الاتصال غير مُفعّل

قواعد الرد الآلي (POST /auto-reply)

{
  "name": "استفسار المنيو",
  "match_mode": "contains",   // contains | exact | starts_with | any
  "keywords": ["منيو", "أسعار"],
  "reply_text": "أهلاً! منيو اليوم هنا: https://...",
  "is_welcome_message": false,
  "priority": 10
}

Webhooks

GET|POST /webhooks (رابط https فقط) · DELETE /webhooks/:id

كل رسالة واتساب واردة تُرسل POST لرابطك، موقّعة بـ HMAC-SHA256:

POST <رابطك>
X-Signature: <hmac-sha256(secret, raw-body)>
Content-Type: application/json

{
  "event": "message.received",
  "data": { "from": "962790000000", "body": "مرحباً", "tenantId": "..." },
  "ts": 1732550400000
}

التحقق من التوقيع (Node.js):

const crypto = require("crypto");
const expected = crypto.createHmac("sha256", webhookSecret).update(rawBody).digest("hex");
if (expected !== req.headers["x-signature"]) return res.status(401).end();