تشرح هذه الصفحة كيفية إعداد أوامر الشرطة المائلة والاستجابة لها في تطبيق Google Chat
تُعد أمر الشرطة المائلة طريقة شائعة يقوم بها المستخدمون باستدعاء وتفاعل مع تطبيق Chat تساعد الأوامر التي تبدأ بشرطة مائلة المستخدمين على اكتشاف استخدام الميزات الرئيسية لتطبيق Chat.
لاستخدام أمر شرطة مائلة، يكتب المستخدمون شرطة مائلة (/
)، ثم أمرًا نصيًا قصيرًا،
مثل "/about
" للحصول على معلومات عن تطبيق Chat.
يمكن للمستخدمين اكتشاف الأوامر التي تبدأ بشرطة مائلة عن طريق كتابة شرطة مائلة في
Google Chat، الذي يعرض نافذة تسرد الأوامر المتاحة
تطبيق Chat:
![نافذة أوامر تبدأ بشرطة مائلة](https://developers.google.cn/static/workspace/chat/images/slash-command-window.png?authuser=0000&hl=ar)
لتحديد ما إذا كان ينبغي لك إعداد الأوامر التي تبدأ بشرطة مائلة، وفهم كيفية تصميم تفاعلات المستخدم، انظر تحديد جميع رحلات المستخدم:
الأوامر التي تبدأ بشرطة مائلة مع الردود الخاصة
عندما يرسل المستخدم رسالة تحتوي على أمر شرطة مائلة، فإن الرسالة مرئية للمستخدم وتطبيق Chat. في حال حذف لقد ضبطت تطبيق Chat لتتم إضافته إلى المساحات مع عدة أشخاص، فقد تفكر في الاستجابة للأمر الذي يبدأ بالشرطة المائلة بشكل خاص، للحفاظ على خصوصية التفاعل بين المستخدم تطبيق Chat
على سبيل المثال، للتعرّف على تطبيق Chat الذي
الاكتشاف في مساحة، يمكن للمستخدمين استخدام أوامر مثل /about
أو /help
.
لتجنب إشعار أي شخص آخر في المساحة،
يمكن لتطبيق Chat الرد بخصوصية تامة باستخدام معلومات حول
كيفية استخدام تطبيق Chat والحصول على الدعم
المتطلبات الأساسية
Node.js
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat تفاعليًا باستخدام خدمة HTTP، أكمِل عملية البدء السريع هذه.
برمجة تطبيقات
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat التفاعلي في "برمجة تطبيقات Google"، أكمِل البدء السريع هذا.
Python
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat تفاعليًا باستخدام خدمة HTTP، أكمِل عملية البدء السريع هذه.
Java
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat تفاعليًا باستخدام خدمة HTTP، أكمِل عملية البدء السريع هذه.
إعداد أمر شرطة مائلة
يوضّح هذا القسم كيفية إكمال الخطوات التالية لإعداد الشرطة المائلة :
- أنشئ اسمًا للأمر الذي يبدأ بشرطة مائلة.
- ضبط الأمر الشرطة المائلة في Google Chat API
إدخال اسم للأمر الذي يبدأ بشرطة مائلة
يكون اسم الأمر slash هو ما يكتبه المستخدمون في رسالة Chat. لاستدعاء تطبيق Chat. يحتوي الوصف الموجز أيضًا أسفل الاسم، لمطالبة المستخدمين بالمزيد حول كيفية استخدام الأمر:
![اسم الأمر الذي يبدأ بشرطة مائلة ووصفها](https://developers.google.cn/static/workspace/chat/images/slash-command-description.png?authuser=0000&hl=ar)
عند اختيار اسم ووصف للأمر الذي يبدأ بشرطة مائلة، ضع في اعتبارك الاقتراحات التالية:
لتسمية الأمر الذي تبدأ بشرطة مائلة:
- استخدم كلمات أو عبارات قصيرة ووصفية وقابلة للتنفيذ لإنشاء
واضحة وبسيطة للمستخدم. على سبيل المثال، بدلاً من أن تقول
/createAReminder
، استخدِم/remindMe
. - إذا كان الأمر يحتوي على أكثر من كلمة، ساعِد المستخدمين على قراءة الأمر.
باستخدام الأحرف الصغيرة بالكامل في الكلمة الأولى ثم كتابة الكلمة الأولى بالحروف الكبيرة
حرف من الكلمات الإضافية. على سبيل المثال، بدلاً من
/updatecontact
، استخدام/updateContact
. - ضَع في اعتبارك ما إذا كنت تريد استخدام اسم فريد أو شائع للأمر. في حال حذف
يصف الأمر تفاعلاً أو ميزة نموذجية، يمكنك استخدام
الاسم الشائع الذي يعرفه المستخدمون ويتوقعونه، مثل
/settings
أو/feedback
بخلاف ذلك، حاول استخدام أسماء أوامر فريدة، لأنه إذا يكون اسم الأمر مماثلاً لتطبيقات Chat الأخرى، على المستخدم تصفية أوامر مماثلة للعثور على أوامرك واستخدامها.
- استخدم كلمات أو عبارات قصيرة ووصفية وقابلة للتنفيذ لإنشاء
واضحة وبسيطة للمستخدم. على سبيل المثال، بدلاً من أن تقول
لوصف أمر الشرطة المائلة:
- جعل الوصف قصيرًا وواضحًا حتى يعرف المستخدمون ما يمكنهم توقعه عند استدعاء الأمر.
- وعليك إعلام المستخدمين بما إذا كانت هناك أي متطلبات تنسيق للأمر.
على سبيل المثال، إذا أنشأت أمر
/remindMe
يتطلب وسيطة. نص، قم بتعيين الوصف إلى شيء مثلRemind me to do [something] at [time]
. - السماح للمستخدمين بمعرفة ما إذا كان تطبيق Chat يردّ على
كل شخص في المساحة أو بشكل خاص إلى المستخدم الذي يستدعي الأمر.
على سبيل المثال، بالنسبة للأمر الذي يبدأ بالشرطة المائلة
/about
، يمكنك وصفه على أنهLearn about this app (Only visible to you)
للرد بشكل خاص على الأمر الذي يبدأ بشرطة مائلة، يمكنك الاطّلاع على القسم الرد برسالة خاصة.
ضبط الأمر الشرطة المائلة في Google Chat API
لإنشاء أمر شرطة مائلة، تحتاج إلى تحديد معلومات حول الأمر في إعدادات تطبيق Chat لواجهة Google Chat API
لضبط أمر شرطة مائلة في واجهة Google Chat API، عليك إكمال الخطوات التالية: الخطوات:
في وحدة تحكُّم Google Cloud، انقر على "القائمة" > واجهات برمجة التطبيقات الخدمات > واجهات برمجة التطبيقات المفعّلة الخدمات > Google Chat API
انقر على الإعداد.
ضمن أوامر الشرطة المائلة، انقر على إضافة أمر شرطة مائلة.
أدخِل اسمًا ورقم تعريف للأمر ووصفًا للأمر:
- الاسم: الاسم المعروض للأمر وما يكتبه المستخدمون لاستدعاء تطبيقك. يجب أن يبدأ بشرطة مائلة، وأن يحتوي على نص فقط، ويمكن على ما يصل إلى 50 حرفًا.
- الوصف: النص الذي يصف طريقة الاستخدام والتنسيق الأمر. يمكن أن يصل طول الأوصاف إلى 50 حرفًا.
- مُعرّف الطلب: رقم من 1 إلى 1000 يمكن يستخدم تطبيق Chat للتعرّف على الأمر الشرطة المائلة. وإرجاع الرد.
اختياري: إذا أردت أن يردّ تطبيق Chat على الأمر باستخدام مربع حوار، فحدد مربّع الاختيار فتح مربّع حوار
انقر على حفظ.
تم الآن ضبط الأمر الشرطة المائلة لتطبيق Chat.
الاستجابة إلى أمر يبدأ بشرطة مائلة
عندما ينشئ المستخدمون رسالة Chat تحتوي على أمر شرطة مائلة،
يتلقّى تطبيقك على Chat حدث تفاعل واحد (MESSAGE
).
تحتوي حمولة الحدث على slashCommand
وslashCommandMetadata
الأخرى. تحتوي هذه العناصر على تفاصيل حول الأمر المستخدَم في الرسالة.
(بما في ذلك مُعرّف الأمر)، بحيث يمكنك عرض رد مناسب.
![رسالة خاصة إلى
تطبيق Cymbal Labs في Chat. تقول الرسالة أن
تم إنشاء تطبيق Chat بواسطة Cymbal Labs وهو يشارك رابطًا.
إلى الوثائق ورابط للتواصل مع فريق الدعم.](https://developers.google.cn/static/workspace/chat/images/private-message.png?authuser=0000&hl=ar)
/help
لشرح كيفية الحصول على الدعم.يعرض الرمز التالي مثالاً على تطبيق في Chat.
الذي يردّ على أمر الشرطة المائلة /about
من خلال المعالجة
MESSAGE
حدث تفاعل واكتشاف
ما إذا كانت الرسالة تحتوي على معرّف الأمر المطابق أم لا. إذا كانت الرسالة تحتوي على
رقم تعريف الأمر، سيعرض تطبيق Chat رسالة خاصة:
Node.js
برمجة تطبيقات
Python
Java
اضبط ABOUT_COMMAND_ID
باستخدام معرّف الأمر الذي
المحددة عندما
ضبط الأمر slash في واجهة برمجة تطبيقات Chat.
لاختبار هذا الرمز، يُرجى مراجعة
اختبار الميزات التفاعلية لتطبيقات Google Chat
مواضيع ذات صلة
- عرض نماذج تطبيقات Chat التي تستخدم أوامر تبدأ بشرطة مائلة
- إرسال رسالة
- إرسال رسائل خاصة
- فتح مربّعات الحوار التفاعلية