لمنع تبديل السياق عندما يشارك المستخدمون رابطًا في Google Chat، يمكن لتطبيق Chat معاينة الرابط من خلال إرفاق بطاقة برسالتهم لتقديم المزيد من المعلومات والسماح للمستخدمين باتخاذ إجراءات من Google Chat مباشرةً.
على سبيل المثال، تخيَّل مساحة في Google Chat تتضمن جميع موظّفي خدمة العملاء في الشركة، بالإضافة إلى تطبيق Chat المسمى Case-y. يشارك موظّفو الدعم بشكل متكرر روابط تؤدي إلى طلبات خدمة العملاء في "مساحة Chat"، وفي كل مرة يجرون فيها هذه العملية، على زملائهم فتح رابط الطلب للاطّلاع على تفاصيل، مثل المُسنَد إليه والحالة والموضوع. وبالمثل، إذا أراد أحد الأشخاص الحصول على ملكية إحدى الطلبات أو تغيير حالتها، فعليه فتح الرابط.
تتيح معاينة الروابط لتطبيق Chat، Case-y، المتوفّر في المساحة، إرفاق بطاقة توضّح المسؤول عن الإسناد والحالة والموضوع عندما يشارك أحد المستخدمين رابط طلب. من خلال الأزرار الموجودة على البطاقة، يمكن لموظّفي الدعم الاستحواذ على ملكية الطلب وتغيير الحالة مباشرةً من بث المحادثة.
آلية عمل معاينة الروابط
عندما يضيف مستخدم رابطًا إلى رسالته، تظهر شريحة تتيح له معرفة أنّ تطبيق Chat قد يعاين الرابط.
بعد إرسال الرسالة، يتم إرسال الرابط إلى تطبيق Chat الذي ينشئ البطاقة في رسالة المستخدم ويرفقها.
إلى جانب الرابط، توفر البطاقة معلومات إضافية حول الرابط، بما في ذلك العناصر التفاعلية مثل الأزرار. يمكن لتطبيق Chat تعديل البطاقة المرفقة استجابةً لتفاعلات المستخدمين، مثل النقرات على الأزرار.
إذا كان المستخدم لا يريد أن يعاين تطبيق Chat الرابط من خلال إرفاق بطاقة برسالته، يمكنه منع المعاينة من خلال النقر على
في شريحة المعاينة. يمكن للمستخدمين إزالة البطاقة المرفقة في أي وقت بالنقر على إزالة المعاينة.إعداد معاينات الروابط
يمكنك تسجيل روابط محدّدة، مثل example.com
وsupport.example.com
وsupport.example.com/cases/
، كأنماط عناوين URL على صفحة ضبط تطبيق Chat في Google Cloud Console لكي يتمكّن تطبيق Chat من معاينتها.
- افتح Google Cloud Console.
- بجانب Google Cloud، انقر على السهم المتّجه للأسفل وافتح مشروع تطبيق Chat.
- في حقل البحث، اكتب
Google Chat API
وانقر على Google Chat API. - انقر على إدارة > الضبط.
- ضمن "معاينات الروابط"، أضِف نمط عنوان URL أو عدِّله.
- لضبط معاينات الروابط لنمط عنوان URL جديد، انقر على إضافة نمط عنوان URL.
- لتعديل إعدادات نمط عنوان URL حالي، انقر على السهم المتّجه للأسفل .
في حقل نمط المضيف، أدخِل نطاق نمط عنوان URL. سيعاين تطبيق Chat الروابط المؤدية إلى هذا النطاق.
للحصول على روابط معاينة التطبيق على Chat لنطاق فرعي محدّد، مثل
subdomain.example.com
، يجب تضمين النطاق الفرعي.للحصول على روابط معاينة تطبيق Chat للنطاق بأكمله، حدِّد حرف بدل مع علامة النجمة (*) كنطاق فرعي. على سبيل المثال، تتطابق السمة
*.example.com
معsubdomain.example.com
وany.number.of.subdomains.example.com
.في حقل بادئة المسار، أدخِل مسارًا لإلحاقه بنطاق نمط المضيف.
لمطابقة جميع عناوين URL في نطاق نمط المضيف، اترك بادئة المسار فارغة.
مثلاً، إذا كان نمط المضيف هو
support.example.com
، أدخِلcases/
لمطابقة عناوين URL للتجارب المستضافة فيsupport.example.com/cases/
.انقر على تم.
انقر على حفظ.
والآن، عندما يضيف مستخدم رابطًا يتطابق مع نمط عنوان URL لمعاينة رابط مع رسالة في "مساحة Chat" تتضمّن تطبيق Chat، يعاين تطبيقك الرابط.
معاينة رابط
بعد ضبط معاينة الرابط لرابط معيّن، يمكن لتطبيق Chat التعرّف على الرابط ومعاينته من خلال إرفاق المزيد من المعلومات إليه.
داخل مساحات Chat التي تتضمّن تطبيق Chat، عندما تحتوي رسالة أحد المستخدمين على رابط
يتطابق مع نمط عنوان URL لمعاينة الرابط، يتلقّى تطبيق Chat
حدث تفاعل MESSAGE
. تحتوي حمولة بيانات JSON
لحدث التفاعل على الحقل matchedUrl
:
JSON
"message": {
. . . // other message attributes redacted
"matchedUrl": {
"url": "https://support.example.com/cases/case123"
},
. . . // other message attributes redacted
}
من خلال التحقّق من توفُّر الحقل matchedUrl
في حمولة الحدث MESSAGE
، يمكن لتطبيق Chat إضافة معلومات إلى الرسالة باستخدام الرابط الذي تمت معاينته. ويمكن لتطبيق Chat إما الرد برسالة نصية بسيطة أو إرفاق بطاقة.
الرد برسالة نصية
للحصول على ردود بسيطة، يمكن لتطبيق Chat معاينة رابط عن طريق الرد باستخدام رسالة نصية بسيطة على رابط. هذا المثال يرفق رسالة تكرر عنوان URL للرابط الذي يتطابق مع نمط عنوان URL لمعاينة الرابط.
Node.js
برمجة تطبيقات
إرفاق بطاقة
لإرفاق بطاقة برابط تمت معاينته،
يُرجى عرض
ActionResponse
من النوع UPDATE_USER_MESSAGE_CARDS
. هذا المثال يرفق بطاقة بسيطة.
Node.js
برمجة تطبيقات
في هذا المثال، يتم إرسال رسالة بطاقة من خلال عرض البطاقة JSON. يمكنك أيضًا استخدام خدمة بطاقة "برمجة تطبيقات Google".
تعديل بطاقة
لتعديل البطاقة المرفقة برابط تمّت معاينته، يجب عرض ActionResponse
من النوع UPDATE_USER_MESSAGE_CARDS
. يمكن لتطبيقات Chat تعديل البطاقات التي تعاين الروابط فقط كردّ على حدث تفاعل مع تطبيق Chat.
لا يمكن لتطبيقات Chat تحديث هذه البطاقات من خلال إرسال طلب إلى Chat API
بشكل غير متزامن.
لا تتيح معاينة الرابط عرض ActionResponse
من النوع UPDATE_MESSAGE
. بما أنّ تطبيق "UPDATE_MESSAGE
" يعدّل الرسالة بالكامل بدلاً من البطاقة فقط، لا يعمل إلا إذا كان تطبيق Chat قد أنشأ الرسالة الأصلية. تؤدي ميزة "معاينة الرابط" إلى إرفاق بطاقة برسالة أنشأها المستخدم، لذلك لا يملك تطبيق Chat الإذن بتعديلها.
لضمان تعديل إحدى الوظائف لكل من البطاقات التي أنشأها المستخدمون أو التي أنشأها التطبيق في ساحة مشاركات Chat، يمكنك ضبط ActionResponse
ديناميكيًا استنادًا إلى ما إذا كان التطبيق في Chat أو المستخدم هو من أنشأ الرسالة.
- إذا أنشأ مستخدم الرسالة، اضبط
ActionResponse
علىUPDATE_USER_MESSAGE_CARDS
. - إذا أنشأ تطبيق في Chat الرسالة، اضبط
ActionResponse
علىUPDATE_MESSAGE
.
تتوفّر طريقتان لتنفيذ ذلك: تحديد actionMethodName
مخصَّصة والتحقّق منها كجزء من السمة onclick
في البطاقة المرفقة (التي تحدِّد الرسالة على أنّها من إنشاء المستخدم) أو التأكّد مما إذا كانت الرسالة من إنشاء المستخدم أم لا.
الخيار 1: البحث عن actionMethodName
لاستخدام actionMethodName
للتعامل بشكلٍ سليم مع أحداث تفاعل CARD_CLICKED
على البطاقات التي تمت معاينتها، يمكنك ضبط سمة actionMethodName
مخصّصة كجزء من السمة onclick
للبطاقة المرفقة:
JSON
. . . // Preview card details
{
"textButton": {
"text": "ASSIGN TO ME",
"onClick": {
// actionMethodName identifies the button to help determine the
// appropriate ActionResponse.
"action": {
"actionMethodName": "assign",
}
}
}
}
. . . // Preview card details
من خلال تحديد "actionMethodName": "assign"
للزر كجزء من معاينة الرابط، يمكن عرض ActionResponse
الصحيح ديناميكيًا من خلال البحث عن actionMethodName
مطابق:
Node.js
برمجة تطبيقات
في هذا المثال، يتم إرسال رسالة بطاقة من خلال عرض البطاقة JSON. يمكنك أيضًا استخدام خدمة بطاقة "برمجة تطبيقات Google".
الخيار 2: التحقُّق من نوع المُرسِل
تحقَّق لمعرفة ما إذا كان message.sender.type
HUMAN
أو BOT
. إذا كانت السمة HUMAN
، يجب ضبط ActionResponse
على UPDATE_USER_MESSAGE_CARDS
، أو ضبط ActionResponse
على UPDATE_MESSAGE
. يُرجى اتّباع الخطوات التالية:
Node.js
برمجة تطبيقات
في هذا المثال، يتم إرسال رسالة بطاقة من خلال عرض البطاقة JSON. يمكنك أيضًا استخدام خدمة بطاقة "برمجة تطبيقات Google".
يكون السبب المعتاد لتعديل البطاقة هو الاستجابة للنقر على زر. تذكَّر الزر تعيين إليّ من القسم السابق، إرفاق بطاقة. يؤدّي المثال الكامل التالي إلى تعديل البطاقة بحيث تشير إلى أنّه قد تمّ تخصيصها لـ "أنت" بعد أن ينقر المستخدِم على تعيين لي. يعمل المثال على ضبط ActionResponse
ديناميكيًا من خلال التحقّق من نوع المُرسِل.
مثال كامل: حالة تطبيق Chat لخدمة العملاء
في ما يلي الرمز الكامل لتطبيق Case-y في Chat الذي يعاين روابط إلى الطلبات التي تمت مشاركتها في مساحة Chat يتعاون فيها موظّفو خدمة العملاء.
Node.js
برمجة تطبيقات
في هذا المثال، يتم إرسال رسالة بطاقة من خلال عرض البطاقة JSON. يمكنك أيضًا استخدام خدمة بطاقة "برمجة تطبيقات Google".
الحدود والاعتبارات
أثناء ضبط معاينات الروابط لتطبيق Chat، يُرجى مراعاة الحدود والاعتبارات التالية:
- يتيح كل تطبيق في Chat معاينات الروابط لما يصل إلى 5 أنماط لعناوين URL.
- تعاين التطبيقات في Chat رابطًا واحدًا لكل رسالة. في حال توفُّر عدة روابط قابلة للمعاينة في رسالة واحدة، تتم معاينة الرابط الأول فقط القابل للمعاينة.
- لا تعاين تطبيقات Chat سوى الروابط التي تبدأ بالبادئة
https://
، وبالتالي لا تتم معايناتhttps://support.example.com/cases/
، إلا أنّsupport.example.com/cases/
لا تفعل ذلك. - يتم إرسال عنوان URL للرابط فقط إلى تطبيق Chat من خلال معاينات الروابط، ما لم تتضمّن الرسالة معلومات أخرى يتم إرسالها إلى تطبيق Chat، مثل الأمر الشرطة المائلة.
- يمكن استخدام
ActionResponse
من النوعUPDATE_USER_MESSAGE_CARDS
فقط في البطاقات المرفقة بالروابط التي تمت معاينتها، وذلك استجابةً لحدث تفاعل مع تطبيق على Chat فقط. لا تتيح معاينات الروابط استخدامUPDATE_MESSAGE
أو الطلبات غير المتزامنة لتعديل البطاقات المرفقة برابط تمت معاينته من خلال Chat API. لمزيد من المعلومات، يمكنك الاطّلاع على تعديل بطاقة.
تصحيح أخطاء معاينات الروابط
أثناء تنفيذ معاينات الروابط، قد تحتاج إلى تصحيح الأخطاء في تطبيق Chat من خلال قراءة سجلّات التطبيق. لقراءة السجلات، انتقِل إلى مستكشف السجلات على وحدة تحكُّم Google Cloud.