أفضل ممارسات الإيقاف

يوفّر هذا الدليل رسائل المستخدمين ومسارات نقل البيانات الخاصة بـ "الإجراءات القائمة على المحادثة" التي سيتم إيقافها نهائيًا في 13 حزيران (يونيو) 2023. ويتناول المجالات التالية:

• مراحل الإيقاف: آلية عمل "المهام" في الوقت الحالي وبعد إيقافها نهائيًا.
• المراسلة المقترَحة: إشعارات مقترَحة لإضافتها إلى "الإجراءات"
• مسارات نقل البيانات المحتملة: خيارات الاحتفاظ بالمستخدمين بعد الإيقاف النهائي.

ملاحظة: هذه إرشادات عامة فقط. وبناءً على نوع "الإجراء المستند إلى المحادثة" واللغة، قد تكون هناك متطلبات قانونية محدّدة. يُرجى تأكيد المتطلبات القانونية الخاصة بك.

مشاركات المدونة الاستباقية (اختياري)

تختلف كل مهمة ووكالة ونشاط تجاري عن بعضها. بالإضافة إلى تعديل الإجراءات باستخدام الرسائل المقترَحة في هذا الدليل، ننصحك بنشر مشاركة مدونة تردّ بشكل استباقي على مخاوف المستخدمين الشائعة التالية:

• ما الذي يحدث؟
• متى ستتغير تجربتي؟
• كيف يمكنني مواصلة تلقّي وظائف مشابهة؟

ننصح بتضمين خيارات مسار نقل البيانات مع أي إشعارات إيقاف. يمكن نشر مشاركتك عبر البريد الإلكتروني أو النشرة الإخبارية أو وسائل التواصل الاجتماعي.

مرحلتي الإيقاف

يوضّح الجدول التالي سلوك "الإجراءات القائمة على المحادثة" حاليًا، وكيف ستتغير بعد تاريخ الإيقاف النهائي، والتعديلات التي يمكنك إجراؤها لإعلام المستخدمين.

	قبل تاريخ الإيقاف النهائي (13 حزيران/يونيو 2023)	بعد الإيقاف
سلوك الإجراء	تجربة الإجراء الحالية	تم إيقاف استدعاء الإجراء.
تعديلات مقترَحة لمطوّري البرامج	إضافة إشعار الإيقاف النهائي إلى الإجراءات (الاقتراحات)	لا ينطبق
التعديلات المتعلقة بتجربة المستخدم من Google	عند الاستدعاء، قد تقدّم Google إشعارًا بتحويل النص إلى كلام (TTS) يفيد بأنّ الإجراء لن يكون متاحًا بعد تاريخ الإيقاف النهائي.	عند الاستدعاء، توفّر Google تقنية TTS تُعلم المستخدم بأنّ هذا الإجراء لم يعُد متاحًا.

إذا قرَّرت عدم إيقاف الإجراء بشكل استباقي قبل تاريخ الإيقاف النهائي، سيتلقّى المستخدمون الذين يستدعون الإجراء إشعارًا لتقنية "تحويل النص إلى كلام" من Google. لا يزال يتم تحديد الصياغة الدقيقة لهذا الإشعار، إلا أن الصياغة النهائية لهذا الإشعار لن تتضمن معلومات النقل إلى المستخدمين.

ملاحظة: إذا كان الإجراء الخاص بك يقدّم معاملات، يمكنك إرسال رسائل إضافية حول عناصر المعاملات، مثل الاشتراكات والحجوزات وردّ الأموال وخصم من الحساب والمزيد.

الرسائل المقترَحة

إنّ أفضل طريقة لإعلام المستخدمين بالإيقاف القادم هي إعلامهم عند استدعاء إجراءك. يمكنك أيضًا الاستفادة من هذه الفرصة في تعريفهم بمسارات نقل البيانات إلى وظائف مشابهة.

• الغرض من المراسلة: لإعلام المستخدمين بالتغيير القادم، وإبلاغهم بخيارات النقل المتاحة.

• الإطار الزمني للمراسلة: عليك البدء بإشعار المستخدمين قبل 30 يومًا على الأقل من الإيقاف النهائي (من 13 أيار (مايو) 2022 إلى 13 حزيران (يونيو) 2022).

معالجة طلبات الإيقاف النهائي

للإجابة على وجه التحديد عن أسئلة المستخدمين المتعلقة بالإيقاف النهائي، يمكنك إنشاء جمهور مخصّص عالمي حسب النية بالشراء جديد يستخدِم هذا اللفظ المقترَح:

