مساحات Chat على Google

  # تكامل Chat من جوجل Botpress

يسمح لك هذا التكامل بتوصيلchatbot لي الخاص بك من Botpress  بمساحات Chat من جوجل، مما يتيح التواصل السلس بين روبوتك ومستخدمي Chat جوجل.

## الميزات

- إرسال واستقبال الرسائل في مساحات Chat Google
- معالجة الرسائل والردود التلقائية
- دعم لمساحات Chat Google المتعددة
- مصادقة آمنة باستخدام حساب خدمة Google

## المتطلبات الأساسية

1. حساب منصة جوجل السحابية (GCP)
2. مساحة Chat جوجل حيث تريد نشر الروبوت الخاص بك
3. مثيل Botpress مع تثبيت تكامل Google Chat 

## تعليمات الإعداد

### 1. تمكين Google Chat API

1. انتقل إلى [Google Cloud Console] (https://console.cloud.google.com)
2. انتقل إلى "واجهات برمجة التطبيقات والخدمات"> "المكتبة"
3. ابحث عن "Google Chat API"
4. انقر على واجهة برمجة تطبيقات Google Chat 
5. انقر فوق "تمكين" لتفعيل واجهة برمجة التطبيقات لمشروعك

### 2. إنشاء حساب خدمة جوجل

1. انتقل إلى [Google Cloud Console] (https://console.cloud.google.com)
2. أنشئ مشروعًا جديدًا أو اختر مشروعًا موجودًا
3. انتقل إلى "IAM & Admin"> "حسابات الخدمة"
4. انقر على "إنشاء حساب خدمة"
5. املأ تفاصيل حساب الخدمة وانقر على "إنشاء"
6. قم بإنشاء مفتاح جديد لحساب الخدمة:
   - انقر على حساب الخدمة
   - انتقل إلى علامة التبويب "المفاتيح"
   - انقر على "إضافة مفتاح"> "إنشاء مفتاح جديد"
   - اختر تنسيق JSON
   - قم بتنزيل ملف المفتاح

### 3. تكوين إعدادات تطبيق Chat Google

1. انتقل إلى [Google Cloud Console] (https://console.cloud.google.com)
2. انتقل إلى "واجهات برمجة التطبيقات والخدمات"> "واجهة برمجة تطبيقات Chat من Google"
3. انقر على "التهيئة"
4. قم بإعداد تطبيقك بالإعدادات التالية:
   - ** اسم التطبيق**: اختر اسمًا لروبوتك
   - **الوصف**: أضف وصفًا لوظائف الروبوت الخاص بك
   - **عنوان URL الصورة الرمزية**: أضف عنوان URL لصورة الصورة الرمزية للروبوت الخاص بك
   - **الميزات **:
     - تمكين الميزات التفاعلية
     - تمكين تلقي رسائل 1-1
     - تمكين الانضمام إلى المساحات والمحادثات الجماعية
   - **عنوان URL لنقطة نهاية HTTP**: قم بتعيين هذا على عنوان URL الخاصwebhook  Botpress  الموجود في تكوين تكامل Chat Google.

### 4. تكوين التكامل في Botpress

1. في مثيل Botpress الخاص بك، انتقل إلى قسم التكاملات
2. ابحث عن تكامل Google Chat وحدد تكامل Google Chat 
3. قم بتكوين الإعدادات التالية:
   - **حساب الخدمة JSON**: الصق محتويات ملف مفتاح حساب الخدمة الذي تم تنزيله بالكامل
   - **المساحة الافتراضية**: أدخل مُعرِّف مساحة Chat الافتراضية الخاصة بك على Google (اختياري)

### 5. أضف الروبوت إلى مساحة Chat Google الخاصة بك

1. افتح مساحة Chat جوجل الخاصة بك
2. انقر على اسم المساحة لفتح تفاصيل المساحة
3. انتقل إلى "التطبيقات والتكاملات"
4. انقر على "إضافة تطبيقات"
5. ابحث عن الروبوت الخاص بك باستخدام البريد الإلكتروني لحساب الخدمة
6. أضف الروبوت إلى مساحتك

## الاستخدام

### إرسال الرسائل

يمكن للبوت إرسال رسائل إلى أي مساحة Chat على Google تمت إضافته إليها. يمكن إرسال الرسائل
- ردًا على رسائل المستخدم
- بشكل استباقي من خلال محرر تدفق Botpress 
- عن طريق مكالمات واجهة برمجة التطبيقات من التعليمات البرمجية المخصصة

### تلقي الرسائل

يتلقى البوت تلقائيًا الرسائل المرسلة في مساحة Chat Google ويعالجها. سيقوم بـ
- تحليل الرسائل الواردة
- معالجتها من خلال تدفقات Botpress الخاصة بك
- إرسال الردود المناسبة إلى المساحة

### تنسيق الرسالة

يدعم التكامل الرسائل النصية في مساحات Chat Google. يمكن أن تتضمن الرسائل
- نص عادي
- التنسيق الأساسي
- الروابط
- الإشارات

## اعتبارات الأمان

- احتفظ بمفتاح حساب الخدمة الخاص بك آمنًا ولا تشاركه علنًا أبدًا
- تدوير مفاتيح حساب الخدمة بانتظام
- استخدم مبدأ أقل امتيازات عند تعيين الأدوار لحساب الخدمة الخاص بك
- راقب نشاط الروبوت الخاص بك وقم بإعداد التسجيل المناسب

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

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

1. **الروبوت لا يستجيب**
   - تحقق من أن حساب الخدمة لديه الأذونات الصحيحة
   - تحقق مما إذا تمت إضافة الروبوت بشكل صحيح إلى المساحة
   - تأكد من تكوين التكامل بشكل صحيح في Botpress

2. **أخطاء المصادقة**
   - تحقق من تنسيق حساب الخدمة JSON بشكل صحيح
   - تحقق مما إذا كان مفتاح حساب الخدمة صالحًا وغير منتهي الصلاحية
   - تأكد من تمكين نطاقات واجهة برمجة التطبيقات الضرورية لحساب الخدمة.

3. **مشكلات توصيل الرسائل**
   - تحقق من صحة معرّف المساحة
   - تحقق مما إذا كان لدى الروبوت إذن للنشر في المساحة
   - تأكد من صحة تنسيق الرسالة

## مرجع واجهة برمجة التطبيقات

لمزيد من التفاصيل حول واجهة برمجة تطبيقات Chat من Google، راجع [الوثائق الرسمية] (https://developers.google.com/chat/api/reference/rest).