اربط نظامك بمحادثات عملائك

1. 1

   ولّد مفتاحاً

   الإعدادات ← مفاتيح API. يُعرض مرّة واحدة فقط — انسخه فوراً.

2. 2

   اختر قناة وقالباً

   GET /channels و GET /templates يعطيانك ما هو جاهز للإرسال.

3. 3

   أرسل

   نداء واحد. الرسالة تدخل طابورنا وتصل واتساب خلال ثوانٍ.

curl -X POST https://nawf-backend.onrender.com/api/v1/public/messages/template \
  -H "X-API-Key: sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "9665xxxxxxxx",
    "templateName": "order_confirmed",
    "variables": ["أحمد", "1042"]
  }'

X-API-Key: sk_live_...
# أو
Authorization: Bearer sk_live_...

امنح كل مفتاح أقلّ ما يحتاج. مفتاحُ لوحةِ تقاريرك لا يحتاج SEND — وتسريبُه عندئذٍ يكشف بيانات ولا يُرسل باسمك.

الأساس: https://nawf-backend.onrender.com/api/v1/public — والتوثيق التفاعلي يجرّبها بمفتاحك مباشرةً.

const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
const expected = crypto.createHmac("sha256", secret)
  .update(`${t}.${rawBody}`).digest("hex");

const ok =
  crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1)) &&
  Math.abs(Date.now() / 1000 - Number(t)) <= 300;

وقارن الطابع الزمني: رفضُ ما تجاوز خمس دقائق يجعل إعادةَ بعثِ طلبٍ قديم بلا فائدة. استعمل timingSafeEqual لا === — المقارنة العادية تُسرّب التوقيع بقياس الزمن.

ردّ بـ2xx خلال عشر ثوانٍ. أي ردّ آخر يُعاد ست مرات بتراجع أسّي (٥ث ← ١٦٠ث)، ونقطةٌ تفشل عشرين مرة متتالية تُعطَّل تلقائياً ونُعلمك.

المسار يحمل إصداره (/api/v1/…). أي تغيير كاسر يصدر تحت v2، ويبقى v1 عاملاً حتى إشعار مسبق — فتكاملُك لا ينكسر بنشرةٍ منّا.