• "نحن بصدد إيقاف Action Name في date. لمزيد من التفاصيل، يُرجى الاطّلاع على short link | migration path message".

ملاحظة: أضِف بطاقة أساسية إلى الغرض إذا أردت تضمين رابط يؤدي إلى مزيد من التفاصيل. اطّلِع على نموذج الرمز للبطاقة الأساسية. لا يمكن استخدام الروابط المؤدية إلى الويب على الشاشات الذكية.

لوحة الرسم التفاعلية

إذا كان الإجراء الخاص بك يستخدم لوحة رسم تفاعلية، يمكنك إضافة بانر إشعار إلى صفحة تحميل اللوحة التي تستخدم الصياغة التالية في النموذج:

• "سيتم إيقاف Action Name في date. يُرجى الانتقال إلى shortlink url للاطّلاع على التفاصيل.
• "سيتم إيقاف Action Name في date، migration path message."

المراسلات الاختيارية

هناك طرق إضافية يمكنك من خلالها تحديث الإجراءات الحالية لإشعار المستخدمين بالتغيير القادم. ننصحك بإدراج إشعارات الإيقاف النهائي في رسائل الإجراءات الحالية:

• "existing message. أيضًا، نريد تذكيرك بأنّ Action Name سيكون (سيتم الإيقاف | الإيقاف) على date".
• "existing message. أودّ أيضًا إعلامك بأنّ Action Name سيكون (سيتم الإيقاف | الإيقاف) على date، migration path".

يمكنك أيضًا إضافة إشعارات إلى أي ميزات خاصة قد يطبّقها الإجراء الخاص بك:

• استدعاءات روابط صفحات معيَّنة: يمكنك عرض بطاقة أساسية تتضمّن معلومات (نموذج).

• رسائل Last prompt: يمكنك إضافة رسالة last prompt (نموذج) إلى أيّ من أنواع الطلبات التالية:

  • الأغراض المضمّنة (BII). يسري هذا العرض على ميزات BII في ألعاب Play وسرد القصص وEducation.
  • اقتراحات سلاسل الإجراءات
  • رسائل الترحيب

• طلبات الخروج: يمكنك أيضًا إضافة رسالة last prompt خاصة (نموذج) للخروج من رسائل المطالبة (actions.intent.CANCEL).

• الإشعارات الفورية: يمكنك إضافة الصياغة المقترَحة التالية إلى أيّ إشعارات فورية تم إنشاؤها باستخدام "أداة إنشاء المهام" أو Dialogflow:

  • "تذكير، سيتم إيقاف Action Name في date. يُرجى الانتقال إلى shortlink url للاطّلاع على التفاصيل."
  • "تذكير، سيتم إيقاف Action Name في date، migration path message.

مسارات نقل البيانات المحتملة

على الرغم من أنه قد لا يتوفر مسار نقل مماثل من "الإجراء الحواري"، يمكنك تجربة الخيارات التالية بناءً على احتياجات المستخدم وموارد مطوّري البرامج المتاحة.

محتوى الوسائط

تتيح إجراءات الوسائط للمستخدمين اكتشاف المحتوى الخاص بك على "مساعد Google" وبدء تشغيل المحتوى مباشرةً على تطبيقك. ويمكنك مساعدة المستخدمين في الانتقال إلى إجراءات الوسائط باستخدام الأمثلة التالية على المراسلة:

• "يمكنك العثور علينا في أي وقت عند قول "Ok Google، أريد تشغيل Media Brand Name".
• "يمكنك العثور علينا في أي وقت عند قول "Ok Google، أريد الاستماع إلى "الأغنية" على Media Brand Name".

تختلف "إجراءات الوسائط" عن "المهام القائمة على المحادثة":

• من خلال "إجراءات الوسائط"، لا "يتفاعل" المستخدم مع الجهات الخارجية مباشرةً، ولكن من خلال "مساعد Google" إلى هذه الجهة.
• إنّ "إجراءات الوسائط" ليست حوارية، بل تدعم طلبات البحث "اللقطة الواحدة" فقط.

التطبيقات المتوافقة مع Android

الإجراءات في التطبيقات في "مساعد Google" هي ميزة في نظام التشغيل Android تتيح للمستخدمين تشغيل تطبيقات Android والتحكّم فيها باستخدام الصوت، وذلك باستخدام "مساعد Google". يمكنك إطلاع المستخدمين على الإجراءات التي يتخذها تطبيقك باستخدام نموذج المراسلة التالي:

