awam for developers

نظامك يظل الواجهة. أوام تشغّل واتساب.

أرسل تحديثات أي مسار عمل، اعرض الرصيد وحالة الربط، واستقبل اختيارات العملاء داخل نظامك. كل نشاط يربط رقم WhatsApp Business الخاص به بموافقة Meta.

POST /api/v1/events/{connection-token}ابدأ بسرعة ↓
1

اتصال منفصل لكل نشاط

لا تستخدم نفس المفتاح لأكثر من عميل. كل مفتاح مقيد بمساحة عمل ورصيد ورقم واحد.

2

ربط Coexistence داخل نافذة صغيرة

افتح رابط الربط الذي تنشئه أوام. صاحب النشاط يوافق داخل Meta ثم يعود لنظامك.

3

شغّل المسارات والردود

أرسل كل تغيير بمعرف ثابت، واقرأ ردود الأزرار تدريجيًا بدون تكرار.

UNIVERSAL QUICK START

حدث واحد واضح

استخدم event_id فريد وثابت لكل تغيير. إعادة نفس الحدث آمنة ولن تنشئ سجلًا أو رسالة ثانية.

  • event workflow.status_changed
  • object.id معرف السجل في نظامك
  • object.type نوع السجل: طلب، موعد، شحنة، مهمة أو غيره
  • object.customer الاسم ورقم واتساب الدولي
curl -X POST "https://awam.io/api/v1/events/YOUR_CONNECTION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_id": "workspace-42-record-100-update",
    "event": "workflow.status_changed",
    "object": {
      "id": "RECORD-100",
      "type": "request",
      "customer": {"name": "Mariam", "phone": "+201001112222", "language": "ar"},
      "details": "Your business-specific details"
    }
  }'

ربط Meta بدون مشاركة أسرار Meta

رابط Coexistence مخصص للمتصفح فقط. ضعه في نافذة منبثقة من لوحة نظامك. المفتاح موجود بعد # فلا يُرسل كـ Referer، وأوام تستبدل كود Meta وتخزن التوكن مشفرًا.

واجهات الإنتاج

POST/api/v1/events/{token}

إضافة أو تحديث سجل وتشغيل رسالة مرحلته.

GET/api/v1/account/{token}

الرصيد بالجنيه كقروش، التجربة، الاشتراك، الحصة، سعر الرسالة، حالة الرقم والقوالب المعتمدة.

GET/api/v1/responses/{token}?after_id=0

ردود الأزرار الخاصة فقط بسجلات هذا الاتصال. خزّن next_after_id للجولة التالية.

LINK/connect/whatsapp#{connect-token}

رابط مستقل يظهر مرة عند إنشاء الاتصال أو تدوير المفتاح. افتحه في نافذة جديدة ولا ترسله إلى الخادم كـ API token.

ما الذي يجب أن يعرضه نظامك؟

اعرض الحالة والرصيد داخل واجهتك. عندما status ليست connected اعرض زر ربط واتساب. عندما reauthorization_required تساوي true اعرض إعادة الربط. وعند انخفاض الرصيد اعرض إضافة رصيد أو تواصل مع مسؤول الحساب.

الاستجابات الأساسية

202تم الاستلام أو ينتظر ربط الحالة200تمت القراءة أو حدث مكرر400بيانات غير صحيحة429حد مؤقت؛ أعد المحاولة بتدرج