## ما هو تكامل رائع ببساطة لربط حساب Typeform الخاص بك بحسابك على Botpress Bot. أرسل النماذج إلى المستخدمين واستقبل حدثًا مع ردودهم عند اكتمالها. ## كيف يعمل يمكن استخدام إجراء "إرسال رابط Typeform" لإنشاء رابط جديد للنموذج الذي ترغب في استخدامه. يتطلب معرف المحادثة وعنوان URL للنموذج. 'معرّف المحادثة' هو معرّف فريد لكل محادثة. يمكنك التمرير في هذا الحقل لتضمين المعرف الخاص بك. عند تلقي حدث يمكنك استخدامه في حقل 'معرّف المحادثة' في حقل 'معرّف المحادثة' في 'مشغّل حدث النموذج' في الخيارات المتقدمة. سيؤدي هذا إلى دفع الحدث إلى المحادثة المناسبة. 'عنوان URL للنموذج' هو عنوان url للنموذج الذي ترغب في استخدامه. يمكنك العثور على الرابط ضمن 'مشاركة' -> 'نسخ الرابط'. تأكد من أنك قمت بإعداد الحقل المخفي من إعداد Typeform لتمرير معرف المحادثة. يمكنك الاطلاع على كود التكامل الكامل على: https://github.com/SimplyGreatBots/typeform ## إعداد Typeform 1. انتقل إلى [حسابك في Typeform] (https://admin.typeform.com/user) وانقر على 'رموز الوصول الشخصي'. 2. انقر على "إنشاء رمز مميز جديد"، وقم بتسمية الرمز المميز الخاص بك، وانقر على "إنشاء رمز مميز". 3. بعد إنشاء الرمز المميز، انسخه واحفظه في مكان آمن. انتقل إلى إعداد Botpress ثم عد إلى الخطوات النهائية. 4. قم بإنشاء/افتح النموذج الذي ترغب في دمجه مع الروبوت الخاص بك وانقر فوق 'اتصال' في القائمة العلوية. 5. حدد خيار Webhooks وانقر فوق 'إضافة Webhook'. 6. الصق عنوان URL الخاص بك Botpress Typeform Webhook في حقل 'نقطة النهاية' وانقر على 'حفظ Webhook'. 7. انقر فوق تحرير على Webhook الجديد الخاص بك وأضف الرمز المميز لـ Typeform Access إلى الحقل 'سر' واحفظ التغييرات. 8. الخطوة الأخيرة هي إعداد حقل مخفي في النموذج الخاص بك بمعرف محادثة. انقر على 'إنشاء' في النموذج -> 'المنطق' -> 'تخصيص بالبيانات' -> 'الحقول المخفية'. 9. انقر فوق 'إضافة حقل جديد' وقم بتسميته بالضبط: "معرّف المحادثة 10. احفظ وأنت الآن جاهز لاستخدام تكامل Botpress Typeform . ## Botpress الإعداد 1. انقر فوق "تثبيت" في أعلى اليمين وحدد الروبوت الخاص بك. 2. انقر فوق النافذة المنبثقة التي تظهر لتهيئة التكامل الخاص بك. 3. أضف رمز الوصول المميز ل Typeform الخاص بك إلى حقل "رمز الوصول المميز". 4. قم بتمكين التكامل وحفظه. 5. انسخ عنوان URL الخاص بك Webhook للتكامل. سيتم استخدام هذا في الخطوة 6 من إعداد Typeform.