• "يمكنك العثور علينا في أي وقت من خلال قول "Ok Google، افتح App Name".
• "يمكنك فتح تطبيق Android بقول "Ok Google، BII على App Name".
• "يمكنك تثبيت تطبيق Android من خلال قول "Ok Google، افتح App Name".

تعمل "المهام في التطبيقات" مع بعض الاختلافات عن "المهام القائمة على المحادثة":

• توفِّر BII إجراءات على مستوى التطبيقات دعمًا محدودًا باللغات واللغتَين.
• يجب توفُّر تطبيق Android لتفعيل إجراءات التطبيق.
• لا تتيح الشاشات الذكية استخدام "المهام في التطبيقات".
• يُرجى العِلم بأنّ "المهام في التطبيقات" ليست محادثات، بل تتيح طلبات البحث "اللقطة الواحدة" فقط.

أجهزة

تتيح المنزل الذكي من Google للمطوّرين تفعيل الأجهزة الصوتية باستخدام "مساعد Google". يمكنك إطلاع المستخدمين على إجراءات المنزل المزوّد بأجهزة ذكية باستخدام المثال التالي على الرسائل:

• "يمكنك التواصل معنا في أي وقت باستخدام "device name" المتاحة على الرابط store."
• "يمكنك التحدّث إلينا من خلال device name في تطبيق Google Home"

في ما يلي الاختلافات بين المنزل المزوّد بأجهزة ذكية و"الإجراءات القائمة على المحادثة":

• يمكن إضافة المنزل المزوّد بأجهزة ذكية إلى الأجهزة المتوافقة فقط.
• لا يعتمد المنزل المزوّد بأجهزة ذكية على إجراء محادثات، بل يتيح فقط استخدام طلبات البحث "اللقطة الأحادية".

وكلاء الدردشة

تتوفّر المنتجات التالية لإجراء الحوارات المتبادلة مع المستخدمين عبر برامج تتبُّع المحادثات:

• يوفّر Dialogflow CX نوع وكيل متقدمًا للوكلاء الكبير والمعقدة. وهي توفّر عمليات دمج مع بوابة هاتف Dialogflow CX وDialogflow Messenger وMessenger من Facebook وLINE والمزيد. راجِع قائمة الدمج الكاملة.
• يوفّر Dialogflow EX نوع وكيل عادي مناسبًا للوكلاء الأصغر حجمًا والأبسط. وهي توفر عمليات دمج مع Slack وTelegram وLINE وMessenger من Facebook وWorkspace من Meta وغيرها. راجِع قائمة الدمج الكاملة.

يمكنك تعريف المستخدمين بوكلاء المحادثة باستخدام الأمثلة التالية للرسائل:

• "للحصول على المساعدة في المستقبل، يُرجى الاتصال بـ support number".
• "للحصول على دعم في المستقبل، يُرجى زيارة موقعنا الإلكتروني على short link url".
• "للحصول على ملاحظات وآراء في المستقبل، يمكنك الدردشة معنا على قناة Slack Company Name".

تختلف بعض خدمات وكلاء المحادثة عن الإجراءات القائمة على المحادثة:

• لا يمكن استخدام موظّفي الدعم على الشاشات الذكية.
• لا يمكن دمج موظّفي الدعم مع "مساعد Google".

خدمة العملاء

يمكنك تلبية احتياجات العملاء بشكل أسرع باستخدام برامج تتبُّع المحادثات الصوتية وبرامج التتبُّع الصوتية ومكاتب المساعدة الهاتفية، وكلها مُدمَجة في عروض مركز جهات الاتصال، مثل Agent Assist وإحصاءات CCAI. يمكنك تعريف المستخدمين بخيارات خدمة العملاء باستخدام هذا المثال على المراسلة:

• للحصول على المساعدة في المستقبل، يُرجى الاتصال بـ support number".
• "للحصول على دعم في المستقبل، يُرجى زيارة موقعنا الإلكتروني على short link url".
• وللحصول على ملاحظات بشأنها في المستقبل، يمكنك الدردشة معنا على قناة Slack "اسم الشركة".

تقدم خيارات خدمة العملاء بعض الاختلافات عن "الإجراءات القائمة على المحادثة":

• الْإِعْدَادَاتْ مِشْ مُتَاحَة عَلَى الشَّاشَاتِ الذَّكِيَّة.
• لا يمكن دمجها مع "مساعد Google".

