تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نظرة عامة

أنشئ تطبيقات Google Chat تنقل خدماتك ومواردك مباشرةً إلى Google Chat، ما يتيح للمستخدمين الحصول على المعلومات واتّخاذ الإجراءات بدون مغادرة المحادثة

يتيح Google Chat التعاون بين أعضاء الفريق من خلال توفير ما يلي:

الرسائل المباشرة بين المستخدمين
المحادثات المُسلسلة ضمن المساحات
مساحات Chat التي تتيح لك تخصيص مساحة للمناقشة على أساس كل مشروع أو فريق أو غير ذلك
تطبيقات المحادثة التي يمكنها المشاركة في المساحات أو الردّ على الرسائل المباشرة

الرسائل والمساحات

تحدث التفاعلات بين Google Chat وتطبيقات Chat باستخدام الرسائل في سياق مساحات معيّنة. على سبيل المثال، يمكن لتطبيق Chat إرسال نص (نوع من الرسائل) إلى مساحة Chat معيّنة.

تشمل الرسائل التفاعلات أو النصوص أو البطاقات في تطبيق Chat، بينما تشمل المساحات غرف المحادثة والرسائل المباشرة.

يوضّح المخطّط البياني السابق الأنواع المختلفة من التفاعلات والسياقات المتوفّرة للرسائل والمساحات:

تتبع الرسائل بين Google Chat وتطبيق Chat تنسيق رسالة محدّدًا، حيث تتألف كل رسالة من عنصر JSON تحدّد مكوّناته رقم تعريف المستخدم والأسلوب والمحتوى والجوانب الأخرى للرسالة. يمكن لتطبيقات المحادثة إرسال الأنواع التالية من الرسائل:
- الرسائل النصية: تحتوي على محتوى نصي عادي مع تنسيق نصي محدود.
- تحدِّد رسائل البطاقات تنسيق البطاقات ومحتوى وسلوك البطاقات التي سيتم عرضها في مساحة. على سبيل المثال، يمكن أن تتضمّن رسالة البطاقة زرًا يحتوي على رابط يفتح مربّع حوار لجمع معلومات من المستخدم.
  
  استخدِم "أداة إنشاء البطاقات" لتصميم واجهتَي المستخدم والرسائل ومعاينتهما في تطبيقات Chat:
  افتح "أداة إنشاء البطاقات".
في Google Chat، يمكن أن تتضمّن المساحات السياقات التالية:
- تظهر المساحة المُسمّاة أو المجموعة لمستخدمين متعدّدين.
- لا تظهر الرسالة المباشرة إلا للمستخدم في تلك المساحة.

حالات الاستخدام

من خلال إضافة تطبيقات Chat إلى منصة محادثات مثل Chat، يمكن للمستخدمين طرح الأسئلة وإصدار الأوامر بدون تغيير السياق. في الخلفية، يمكن لتطبيق Chat الوصول إلى أنظمة أخرى، ما يجعله وسيطًا بين هذه الأنظمة.

إنّ هذه الإمكانية التي توفّر الوصول إلى مجموعة واسعة من المراجع والأدوات، مع الحفاظ على تجربة معرفية موحّدة، يمكن أن تقدّم إطار عمل للعديد من أنواع التطبيقات، بما في ذلك ما يلي:

إدارة سير العمل
الإعداد والضبط
إنشاء الطلبات
بحث
جمع البيانات

في ما يلي بعض الأمثلة على الإجراءات التي يمكنك أن تطلب من تطبيق Chat تنفيذها من داخل مساحة Chat:

البحث عن المعلومات: يمكن لتطبيق Chat استرجاع المعلومات استنادًا إلى طلبات بحث منظَّمة أو نصية حرة يدخلها المستخدم.
إرسال طلبات الدعم: يمكن لتطبيق Chat إنشاء تقارير عن المشاكل أو عناصر أخرى باستخدام المعلومات التي يقدّمها المستخدم.
تنسيق الجهود: يمكن أن يحسِّن تطبيق Chat من طريقة تعامل أعضاء الفريق مع بعضهم البعض، مثل توفير "ذاكرة الفريق" أو جدولة الموارد.

إنشاء تطبيقات Chat

يوضّح هذا القسم بعض أنواع تطبيقات Chat التي يمكنك إنشاؤها.

لكل تطبيق Chat تنشئه، عليك إنشاء مشروع منفصل على Google Cloud في Google Cloud Console. لنشر تطبيق Chat ومشاركته مع مستخدمي Google Chat الآخرين، عليك نشره وعرضه على Google Workspace Marketplace. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة إنشاء عمليات النشر وإدارتها لتطبيق Chat.

تطبيقات Chat التفاعلية

