التوثيق / مرجع الواجهة البرمجية
نظرة على الواجهة البرمجية
أرسل رسائل واتساب واستقبل الأحداث من أنظمتك.
تتيح واجهة رد البرمجية لنظام CRM أو ERP أو موقعك أو خادمك إرسال رسائل واتساب وتسجيل موافقة العملاء، وتخبرك عبر Webhooks عند وصول الرسائل أو تغير حالتها. كل شيء يعمل على واجهة واتساب Cloud الرسمية، لذا تنطبق قواعد واتساب: نافذة 24 ساعة والموافقة المسبقة وحدود باقتك.
#العنوان الأساسي
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…وتُطبَّع.