Intercom HITL

  # تكامل # Intercom HITL

يتيح هذا التكامل Botpress استخدام Intercom كمزود خدمة HITL (الإنسان في الحلقة). ستظهر الرسائل من الروبوت في Intercom وسيتم إرسال ردود الوكيل إلى الروبوت.

## الميزات

- تكامل سلس بين Botpress و Intercom

- مزامنة الرسائل في الوقت الحقيقي
- دعم الرسائل النصية
- إدارة جلسات المحادثة التلقائية
- معالجة الأحداث Webhook
- تعيين الوكلاء وإدارة المحادثات

## التكوين

يتطلب التكامل التكوين التالي:

- `accessToken': رمز الوصول المميز للاتصال Intercom الخاص بك (مطلوب لمصادقة واجهة برمجة التطبيقات)

# ## إعداد تطبيق Intercom للتكامل مع Botpress 

يرشدك هذا الدليل خلال إعداد وتهيئة تطبيق Intercom لتمكين التكامل معchatbot Botpress  الخاص بك.

### تعليمات خطوة بخطوة

#### 1. إنشاء تطبيق Intercom 

* انتقل إلىintercomintercom
* سجّل الدخول إلى حساب Intercom الخاص بك
* انتقل إلى ** التطبيقات** في hub
 المطورين
* انقر على **"إنشاء تطبيق"**
* أدخل اسم تطبيقك (على سبيل المثال،Botpress HITL Integration")
* انقر على **"إنشاء تطبيق"**

#### 2. انسخ رمز الوصول

* في لوحة تحكم التطبيق، انتقل إلى **المصادقة**
* انسخ **رمز الوصول المميز ** الموضح في قسم رمز الوصول المميز
* في **تكوين تكامل Botpress Intercom الصق رمز الوصول المميز هذا

#### 3. تكوين خطافات الويب

##### أ. Webhook
لأحداث المحادثة Webhook

* انتقل إلى **خطافات الويب** في لوحة تحكم تطبيقك
* انقر على **"إضافة Webhook"**
* قم بتعيين Webhook URL لخطاف الويب** إلى **عنوان URL webhook الخاص بتكامل Botpress Intercom 
** **اشترك في هذه الأحداث فقط:**
  * 'المحادثة.admin.admin.appointed'
  * 'المحادثة.admin.admin.closed'
  * 'محادثة.admin.admin.replied'
* انقر فوق **"حفظ Webhook"**

### ملخص تكوين Botpress المطلوب

* ** ** رمز الدخول**: من مصادقة تطبيق Intercom 
** ** عنوان URL Webhook الويب**: مقدم من Botpress

## الاستخدام

1. قم بتكوين التكامل مع رمز الوصول إلى Intercom الخاص بك
2. ابدأ جلسة محادثة باستخدام إجراء 'startHitl'
3. ستظهر الرسائل من الروبوت في محادثات Intercom 
4. سيتم إرسال ردود الوكيل في Intercom إلى البوت
5. تتم إدارة حالة المحادثة تلقائيًا بين Botpress و Intercom

> **ملاحظة:** عند بدء جلسة HITL، إذا لم يكن البريد الإلكتروني للمستخدم موجودًا كجهة اتصال في Intercom فسيتم إنشاء جهة اتصال جديدة تلقائيًا. إذا كان البريد الإلكتروني موجودًا بالفعل، فسيتم استخدام جهة الاتصال الحالية لعملية HITL.

## الدعم

للحصول على الدعم، يُرجى الاتصال بفريق Botpress أو الرجوع إلىIntercom وثائق واجهة برمجة تطبيقاتIntercom ]intercom.

## استكشاف الأخطاء وإصلاحها

### المشكلات الشائعة

1. Webhook خطاف الويب لا يتلقى الأحداث**: تأكد من أن عنوان URL الخاص webhook الخاص بك يمكن الوصول إليه بشكل عام وتم تكوينه بشكل صحيح
2. **أخطاء المصادقة**: تحقق من أن رمز الوصول الخاص بك صحيح ويحتوي على الأذونات المطلوبة
3. **الرسائل لا تتم مزامنتها**: تحقق من أن المحادثة قد تم إنشاؤها بشكل صحيح وأن جهة الاتصال موجودة في Intercom

### وضع التصحيح

قم بتمكين تسجيل التصحيح في تكوين Botpress الخاص بك لاستكشاف مشكلات التكامل وإصلاحها.