تتيح العديد من تطبيقات Chat للمستخدمين إرسال الرسائل والتفاعل مع تطبيق Chat مباشرةً. يمكن لتطبيقات Chat التفاعلية تنفيذ أيٍّ مما يلي:

يمكنك الردّ على الإشارات باستخدام@ أو الطلبات التي تبدأ بشريط الشرطة المائلة أو الرسائل المباشرة باستخدام رسالة نصية أو رسالة بطاقة.
افتح مربّع حوار ل help users complete multi-step processes, like filling in form data.
معاينة الروابط من خلال إرفاق بطاقات تتضمّن معلومات مفيدة تتيح للمستخدمين اتّخاذ إجراء مباشرةً من المحادثة

للتفاعل مع المستخدمين، يجب أن يكون تطبيق Chat قادرًا على تلقّي أحداث التفاعل والردّ عليها. لإنشاء تطبيق Chat تفاعلي، اطّلِع على مقالة تلقّي أحداث التفاعل في تطبيق Google Chat والردّ عليها.

تطبيقات Chat غير التفاعلية

يمكن أن تكون تطبيقات Google Chat أيضًا غير تفاعلية للمستخدمين، حيث لا يمكنهم التفاعل مباشرةً مع تطبيق Chat، ولكن يُطلِق تطبيق Chat واجهة برمجة تطبيقات Google Chat مباشرةً. على سبيل المثال، يمكنك إنشاء تطبيق Chat يُرسِل رسالة في مساحة، ولكن لا يمكن للمستخدمين الردّ على تطبيق Chat. يكون هذا النوع من بنية تطبيق Chat مفيدًا لأشياء مثل الإبلاغ عن التنبيهات. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على Google Chat API.

تطبيقات Chat المستندة إلى الأحداث

يمكن لتطبيق Chat الاشتراك في أحداث تتعلّق بمواد Chat باستخدام Google Workspace Events API. يتيح الاشتراك لتطبيق Chat تلقّي معلومات عن الأحداث، التي تمثّل تغييرات في مورد Google Workspace المشترَك فيه. على سبيل المثال، يمكن لتطبيق Chat الاستجابة للتغييرات في مساحة اشترك فيها تطبيق Chat، مثل إرسال رسالة ترحيب إلى الأعضاء الجدد الذين تمت إضافتهم إلى المساحة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الاشتراك في أحداث Google Chat.

اختيار بنية تطبيق Chat

توفّر Chat API عددًا من الطرق التي يمكنك من خلالها دمج تطبيقاتك في مساحات Chat، ولكنها لا تقدّم أو تحدّد أي طريقة معيّنة لتنفيذ منطق تطبيق Chat. يمكنك إنشاء تطبيق Chat يستند إلى الأوامر أو استخدام أي نوع من خدمات معالجة اللغة ووحدات الذكاء الاصطناعي التي تعجبك، ويمكنك إجراء ذلك على مجموعة متنوعة من المنصات، بما في ذلك ما يلي:

AppSheet
لغة برمجة تطبيقات Google
Dialogflow
نشر/اشتراك
Google Cloud أو خادم HTTP على الموقع

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة اختيار بنية تطبيقات Chat.

وصول التطبيق إلى بيانات المستخدم

عند استدعاء تطبيق Chat، يجب أن يعرف التطبيق من هو المُستدعي وسياق الاستدعاء وكيفية مخاطبة المستدعي. للوصول إلى بيانات تتعدى بيانات الهوية الأساسية هذه، يجب منح تطبيق Chat إذن الوصول من خلال المصادقة.

بشكلٍ تلقائي، لا يمكن لتطبيقات Chat قراءة سوى الهوية الأساسية للمستخدمين الذين يستدعونها أو للمستخدمين الذين تتم الإشارة إليهم باستخدام علامة @ في الرسالة نفسها التي تستدعي التطبيق. وتشمل هذه المعلومات الاسم المعروض للمستخدم ورقم تعريفه وعنوان بريده الإلكتروني وصورته الرمزية.
بالنسبة إلى تطبيقات Chat التي تُعاين الروابط، يمكن لتطبيق Chat قراءة عناوين URL المُضافة إلى الرسالة والتي تتطابق مع أنماط عناوين URL التي تم ضبطها في تطبيق Chat.
إذا كان تطبيق Chat يحتاج إلى الوصول إلى بيانات أخرى لتوفير ميزات محسّنة للمستخدمين، مثل قراءة كل الرسائل أو قائمة الأعضاء في مساحة، عليك إعداد المصادقة ليتمكّن من الوصول إلى هذه البيانات. في حال الوصول إلى بيانات المستخدم، يطلب تطبيق Chat من المستخدم طلب الوصول، وعلى المستخدم منحه. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ربط تطبيق Chat بخدمات وأدوات أخرى.