التوثيق / مرجع الواجهة البرمجية

نظرة على الواجهة البرمجية

أرسل رسائل واتساب واستقبل الأحداث من أنظمتك.

تتيح واجهة رد البرمجية لنظام CRM أو ERP أو موقعك أو خادمك إرسال رسائل واتساب وتسجيل موافقة العملاء، وتخبرك عبر Webhooks عند وصول الرسائل أو تغير حالتها. كل شيء يعمل على واجهة واتساب Cloud الرسمية، لذا تنطبق قواعد واتساب: نافذة 24 ساعة والموافقة المسبقة وحدود باقتك.

#العنوان الأساسي

Base URL
https://your-domain/v1/api

استبدل your-domain بعنوان واجهة رد البرمجية لديك. كل الطلبات والاستجابات JSON عبر HTTPS.

#نقاط النهاية

الطريقة والمسارالغرضالصلاحية
POST /messagesإرسال رسالة نصية أو قالب.messages:send
GET /messages/{id}قراءة حالة تسليم رسالة.messages:read
POST /contactsتسجيل موافقة جهة اتصال.contacts:write

#الاتفاقيات

  • أرسل Content-Type: application/json في الطلبات التي لها جسم.
  • صادق كل طلب بمفتاح API. راجع المصادقة.
  • استخدم ترويسة Idempotency-Key في الإرسال حتى لا تُرسل إعادة المحاولة مرتين.
  • تستخدم الأخطاء رموز HTTP قياسية وcode ثابتاً. راجع الأخطاء والحدود.
  • الأرقام: صيغة دولية (966501234567). تُقبل 05… و+966… وتُطبَّع.
نظرة على الواجهة البرمجية · توثيق رد