الربط البرمجي
هاي الصفحة موجّهة فقط لمبرمج بدك تربط نظامه (متجر إلكتروني، تطبيق خاص) بواتساب تلقائياً. إذا ما عندك حدا يبرمج، تجاهل هاي الصفحة بالكامل — كل شي تحتاجه (الرد الآلي، الحملات، ربط واتساب) موجود جاهز بلوحة التحكم بدون أي برمجة.
أنا مبرمج، وريني التفاصيل
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 | إشعار فوري كل ما توصل رسالة جديدة |
أخطاء إرسال الرسائل
402 | insufficient_credits — الرصيد غير كافٍ |
409 | no_connected_whatsapp_session — لا يوجد رقم متصل |
503 | engine_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();