نظرة عامة على الواجهة البرمجية العامة
تتيح الواجهة البرمجية العامة (Public API) لمجيب لخادمك (CRM، أتمتة، تطبيق مخصص) إرسال رسائل واتساب من خلال الوكلاء الذين أعددتهم في مجيب. تستخدم مفاتيح API طويلة الأمد، وتقبل JSON، وتُعيد ظروف أخطاء بأسلوب Stripe — مصمّمة للتكامل المتوقَّع بين الخوادم.
ماذا يمكنني أن أفعل بالواجهة البرمجية العامة؟
في الإصدار الأول، تُركّز الواجهة على إرسال رسائل واتساب الصادرة:
- إرسال رسائل نصية حرة داخل نافذة خدمة العملاء (24 ساعة) من ميتا
- إرسال قوالب معتمدة مسبقاً في أي وقت (بما في ذلك خارج نافذة الـ24 ساعة)
- الاستعلام عن حالة تسليم رسالة سبق إرسالها
الرسائل المُرسَلة عبر الواجهة تنضم إلى نفس المحادثة التي تنشئها رسائل webhook الواردة، فتظل لوحة التحكم موحّدة — عميل واحد، محادثة واحدة، بصرف النظر عن من بدأ الحديث.
من أين أحصل على مفتاح API؟
ادخل إلى لوحة تحكم مجيب وافتح صفحة مفاتيح API من الشريط الجانبي. الميزة متاحة في خطة Professional وما فوق. تبدو المفاتيح هكذا: mk_live_8aB3cDe4FgH5iJ6kLm7nOp_a1b2c3d4e5 وتُعرض مرة واحدة فقط عند الإنشاء — احفظها كأي كلمة سر قاعدة بيانات.
راجع التوثيق لمزيد من التفاصيل عن صيغة المفتاح، النطاقات (scopes)، والتقييد لكل وكيل.
هل الواجهة البرمجية مستقرة؟
نعم. كل ما تحت /v1/ مستقر إلى الأبد — تغييرات إضافية فقط. حقول اختيارية جديدة، رموز خطأ جديدة، ونقاط نهاية جديدة قد تظهر دون إشعار؛ لا شيء قائم سيُعاد تسميته أو يُحذف أو يتغير معناه. أي تغيير يكسر التوافق يتطلب مساراً جديداً /v2/. تكاملك مع /v1/ سيظل يعمل مع تطوّر المنصة.
من أين أبدأ؟
أسرع طريق هو البدء السريع في 5 دقائق — أمر curl واحد يُرسل رسالتك الأولى. بعد أن يعمل ذلك، تغطي صفحات التوثيق والإعادة الآمنة وحدود المعدّل وكتالوج الأخطاء كل ما تحتاجه للإنتاج.
العقد الكامل القابل للقراءة آلياً موجود في مرجع الواجهة — مفيد لإنشاء SDKs ولاستيراد Postman.
أسئلة شائعة
هل هذه الواجهة مخصّصة لعملاء المتصفح أو الجوّال؟
لا. تستخدم الواجهة العامة مفاتيح API طويلة الأمد ويجب أن تعمل من جانب الخادم فقط. لعملاء المتصفح أو الجوّال، استخدم ودجة الموقع أو الواجهات المضمَّنة في لوحة التحكم.
كيف يختلف هذا عن أزرار "إرسال" في لوحة التحكم؟
الإرسال من لوحة التحكم يستخدم جلسة المستخدم المسجَّل (JWT) ويمر بنفس مُنسّق الإرسال الذي تستخدمه الواجهة العامة — آلية التسليم الفعلية متطابقة. تتيح لك الواجهة العامة فقط تشغيل عمليات الإرسال من خادمك بمفتاح API بدلاً من النقر على الأزرار.
ما القنوات المدعومة؟
واتساب فقط في الإصدار الأول. Facebook Messenger، Instagram، وقنوات أخرى محجوزة كمسارات إضافية مستقبلية مثل /v1/messenger/* و /v1/instagram/*.
أين توجد SDKs الرسمية؟
لا نُصدر SDKs رسمية بعد. مواصفة OpenAPI 3.1 تتيح لك إنشاء واحد بأي لغة باستخدام openapi-generator، أو استيرادها إلى Postman/Insomnia للاختبار السريع. إذا احتجت لغة معيّنة، تواصل مع الدعم.