​

ابدأ استخدام WhatsApp Business Platform

​

كيف تعمل المنصة

• تحتاج إلى قالب معتمد لبدء المحادثة. أي رسالة ترسلها أنت أولاً — تأكيد طلب، رمز استخدام لمرة واحدة، تحديث شحنة — يجب أن تستخدم قالبًا راجعته Meta ووافق عليه. تأتي القوالب في أربع فئات: authentication وutility وmarketing وservice. الفئة تحدد ما الذي تدفعه.
• الرد يفتح نافذة 24 ساعة. عندما يراسلك عميل، تفتح نافذة خدمة مدتها 24 ساعة. خلالها يمكنك إرسال رسائل حرة (بدون قالب) — نص عادي، وسائط، وأزرار تفاعلية. عندما تغلق النافذة، تعود إلى القوالب فقط. راجع The 24-hour window للاطلاع على النموذج الكامل.

​

قبل أن تبدأ

• حساب Orbit ومفتاح API مباشر (Settings → API Keys). المفاتيح المباشرة تحمل البادئة dv_live_sk_؛ احتفظ بها في جهة الخادم فقط.
• حساب WhatsApp Business Account (WABA) متصل بـ Orbit. إذا لم يكن لديك واحد بعد، اتبع الخطوة 1 — المسار الكامل للحساب والرقم والتحقق موجود في WABA setup guide.

curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "type": "template",
    "template": {
      "name": "order_confirmation",
      "language": { "code": "en" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Ada" },
            { "type": "text", "text": "ORD-12345" }
          ]
        }
      ]
    }
  }'

curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "type": "text",
    "text": { "body": "Thanks for reaching out! How can we help?" }
  }'

curl "https://api.orbit.devotel.io/api/v1/messages/whatsapp/window-status?to=+14155552671&from=+18005551234" \
  -H "X-API-Key: dv_live_sk_..."

​

الأسئلة الشائعة

​

هل أحتاج إلى وصول خاص بي إلى Meta Cloud API لاستخدام WhatsApp Business Platform؟

​

لماذا يجب أن أستخدم قالبًا لمراسلة عميل لأول مرة؟

​

كم تستغرق الموافقة على القالب؟

​

ما هي نافذة الـ 24 ساعة؟

​

كم تكلف رسالة WhatsApp؟

​

هل يمكنني إجراء مكالمات صوتية أو مرئية عبر WhatsApp؟

​

الخطوات التالية

• WABA setup guide — المسار الكامل للحساب والرقم والتحقق.
• The 24-hour window — كيف تعمل نوافذ الخدمة وإعادة التواصل.
• WhatsApp channel reference — كل حقول WhatsApp API بما فيها الوسائط والرسائل التفاعلية.
• WhatsApp pricing — كيف تُسعَّر المحادثات.
• Content policy — ما الذي توافق عليه Meta وما ترفضه.