الردّ على الأوامر السريعة كتطبيق 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. ضمن الطلبات، انقر على إضافة طلب.

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

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

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

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

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

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

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

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

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

// Handle the APP_COMMAND event type.
function onAppCommand(event) {
  // Executes the command logic based on its ID.
  // Command IDs are set in the Google Chat API configuration.
  switch (event.appCommandMetadata.appCommandId) {
    case HELP_COMMAND_ID:
      return {
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      };
  }
}

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

تحويل الأوامر الحالية التي تبدأ بشرطة مائلة إلى أوامر سريعة

لتعديل أمر حالي يبدأ بشرطة مائلة إلى أمر سريع، عدِّل الأمر الذي يبدأ بشرطة مائلة في Google Chat API من خلال تغيير نوع الأمر من الأمر الذي يبدأ بشرطة مائلة إلى الأمر السريع.

عندما يُطلِق المستخدمون أمرًا سريعًا، يتلقّى تطبيق Chat حدث تفاعل APP_COMMAND، بدلاً من حدث تفاعل MESSAGE الذي يتم إرساله للأوامر التي تبدأ بشرطة مائلة. عدِّل تطبيق Chat للتعامل مع نوع حدث التفاعل هذا من خلال قراءة الحمولة الأساسية للحدث التي تحتوي على عنصر appCommandMetadata مع تفاصيل عن الأمر السريع الذي تمّ استدعاؤه. راجِع مقالة الردّ على أمر سريع.