توضّح هذه الصفحة كيفية إعداد الأوامر والردّ عليها كتطبيق Google Chat.
تساعد الأوامر المستخدمين في استكشاف الميزات الرئيسية لتطبيق Chat واستخدامها، ويمكن لتطبيقات Chat فقط الاطّلاع على محتوى الأمر. على سبيل المثال، إذا أرسل مستخدم رسالة تتضمّن أمرًا يبدأ بشرطة مائلة، لن تظهر الرسالة إلا للمستخدم ولتطبيق Chat.
لتحديد ما إذا كان عليك إنشاء أوامر، وللتعرّف على كيفية تصميم تفاعلات المستخدمين، راجِع تحديد جميع رحلات المستخدمين.
أنواع أوامر تطبيق Chat
يمكنك إنشاء أوامر لتطبيق Chat على شكل أوامر تبدأ بشرطة مائلة أو أوامر سريعة. للاطّلاع على كل نوع من الأوامر واستخدامه، على المستخدمين اتّباع الخطوات التالية:-
الأوامر التي تبدأ بشرطة مائلة: يرسل المستخدمون الأوامر كرسائل عن طريق كتابة شرطة مائلة (
/
) ثم نص محدّد مسبقًا، مثل/about
. يمكن أن تطلب تطبيقات المحادثة أيضًا نص وسيط لأمر الشرطة المائلة. على سبيل المثال، قد يتطلّب الأمر/search
الذي يبدأ بشرطة مائلة نص وسيطة يُستخدَم في طلب بحث. -
الأوامر السريعة: يستخدم المستخدمون الأوامر من خلال فتح القائمة من قسم الرد في رسالة Chat. لاستخدام أحد الأوامر، ينقر المستخدم على إضافة
ثم يختار أمرًا من القائمة.
-
الشكل 1. يتعرّف المستخدمون على الأوامر التي تبدأ بشرطة مائلة ويستخدمونها من خلال كتابة شرطة مائلة /
في حقل الردّ متبوعة باسم الأمر. -
الشكل 2. يمكن للمستخدمين العثور على الأوامر السريعة واستخدامها من القائمة في قسم الرد على رسالة Chat.
المتطلبات الأساسية
Node.js
تطبيق Google Chat يتلقّى أحداث التفاعل ويردّ عليها. لإنشاء تطبيق تفاعلي على Chat باستخدام خدمة HTTP، أكمِل هذا الدليل السريع.
برمجة تطبيقات
تطبيق Google Chat يتلقّى أحداث التفاعل ويردّ عليها. لإنشاء تطبيق تفاعلي في Chat باستخدام "برمجة تطبيقات Google"، عليك إكمال هذا البدء السريع.
Python
تطبيق Google Chat يتلقّى أحداث التفاعل ويردّ عليها. لإنشاء تطبيق تفاعلي على Chat باستخدام خدمة HTTP، أكمِل هذا الدليل السريع.
Java
تطبيق Google Chat يتلقّى أحداث التفاعل ويردّ عليها. لإنشاء تطبيق تفاعلي على Chat باستخدام خدمة HTTP، أكمِل هذا الدليل السريع.
إعداد الأمر
يوضّح هذا القسم كيفية إكمال الخطوات التالية لإعداد الأمر:
- أنشئ اسمًا ووصفًا للأمر.
- ضبط الأمر في Google Cloud Console
تسمية الأمر ووصفه
اسم الأمر هو ما يكتبه المستخدمون أو يختارونه لتفعيل تطبيق Chat. يظهر أيضًا وصف موجز أسفل الاسم لتوجيه المستخدمين بشكل أكبر بشأن كيفية استخدام الأمر:

