واجهة برمجية واحدة لواتساب الأعمال
أرسل رسائل واتساب، واستقبل الردود وتحديثات التسليم، واربط أنظمتك بواجهة برمجية واحدة.
الرابط الأساسي
https://api.saei.automize.sa/v1كل الطلبات تُرسل إلى هذا الرابط عبر HTTPS، مع مفتاحك في ترويسة Authorization.
curl -X POST https://api.saei.automize.sa/v1/messages \
-H "Authorization: Bearer $SAEI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+966500000001",
"type": "text",
"text": { "body": "Hello from SAEI" }
}'أرسل أول رسالة في ثلاث خطوات
مفاتيح الاختبار تحاكي دورة الحياة كاملة بدون أن تلمس واتساب، فتبني وتجرّب قبل أي اعتماد.
أنشئ مفتاح اختبار من المطورين ← مفاتيح API. مفاتيح الاختبار تحاكي كل شيء ولا تصل إلى واتساب أبدًا.
أرسل رسالة إلى الرقم التجريبي +966500000001، وستمر بحالات الإرسال والتسليم والقراءة.
أضف نقطة استقبال ويب هوك وتابع وصول أحداث التسليم موقّعة.
ثلاثة أشياء تحكم كل تكامل
نافذة الـ24 ساعة
لا تصل الرسائل الحرة إلى العميل إلا خلال 24 ساعة من آخر رسالة منه، وخارجها أرسل قالبًا معتمدًا.
العناصر والمعرّفات
لكل عنصر معرّف ببادئة (msg_ وct_ وconv_ وcmp_…). احفظ المعرّفات كنصوص معتمة.
أحداث بدل الاستعلام المتكرر
ترسل الرسائل وجهات الاتصال والمحادثات والقوالب والحملات والتدفقات تغيّراتها إلى نقطة استقبالك، موقّعة وفق Standard Webhooks.
صفحة لكل مورد
كل مورد يشرح نفسه أولاً، ثم يسرد نقاط الواجهة الخاصة به مع أمثلة برمجية جاهزة للنسخ.
- الرسائلأرسل نصًا وقوالب وأزرارًا ووسائط.
- القوالبأنشئ القوالب وتابع اعتمادها.
- جهات الاتصالزامن عملاءك وحقولهم المخصّصة.
- المحادثاتاقرأ صندوق الوارد وأسنده لفريقك.
- الحملاتأطلق حملات جماعية وتابع نتائجها.
- التدفقاتشغّل الردود الآلية من نظامك.
- الوسائطارفع الصور والملفات واستخدمها.
- الأرقامأدر أرقام واتساب المتصلة.
- الويب هوكسجّل نقاط الاستقبال وأدرها.
- الحساب والاستهلاكاعرف حدودك واستهلاكك.
- وضع الاختبارحاكِ كل شيء بدون إرسال حقيقي.
أدلّة مكتوبة، لا مرجع فقط
خمسة عشر دليلاً يغطّون الطريق من أول مفتاح إلى التشغيل الفعلي.
الأسئلة الشائعة
ما الفرق بين واجهة ساعي وواجهة واتساب السحابية من Meta؟
واجهة واتساب السحابية (Cloud API) تُرسل الرسائل فقط. واجهة ساعي تضيف فوقها ما يحتاجه أي تكامل حقيقي: جهات الاتصال، والقوالب واعتمادها، والمحادثات وإسنادها، والحملات، والتدفقات، والوسائط، وأحداث موقّعة لكل تغيّر — بمفتاح واحد ورابط واحد.
هل أستطيع التجربة قبل ربط رقم واتساب؟
نعم. أنشئ مفتاح اختبار وأرسل إلى الرقم التجريبي، فتمرّ الرسالة بحالات الإرسال والتسليم والقراءة كاملة دون أن تلمس واتساب ودون أي تكلفة رسائل.
كيف أتحقّق أن الويب هوك جاءنا منكم فعلاً؟
كل حدث موقّع وفق معيار Standard Webhooks. احسب التوقيع على جسم الطلب بمفتاحك السرّي وقارنه، فترفض أي طلب لم يصدر منّا. دليل «استقبال الويب هوك» يشرح الخطوات.
بأي لغات تتوفّر الأمثلة البرمجية؟
كل نقطة في المرجع تعرض مثالاً جاهزاً للنسخ بثماني لغات، إضافة إلى وصف OpenAPI ومجموعة Postman لتوليد عميلك بنفسك.
هل التوثيق متاح بالعربية والإنجليزية؟
نعم، التوثيق كامل باللغتين — بما في ذلك أسماء الحقول وشروحها ورسائل الأخطاء — ويمكنك التبديل بينهما من داخل التوثيق.