إرسال رسائل Google Chat

بخلاف ذلك، يمكن لتطبيقات Chat إرسال الرسائل بشكل استباقي من خلال الاتصال بواجهة برمجة تطبيقات Google Chat.

للردّ من خلال رسالة، أعِد الإجراء DataActions مع عنصر CreateMessageAction:

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": MESSAGE
}}}

استبدِل MESSAGE بمورد Message من Chat API. لمزيد من المعلومات حول آلية عمل الإجراءات، يُرجى الاطّلاع على مقالة إجراءات Chat.

في المثال التالي، ينشئ تطبيق Chat رسالة نصية ويرسلها عند إضافته إلى مساحة. لإرسال رسالة نصية عندما يُضيف أحد المستخدمين تطبيق Chat إلى مساحة، يستجيب تطبيق Chat للعامل المشغِّل تمّت الإضافة إلى مساحة من خلال عرض الإجراء DataActions:

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The request object from Google Workspace Add-on.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 *                     introduces the app and helps people get started with it.
 */
exports.cymbalApp = function cymbalApp(req, res) {
  const chatEvent = req.body.chat;
  // Send an onboarding message when added to a Chat space
  if (chatEvent.addedToSpacePayload) {
    res.json({ hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
      text: 'Hi, Cymbal at your service. I help you manage your calendar' +
            'from Google Chat. Take a look at your schedule today by typing' +
            '`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn' +
            'what else I can do, type `/help`.'
    }}}}});
  }
};

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 *                  introduces the app and helps people get started with it.
 */
function onAddedToSpace(event) {
  return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
    text: 'Hi, Cymbal at your service. I help you manage your calendar' +
          'from Google Chat. Take a look at your schedule today by typing' +
          '`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn' +
          'what else I can do, type `/help`.'
  }}}}};
}

تعرِض نموذج التعليمات البرمجية الرسالة النصية التالية:

للحصول على أمثلة إضافية حول كيفية الردّ من خلال رسالة، اطّلِع على المراجع التالية:

• الردّ على الأوامر التي تبدأ بشرطة مائلة
• فتح مربّعات حوار تفاعلية
• جمع المعلومات من مستخدمي Google Chat

تعديل رسالة

يمكن لتطبيقات المحادثة أيضًا تعديل الرسائل التي ترسلها. على سبيل المثال، لتعديل رسالة بعد أن يرسل المستخدم مربّع حوار أو ينقر على زر في رسالة.

لتعديل رسالة في تطبيق Chat، استبدِل الإجراء DataActions برمز UpdateMessageAction، كما هو موضّح في المثال التالي:

{ "hostAppDataAction": { "chatDataAction": { "updateMessageAction": {
  "message": MESSAGE
}}}}

استبدِل MESSAGE بمورد Message من Chat API.

لمزيد من المعلومات حول آلية عمل الإجراءات، يُرجى الاطّلاع على مقالة إجراءات Chat.

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

الردّ على التفاعلات أو إرسال رسائل استباقية باستخدام Google Chat API

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

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

لإرسال رسالة باستخدام Chat API، عليك إعداد المصادقة واستخدام طريقة create() في مورد Message. لمعرفة الخطوات، يُرجى الاطّلاع على مقالة إرسال رسالة باستخدام Google Chat API.

مواضيع ذات صلة

• إنشاء واجهات Google Chat
• الردّ على الأوامر التي تبدأ بشرطة مائلة
• فتح مربّعات حوار تفاعلية
• جمع المعلومات من مستخدمي Google Chat
• معاينة الروابط في رسائل Google Chat
• إرسال رسالة باستخدام Google Chat API