عند اختيار اسم ووصف للأمر، ضع في اعتبارك الاقتراحات التالية:
لتسمية أمر:
- استخدِم كلمات أو عبارات قصيرة وواضحة وقابلة للتنفيذ لجعل الأوامر واضحة للمستخدم. على سبيل المثال، بدلاً من الاسم
Create a reminder
، استخدِمRemind me
. - ننصحك باستخدام اسم فريد أو شائع للأمر. إذا كان الأمر يصف تفاعلاً أو ميزة نموذجية، يمكنك استخدام اسم شائع يعرفه المستخدمون ويتوقعونه، مثل
Settings
أوFeedback
. بخلاف ذلك، حاوِل استخدام أسماء أوامر فريدة، لأنّه إذا كان اسم الأمر هو نفسه في تطبيقات Chat الأخرى، على المستخدم فلترة الأوامر المشابهة للعثور على الأمر الخاص بك واستخدامه.
لوصف أمر:
- احرص على أن يكون الوصف قصيرًا وواضحًا ليعرف المستخدمون ما يمكن توقّعه عند استخدام الأمر.
- أخبِر المستخدمين إذا كانت هناك أي متطلبات تنسيق للأمر. على سبيل المثال، إذا أنشأت أمرًا يبدأ بشرطة مائلة ويتطلّب نص وسيطة، اضبط الوصف على شيء مثل
Remind me to do [something] at [time]
. - أخبِر المستخدمين ما إذا كان تطبيق Chat يرد على الجميع في المساحة أو بشكل خاص على المستخدم الذي يستدعي الأمر. على سبيل المثال، بالنسبة إلى الأمر السريع
About
، يمكنك وصفه على النحو التاليLearn about this app (Only visible to you)
.
ضبط الأمر في Google Cloud Console
لإنشاء أمر يبدأ بشرطة مائلة أو أمر سريع، عليك تحديد معلومات حول الأمر في إعدادات تطبيق Chat لواجهة Google Chat API.
لضبط أمر في Google Chat API، أكمِل الخطوات التالية:
في Google Cloud Console، انقر على"القائمة " > واجهات برمجة التطبيقات والخدمات > واجهات برمجة التطبيقات والخدمات المفعَّلة > Google Chat API.
انقر على الإعداد.
ضمن الأوامر، انقر على إضافة أمر.
أدخِل معرّف الأمر ووصفه ونوعه واسمه:
- رقم تعريف الأمر: هو رقم يتراوح بين 1 و1000 يستخدمه تطبيق Chat للتعرّف على الأمر وإرجاع ردّ.
- الوصف: النص الذي يصف وظيفة الأمر يمكن أن يصل طول الأوصاف إلى 50 حرفًا ويمكن أن تتضمّن أحرفًا خاصة.
- نوع الأمر: اختَر أمر سريع أو أمر الشرطة المائلة.
- حدِّد اسمًا للأمر السريع أو الأمر الذي يبدأ بشرطة مائلة:
- اسم الأمر السريع: هو الاسم المعروض الذي يختاره المستخدمون من القائمة لتنفيذ الأمر. يمكن أن يصل طوله إلى 50 حرفًا وأن يتضمّن أحرفًا خاصة. مثلاً:
Remind me
- اسم الأمر الذي يبدأ بشرطة مائلة: النص الذي يكتبه المستخدمون لتنفيذ الأمر في رسالة. يجب أن يبدأ بشرطة مائلة، وأن يحتوي على نص فقط،
ويمكن أن يصل إلى 50 حرفًا. مثلاً:
/remindMe
- اسم الأمر السريع: هو الاسم المعروض الذي يختاره المستخدمون من القائمة لتنفيذ الأمر. يمكن أن يصل طوله إلى 50 حرفًا وأن يتضمّن أحرفًا خاصة. مثلاً:
اختياري: إذا أردت أن يستجيب تطبيق Chat للطلب من خلال مربّع حوار، ضَع علامة في مربّع الاختيار فتح مربّع حوار.
انقر على حفظ.
تم الآن إعداد الأمر لتطبيق Chat.
الردّ على أمر
عندما يستخدم المستخدمون أمرًا، يتلقّى تطبيق Chat حدث تفاعل. تحتوي حمولة الحدث على بيانات وصفية تتضمّن تفاصيل حول الأمر الذي تم استدعاؤه (بما في ذلك معرّف الأمر ونوعه)، وذلك حتى تتمكّن من عرض ردّ مناسب.

/help
لتوضيح كيفية الحصول على الدعم.للاستجابة لكل نوع من أنواع الأوامر، يجب التعامل مع أنواع الأحداث المختلفة وكائنات البيانات الوصفية في حمولة الحدث:
نوع الأمر | نوع الحدث | البيانات الوصفية للأوامر |
---|---|---|
أمر يبدأ بشرطة مائلة | MESSAGE |
message.slashCommand
أو message.annotation.slashCommand |
أمر سريع | APP_COMMAND |
appCommandMetadata
|
للتعرّف على كيفية الردّ على طلب باستخدام رسالة، راجِع الأقسام التالية.
الردّ على أمر يبدأ بشرطة مائلة
يوضّح الرمز التالي مثالاً على تطبيق Chat يردّ على الأمر الشرطي /about
. يتعامل تطبيق Chat مع أحداث التفاعل MESSAGE
، ويرصد ما إذا كان حدث التفاعل يتضمّن معرّف الأمر المطابق، ويعرض رسالة خاصة:
Node.js
برمجة تطبيقات
Python
Java
استبدِل ABOUT_COMMAND_ID
بمعرّف الأمر الذي حدّدته عند إعداد الأمر في وحدة تحكّم Google Cloud.
الردّ على طلب سريع
يعرض الرمز التالي مثالاً على تطبيق Chat يردّ على الأمر السريع مساعدة. يتعامل تطبيق Chat مع أحداث التفاعل APP_COMMAND
، ويرصد ما إذا كان حدث التفاعل يتضمّن معرّف الأمر المطابق، ويعرض رسالة خاصة:
Node.js
برمجة تطبيقات
Python
Java
استبدِل HELP_COMMAND_ID
بمعرّف الأمر الذي حدّدته عند إعداد الأمر في وحدة تحكّم Google Cloud.
اختبار الأمر
لاختبار الأمر والرمز، يُرجى الاطّلاع على المقالة اختبار الميزات التفاعلية لتطبيقات Google Chat.
لمعرفة كيفية اختبار الأمر واستخدامه في واجهة مستخدم Chat، راجِع مقالة استخدام التطبيقات في Google Chat ضمن مستندات "مساعدة Google Chat".
مواضيع ذات صلة
- عرض أمثلة على تطبيقات Chat تستخدم الأوامر
- إرسال رسالة
- فتح مربّعات الحوار التفاعلية