الردّ على الطلبات السريعة في Google Chat

توضّح هذه الصفحة كيفية إعداد الأوامر السريعة والردّ عليها في تطبيق Google Chat.

الأمر السريع هو طريقة يمكن للمستخدمين من خلالها استدعاء تطبيق Chat والتفاعل معه. لاستخدام أمر سريع، افتح قائمة الدمج بالنقر على رمز "أدوات Google Workspace" في مساحة Chat أو محادثة، ثم اختَر أمر تطبيق يحمل اسمًا لا يبدأ بشرطة مائلة (/). من خلال اختيار أمر سريع، يتم استدعاء تطبيق Chat مباشرةً بدون إدخال معلومات إضافية من المستخدم، ما يتيح للمستخدم التفاعل بسرعة.

يمكن للمستخدمين أيضًا تشغيل تطبيق Chat من خلال أمر بدء بشرطة مائلة▾. مقارنةً بالأوامر التي تبدأ بشرطة مائلة، يتم تنسيق الأوامر السريعة باستخدام اسم أكثر ملاءمةً للمستخدم في واجهة مستخدم Chat، ويتم تنفيذها على الفور عند اختيارها، ولا تتطلّب من المستخدم تذكُّر اسم الأمر الذي يبدأ بشرطة مائلة أو كتابته.

الشكل 1: قائمة الدمج التي تحتوي على أوامر سريعة لتطبيق Chat

إعداد أمر سريع في Google Chat API

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

لضبط أمر سريع في Google Chat API، يُرجى اتّباع الخطوات التالية:

1. في وحدة تحكّم Google Cloud، انقر على رمز القائمة > واجهات برمجة التطبيقات والخدمات > واجهات برمجة التطبيقات والخدمات المفعَّلة > Google Chat API.

   الانتقال إلى صفحة Google Chat API

2. انقر على الإعداد.

3. ضمن الإعدادات المتقدّمة، انتقِل إلى العوامل المشغِّلة وتأكَّد من أنّ الحقل أمر التطبيق يحتوي على عامل تشغيل، مثل نقطة نهاية HTTP أو دالة في Apps Script. يجب استخدام هذا المشغِّل في القسم التالي للردّ على الأمر السريع.

4. ضمن الطلبات، انقر على إضافة طلب.

5. أدخِل رقم تعريف الأمر واسمه ووصفه ونوعه:

   • رقم تعريف الطلب: هو رقم يتراوح بين 1 و1000 يستخدمه تطبيق Chat للتعرّف على الطلب وvuelto تقديم ردّ.
   • الاسم: الاسم المعروض للطلب. يمكن أن يصل طول الأسماء إلى 50 حرفًا ويمكن أن تتضمّن رموزًا خاصة.
     • استخدِم كلمات أو عبارات قصيرة ووصفية وقابلة للتنفيذ لجعل الكلمات والتعليمات واضحة للمستخدم. على سبيل المثال، استخدِم تعديل جهة الاتصال ل أمر يعدّل سجلّ جهة اتصال.
   • الوصف: النص الذي يصف ما يفعله الأمر يمكن أن تتألف الأوصاف من 50 حرفًا كحد أقصى ويمكن أن تتضمّن أحرفًا خاصة.
     • يجب أن يكون الوصف قصيرًا وواضحًا حتى يعرف المستخدمون ما يمكنهم توقعه عند تنفيذ الأمر.
     • يمكنك إبلاغ المستخدمين بما إذا كان تطبيق Chat يردّ على الجميع في المساحة، أو بشكل خاص على المستخدم الذي يُجري الطلب. على سبيل المثال، بالنسبة إلى الأمر السريع لمحة، يمكنك وصفه على النحو التالي: التعرّف على هذا التطبيق (مرئي لك فقط).
   • نوع الطلب: اختَر طلب سريع.

6. اختياري: إذا كنت تريد أن يردّ تطبيق Chat على الطلب من خلال مربّع حوار، ضَع علامة في مربّع الاختيار فتح مربّع حوار.

7. انقر على حفظ.

تم الآن ضبط الطلب السريع لتطبيق Chat.

الردّ على أمر سريع

عندما يستخدِم المستخدمون أمرًا سريعًا، يتلقّى تطبيق Chat عنصر حدث يحتوي على معلومات عن الأمر السريع. يحتوي عنصر الحدث على بيانات أساسية AppCommand تتضمّن تفاصيل عن الأمر الذي تمّ استدعاؤه (بما في ذلك معرّف الأمر)، حتى تتمكّن من تقديم استجابة مناسبة.

للردّ على أمر سريع، عليك تنفيذ مشغِّل أمر التطبيق كي يتمكّن تطبيق Chat من معالجة أي عناصر حدث تحتوي على بيانات وصفية لأمر التطبيق.

يعرض الرمز البرمجي التالي مثالاً على تطبيق Chat الذي يردّ على الأمر Help. للردّ على الأوامر السريعة، يعالج تطبيق Chat عناصر الأحداث من عامل تشغيل أمر التطبيق. عندما تحتوي الحمولة لعنصر حدث على معرّف أمر سريع، يعرض تطبيق Chat الإجراء DataActions مع عنصر createMessageAction:

برمجة تطبيقات

// The ID of the slash command "/about".
// It's not enabled by default, set to the actual ID to enable it. You must
// use the same ID as set in the Google Chat API configuration.
const HELP_COMMAND_ID = 0;

/**
 * Responds to an APP_COMMAND event in Google Chat.
 *
 * @param {Object} event the event object from Google Chat
 */
function onAppCommand(event) {

    // Stores the Google Chat app command metadata as a variable.
    const appCommandMetadata = event.chat.appCommandPayload.appCommandMetadata;

    if (appCommandMetadata.appCommandType == "QUICK_COMMAND") {

        // Executes the quick command logic based on its ID.
        // Quick command IDs are set in the Google Chat API configuration.
        switch (appCommandMetadata.appCommandId) {
            case HELP_COMMAND_ID:
                return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
                    text: 'The Avatar app replies to Google Chat messages.'
                }}}}};
        }
    }
}

لاستخدام نموذج الرمز البرمجي هذا، استبدِل HELP_COMMAND_ID بمعرّف العبارة الذي حدّدته عند ضبط الأمر السريع في Chat API. لاختبار أمر سريع في Chat، افتح قائمة الدمج من خلال النقر على أدوات Google Workspace ثم اختيار الأمر السريع.