المواقع الإلكترونية

يمكنك توجيه المستخدمين إلى وظائف قد يوفّرها موقعك الإلكتروني. يمكنك تعريف المستخدمين بخيارات الويب المتاحة لك باستخدام نموذج المراسلة التالي:

• "للحصول على دعم في المستقبل، يُرجى زيارة موقعنا الإلكتروني على short link url".

تتضمن مواقع الويب الاختلافات التالية عن إجراءات المحادثة:

• لا يمكن استخدام المواقع الإلكترونية على الشاشات الذكية.
• لا يمكن دمج المواقع الإلكترونية مباشرةً مع "مساعد Google".

ملاحظة: يمكنك إنشاء "الإجراءات" تلقائيًا من ترميز محتوى الويب باستخدام الإجراءات من محتوى الويب.

عيّنات تعليمات برمجية

استخدِم نماذج الرموز هذه لإنشاء استجابات مرتبطة بالإيقاف النهائي لإجراءات المحادثة.

مثال على البطاقة الأساسية

YAML

candidates:
  - first_simple:
    variants:
    - speech: >-
      We are turning off  on . For more details check out 
    text: >-
      We are turning off  on . For more details check out 
    content:
      card:
        title: Turning Off 
        subtitle: 
        text: >-
          `We are turning off  on . For more details check out .`
        button:
          name: Learn more
          open:
            url: 
    

تنسيق JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "We are turning off  on . For details, check out .",
            "text": "We are turning off  on . For details, check out ."
          }
        ]
      },
      "content": {
        "card": {
          "title": "Turning Off ",
          "subtitle": "",
          "text": "`We are turning off  on . For details, check out .`",
          "button": {
            "name": "Learn more",
            "open": {
              "url": ""
            }
          }
        }
      }
    }
  ]
}
      

Node.js

app.handle('Card', conv => {
  conv.add('We are turning off  on . For details, check out .');
  conv.add(new Card({
    "title": "Turning Off ",
    "subtitle": "",
    "text": "Card Content",
    "button": new Link({
      name: 'Learn more',
      open: {
          url: '',
        },
    })
  }));
});
    

تنسيق JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "content": {
        "card": {
          "title": "Turning Off ",
          "subtitle": "",
          "text": "We are turning off  on . For, details check out .",
          "button": {
            "name": "Learn more",
            "open": {
              "url": ""
            }
          }
        }
      },
      "firstSimple": {
        "speech": "We are turning off  on . For details, check out .",
        "text": "We are turning off  on . For details, check out ."
      }
    }
  }
}
      

مثال على الطلب الأخير

YAML

candidates:
  - first_simple:
      variants:
        - speech: 
          text: 
    last_simple:
      variants:
        - speech: Also, just reminding you that  will be turning off on 
          text: Also, just reminding you that  will be turning off on 

تنسيق JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "",
            "text": ""
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "Also, just reminding you that  will be turning off on ",
            "text": "Also, just reminding you that  will be turning off on "
          }
        ]
      }
    }
  ]
}

Node.js

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: '',
    text: ''
  }));
  conv.add(new Simple({
    speech: 'Also, just reminding you that  will be turning off on ',
    text: 'Also, just reminding you that  will be turning off on '
  }));
});

تنسيق JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "",
        "text": ""
      },
      "lastSimple": {
        "speech": "Also, just reminding you that  will be turning off on ",
        "text": "Also, just reminding you that  will be turning off on "
      }
    }
  }
}

مثال على آخر طلب (خروج/إلغاء)

YAML

candidates:
  - first_simple:
      variants:
        - speech: 
          text: 
    last_simple:
      variants:
        - speech: Also, just reminding you that  will be turning off on . Bye.
          text: Also, just reminding you that  will be turning off on . Bye.

تنسيق JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "",
            "text": ""
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "Also, just reminding you that  will be turning off on . Bye.",
            "text": "Also, just reminding you that  will be turning off on . Bye."
          }
        ]
      }
    }
  ]
}

Node.js

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: '',
    text: ''
  }));
  conv.add(new Simple({
    speech: 'Also, just reminding you that  will be turning off on . Bye.',
    text: 'Also, just reminding you that  will be turning off on . Bye.'
  }));
});

تنسيق JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "",
        "text": ""
      },
      "lastSimple": {
        "speech": "Also, just reminding you that  will be turning off on . Bye.",
        "text": "Also, just reminding you that  will be turning off on . Bye."
      }
    }
  }
}

---