## ما هو ببساطة تكامل رائع لربط حساب Aftership الخاص بك مع روبوت Botpress الخاص بك. تتبع الشحنات في الوقت الفعلي وأبلغ المستخدمين مباشرةً من خلال الروبوت الخاص بك عند حدوث تحديثات. ## كيف يعمل عند تمكين التكامل، يتم تكوين اشتراك Webhook لحساب Aftership الخاص بك باستخدام "مفتاح واجهة برمجة التطبيقات" المقدم. يرسل هذا webhook تحديثات إلى التكامل كلما حدث تغيير كبير في حالة تتبع الشحنة. يمكن استخدام إجراء "تتبع الشحنة" لبدء تتبع الشحنة. وهو يتطلب "رقم تعقب" ويستخدم واجهة برمجة تطبيقات Aftership لجلب ومراقبة حالة الشحنة، مع تضمين "معرف محادثة" فريد داخل بيانات التعقب. يُستخدم هذا المعرف بعد ذلك لتشغيل "حدث ما بعد الشحن" داخل المحادثة، مما يمكّن الروبوت الخاص بك من الاستجابة لتحديثات الشحن. "معرّف المحادثة" هو معرّف فريد لكل محادثة. يمكنك تمرير "" في هذا الحقل لتضمين المعرف الخاص بك. عند تلقي تحديث ما بعد المحادثة، يمكنك استخدام `` في حقل "معرّف المحادثة" في الخيارات المتقدمة في حقل "مشغّل حدث ما بعد المحادثة". يؤدي ذلك إلى توجيه التحديث إلى المحادثة المناسبة. يمكنك عرض كود التكامل الكامل على صفحة Git الخاصة بـ Simply Great Bots: [Aftership Repo] (https://github.com/SimplyGreatBots/Aftership) ### إعدادات ما بعد التشغيل #### المتطلبات الأساسية يجب أن يكون لديك خطة Aftership Pro أو أعلى لتلقي webhook الأحداث للتتبع. #### الحصول على مفتاح API 1. انتقل إلى [لوحة تحكم مسؤول ما بعد التدريب] (https://admin.aftership.com/). 2. انتقل إلى 'المطورين' -> 'مفاتيح واجهة برمجة التطبيقات'. 3. انقر على "إنشاء مفتاح واجهة برمجة التطبيقات"، وقم بتسمية مفتاحك، وحدد "حفظ". 4. انسخ مفتاح API الخاص بك والصقه في مكان آمن، ستحتاج إليه أثناء إعداد Botpress . #### Webhook والسرّ 1. انتقل إلى [لوحة معلومات التتبع -> الإشعارات -> خطافات الويب] (https://admin.aftership.com/notifications/webhooks#). 2. انسخ Webhook السر الخاص بك والصقه في مكان آمن. ستحتاج إلى ذلك أثناء إعداد Botpress . 3. انقر على 'إضافة Webhook'. 4. اضبط الإصدار webhook على الإصدار الافتراضي "Legacy". 5. قم بلصق عنوان URL Webhook من تكامل Botpress Aftership الخاص بك في الحقل "Webhook URL". 6. احفظ إعدادات webhook . ### Botpress الإعداد 1. قم بنسخ ولصق مفتاح واجهة برمجة التطبيقات الخاصة بك من إعدادات Aftership في حقل "مفتاح واجهة برمجة التطبيقات". 2. انسخ والصق "Webhook السر" الخاص بك من إعداد ما بعد التدريب في حقل "السر".
