تكامل # Botpress HITL
يسمح لك هذا التكامل بتوصيل روبوت Botpress الخاص بك بمنصة محادثات Brevo، مما يتيح إعداد HITL داخل الحلقة (HITL). وهذا يعني أن روبوت Botpress الخاص بك يمكنه التعامل مع تفاعلات المستخدم الأولية وتصعيد المحادثات بسلاسة إلى الوكلاء البشريين في بريفو عند الضرورة.
## كيف يعمل
عندما يتفاعل المستخدم مع روبوت Botpress الخاص بك، يمكن نقل المحادثة إلى وكيل بشري في بريفو. يمكن للوكيل بعد ذلك تولي المحادثة وتقديم دعم مخصص. سيتم نقل الرسائل من مستخدم Botpress إلى وكيل Brevo، والعكس صحيح.
## القيود الرئيسية
يرجى الانتباه إلى القيود التالية عند استخدام هذا التكامل:
- **إسناد الرسائل:** ستظهر الرسائل التي يرسلها مستخدم Botpress إلى وكيل بريفو كما لو كانت مرسلة من حساب وكيل بريفو الذي تم تكوينه مع التكامل. ومع ذلك، لتمييز هذه الرسائل، سيتم إضافتها مسبقًا بـ "مستخدمBotpress :". على سبيل المثال: Botpress مستخدم بوتبريس: مرحبًا، أحتاج إلى مساعدة في طلبي.
- **تحديثات الحالة:** لن يتلقى مستخدم Botpress تلقائيًا إشعارات أو تحديثات الحالة فيما يتعلق بتعيين الوكيل (على سبيل المثال، "انضم الوكيل جون إلى الدردشة").
## دليل الإعداد
لتهيئة تكامل Botpress HITL، ستحتاج إلى ما يلي:
1. ** مفتاح واجهة برمجة تطبيقات بريفو:**
- يمكنك إنشاء وإدارة مفاتيح واجهة برمجة التطبيقات Brevo API الخاصة بك باتباع الإرشادات الموجودة على صفحة المساعدة الرسمية الخاصة بهم: [إنشاء وإدارة مفاتيح واجهة برمجة التطبيقات الخاصة بك] (https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **إلغاء تنشيط حظر بروتوكول الإنترنت:**
- من أجل التواصل السلس بين Botpress و Brevo، من الضروري إلغاء تنشيط حظر IP في حسابك على Brevo.
- انتقل إلى [Brevo IP Authorization](https://app.brevo.com/security/authorised_ips) وتأكد من إلغاء تنشيط حظر IP للسماح بالطلبات من بيئة Botpress الخاصة بك.
3. ** معرف وكيل بريفو:**
- تحتاج إلى تحديد حساب وكيل بريفو الذي سيستخدمه التكامل لإرسال الرسائل واستقبالها.
- انتقل إلى صفحة إعدادات وكلاء بريفو: [إعدادات وكلاء بريفو] (https://conversations-app.brevo.com/settings/agents)
- حدد الوكيل الذي ترغب في استخدامه للتكامل وانسخ معرّف الوكيل الخاص به.
# ## إعداد Webhook (مطلوب)
لتلقي الأحداث من Brevo في تكامل Botpress الخاص بك، يجب عليك إعداد webhook في Brevo:
1. انتقل إلى **عمليات التكامل > خطافات الويب** في لوحة معلومات بريفو الخاصة بك ([رابط مباشر] (https://conversations-app.brevo.com/settings/integrations/webhooks).
2. انقر على **إضافة webhook** (أو قم بتحرير خطاف webhook موجود).
3. في الحقل **URL**، أدخل نقطة نهاية webhook الخاص بتكامل Botpress Brevo. مثال:
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4. ضمن **أنواع الأحداث**، حدد:
- 'محادثة بدأت'
- "نص المحادثة
- ``محادثة_بدأت_محادثة``
5. انقر على **حفظ** لتفعيل webhook.
> **ملاحظة:** تأكد من أن عنوان URL يطابق نقطة نهاية تكامل Botpress وأن جميع أنواع الأحداث المطلوبة قد تم فحصها للحصول على الوظائف الكاملة.
بمجرد إعداد هذا، سيتلقى تكامل Botpress الخاص بك أحداثًا في الوقت الفعلي من Brevo ويمكنه معالجتها وفقًا لذلك.
بمجرد حصولك على هذه التفاصيل، يمكنك متابعة تكوين التكامل داخل بيئة Botpress الخاصة بك وفقًا لتعليمات الإعداد الخاصة بالتكامل.
