واجهة برمجة التطبيقات (API) وعمليات الويبهوك
يضيف الإصدار الاحترافي طريقتين لربط PrimoCRM ببقية أدواتك: مفاتيح واجهة برمجة التطبيقات (API keys) للوصول البرمجي، وعمليات الويبهوك الصادرة (outgoing webhooks) لدفع الأحداث إلى الأنظمة الأخرى.
مفاتيح واجهة برمجة التطبيقات
Section titled “مفاتيح واجهة برمجة التطبيقات”تتيح مفاتيح واجهة برمجة التطبيقات للتطبيقات والبرامج الخارجية قراءة وكتابة بيانات PrimoCRM برمجياً.
- اذهب إلى الإعدادات ثم API وأنشئ مفتاحاً.
- احفظ المفتاح بطريقة آمنة. تعامل معه ككلمة مرور.
- استخدمه للمصادقة على الطلبات القادمة من تطبيقك.
الاستخدامات النموذجية:
- مزامنة جهات الاتصال من نظام لا يحتوي على تكامل مباشر.
- إضافة أو تحديث جهات الاتصال من تدفق تسجيل مخصص.
- سحب البيانات إلى لوحة تحكم داخلية.
عمليات الويبهوك الصادرة
Section titled “عمليات الويبهوك الصادرة”يقوم إجراء التشغيل الآلي للـ ويبهوك الصادر بإرسال طلب HTTP POST إلى عنوان URL تحدده عندما يصل التدفق إلى تلك الخطوة. استخدامه لإشعار الخدمات الأخرى في الوقت الفعلي.
- أضف خطوة ويبهوك صادر إلى التشغيل الآلي.
- حدد عنوان URL المستهدف.
- قم بتكوين الحمولة (payload). يمكنك تضمين بيانات جهة الاتصال عبر الرموز الذكية.
مثال عملي
Section titled “مثال عملي”- المشغل: إنشاء طلب WooCommerce.
- الويبهوك الصادر: إرسال طلب POST إلى خدمة التجهيز الخاصة بك مع بريد جهة الاتصال وتفاصيل الطلب.
- إضافة وسم:
customer.
في اللحظة التي يتم فيها تقديم الطلب، يتم إشعار نظامك الخارجي ووسم جهة الاتصال، دون أي خطوة يدوية.
ملاحظات الأمان
Section titled “ملاحظات الأمان”- وجه الويبهوك فقط نحو نقاط النهاية التي تسيطر عليها أو تثق بها. يمكن للويبهوك نقل بيانات جهة الاتصال إلى عنوان URL الوجهة.
- فضل وجهات HTTPS حتى يتم تشفير الحمولة أثناء النقل.
- تحقق من صحة طلبات الويبهوك الواردة في الجانب المستقبل.
تم إدراج مواقع هذه العناصر في الكتالوج تحت المشغلات والإجراءات.