الإشعارات اليومية (Dialogflow)

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

في ما يلي تجربة المستخدم مع هذه التحديثات:

1. يستدعي المستخدم أحد أغراض الإجراء التي ضبطتها على أنّها تحديث يومي.
2. يتبع المستخدم مطالبة للاشتراك في التحديثات اليومية. هذا الطلب هو يتم تقديمه في منتصف المحادثة أو كشريحة اقتراح عند انتهاء المحادثة.
3. يجدول المستخدم وقتًا من اليوم يرغب في تلقيه يوميًا تحديث، يتم تسجيل التحديث باستخدام "مساعد Google".
4. يتلقّى المستخدم خدمة "مساعد Google" في الموعد المحدّد كل يوم. إشعار على أجهزتهم الجوّالة.
5. عندما يفتح المستخدِم هذا الإشعار، فإنّه يستدعي الغرض الذي كتحديث يومي والتفاعل مع الإجراء.

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

حالات الاستخدام

يمكن أن تكون التحديثات اليومية أداة مفيدة للتفاعل ولكن لا ينبغي مدمجة في كل إجراء. ننصحك باتّباع هذه النصائح عند تحديد ما إذا كنت تريد إضافة تحديث الاشتراكات يوميًا إلى إجراء:

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

إعداد المعلومات اليومية

لضبط أحد أغراض الإجراء للحصول على تعديلات يومية، يُرجى اتّباع الخطوات التالية: التعليمات:

1. إعداد هدف التحديث

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

لتحديد هدف تشغيل في Dialogflow، يُرجى اتّباع الخطوات التالية:

1. في وحدة تحكُّم Dialogflow، انقر على عمليات الدمج:
2. ضمن القسم مساعد Google، انقر على إعدادات الدمج.
3. ضمن الاكتشاف > استدعاء ضمني: انقر على إضافة هدف. وحدِّد الغرض من التحفيز إذا لم يسبق لك ذلك.
4. فعِّل تغييرات المعاينة التلقائية إذا لم يكن مُفعَّلاً.
5. انقر على إغلاق.

في حزمة SDK للإجراءات، حدّد الغرض من التحديث على أنه هدف تشغيل في حزمة الإجراءات.

2. تفعيل التحديثات

لتفعيل الإشعارات اليومية بغرض التفعيل، اتّبِع الخطوات التالية:

1. في وحدة تحكّم المهام، انتقل إلى تطوير > الإجراءات:
2. اختَر الهدف الذي تريد تفعيله. إذا لم يظهر هدفك في القائمة، تأكَّد من أنّه قد تم ضبطها على أنّها الغرض الرئيسي من تنفيذ هذا الإجراء، ومن أنّ مساعد Dialogflow تعيين الدمج على المعاينة التلقائية للتغييرات.
3. انتقِل للأسفل حتى تصل إلى قسم تفاعل المستخدمين وفعِّله. هل تريد عرض تحديثات يومية للمستخدمين؟
4. أدخِل عنوان المحتوى.
5. انقر على حفظ.

لقد ضبطت الآن الإجراء الخاص بك لتقديم اشتراكات تحديث يومية والنية. يمكنك الآن اختبار معلوماتك اليومية على جهازك الجوّال.

تخصيص تسجيل التحديث (اختياري)

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

للحصول على مثال كامل على إجراء يعالج ميزات تحديث يومية اختيارية، الاطّلاع على نماذج تفاعل المستخدمين في "المهام مع مساعد Google" (Node.js وJava).

لإضافة طلب تسجيل تعديل يومي مخصَّص إلى محادثتك، يُرجى اتّباع الخطوات التالية: هذه التعليمات:

1. إضافة طلب التسجيل

يمكنك إضافة مربّع حوار وشريحة اقتراح إلى المحادثة عندما تريد إرسال طلب بذلك. للمستخدمين للاشتراك في التحديثات اليومية. تقديم هذه الطلبات بعد تفاعل المستخدم بغرض التحديث، حتى يفهموا محتويات التحديثات.

يطالب رمز المثال التالي المستخدم بالاشتراك في التحديثات اليومية التي تقديم أدنى درجة حرارة متوقعة كل يوم:

app.intent('Daily Lowest Temperature', (conv, params) => {
  const today = DAYS[new Date().getDay()];
  const lowestTemperature = lowestTemperatures[today];
  conv.ask(`The lowest temperature for today is ${lowestTemperature}`);
  conv.ask('I can send you daily updates with the lowest temperature' +
    ' of the day. Would you like that?');
  conv.ask(new Suggestions('Send daily updates'));
});
index.js

@ForIntent("Daily Lowest Temperature")
public ActionResponse dailyLowestTemperature(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  Integer lowestTemperature =
      LOWEST_TEMPERATURES.get(LocalDate.now().getDayOfWeek());
  responseBuilder
      .add("The lowest temperature for today is " +  lowestTemperature + " degrees Fahrenheit.")
      .add("I can send you daily updates with the lowest temperature of " +
          "the day. Would you like that?")
      .addSuggestions(new String[] {
          "Send daily updates"
      });
  return responseBuilder.build();
}
UpdatesApp.java

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "The lowest temperature for today is 75 degrees Fahrenheit"
            }
          },
          {
            "simpleResponse": {
              "textToSpeech": "I can send you daily updates with the lowest temperature of the day. Would you like that?"
            }
          }
        ],
        "suggestions": [
          {
            "title": "Send daily updates"
          }
        ]
      }
    }
  }
}

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.TEXT"
        }
      ],
      "inputPrompt": {
        "richInitialPrompt": {
          "items": [
            {
              "simpleResponse": {
                "textToSpeech": "The lowest temperature for today is 75 degrees Fahrenheit"
              }
            },
            {
              "simpleResponse": {
                "textToSpeech": "I can send you daily updates with the lowest temperature of the day. Would you like that?"
              }
            }
          ],
          "suggestions": [
            {
              "title": "Send daily updates"
            }
          ]
        }
      }
    }
  ]
}

2. تسجيل تحديثات الاسم المعرِّف

إعداد هدف جديد يتم تفعيله عندما يتابع المستخدم تسجيلك مطالبة. عند تنفيذ هذا الغرض الجديد، فعِّل actions_intent_CONFIGURE_UPDATES. هدف مدمج مع المَعلمات التالية:

• intent: اضبط الغرض من التحديث الذي ضبطته.
• frequency: ضبط الخيار على يومي

يسجِّل الرمز التالي التعديلات اليومية على "أدنى درجة حرارة يومية" الغرض:

app.intent('Subscribe to Daily Updates', (conv) => {
  conv.ask(new RegisterUpdate({
    intent: 'Daily Lowest Temperature',
    frequency: 'DAILY',
  }));
});
index.js

conv.ask(new RegisterUpdate({
  intent: 'Daily Lowest Temperature',
  frequency: 'DAILY',
}));
index.js

@ForIntent("Subscribe to Daily Updates")
public ActionResponse subscribeToDailyUpdates(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  return responseBuilder.add(new RegisterUpdate()
      .setIntent("Daily Lowest Temperature")
      .setFrequency("DAILY"))
      .build();
}
UpdatesApp.java

ResponseBuilder responseBuilder = getResponseBuilder(request);
return responseBuilder.add(new RegisterUpdate()
    .setIntent("Daily Lowest Temperature")
    .setFrequency("DAILY"))
    .build();
UpdatesApp.java

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "systemIntent": {
        "intent": "actions.intent.REGISTER_UPDATE",
        "data": {
          "@type": "type.googleapis.com/google.actions.v2.RegisterUpdateValueSpec",
          "intent": "Daily Lowest Temperature",
          "triggerContext": {
            "timeContext": {
              "frequency": "DAILY"
            }
          }
        }
      }
    }
  }
}

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.REGISTER_UPDATE",
          "inputValueData": {
            "@type": "type.googleapis.com/google.actions.v2.RegisterUpdateValueSpec",
            "intent": "Daily Lowest Temperature",
            "triggerContext": {
              "timeContext": {
                "frequency": "DAILY"
              }
            }
          }
        }
      ]
    }
  ]
}

3- التعامل مع النتيجة

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

تختلف تعليمات هذه الخطوة بناءً على ما إذا كنت تستخدم Dialogflow أو حزمة SDK للإجراءات في عملية التطوير.

app.intent('Confirm Daily Updates Subscription', (conv, params, registered) => {
  if (registered && registered.status === 'OK') {
    conv.close(`Ok, I'll start giving you daily updates.`);
  } else {
    conv.close(`Ok, I won't give you daily updates.`);
  }
});
index.js

@ForIntent("Confirm Daily Updates Subscription")
public ActionResponse confirmDailyUpdatesSubscription(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  if (request.isUpdateRegistered()) {
    responseBuilder.add("Ok, I'll start giving you daily updates.");
  } else {
    responseBuilder.add("Ok, I won't give you daily updates.");
  }
  return responseBuilder.endConversation().build();
}
UpdatesApp.java

{
  "payload": {
    "google": {
      "expectUserResponse": false,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "Ok, I'll start giving you daily updates."
            }
          }
        ]
      }
    }
  }
}

app.intent('actions.intent.REGISTER_UPDATE', (conv, params, registered) => {
  if (registered && registered.status === 'OK') {
    conv.close(`Ok, I'll start giving you daily updates.`);
  } else {
    conv.close(`Ok, I won't give you daily updates.`);
  }
});
index.js

@ForIntent("actions.intent.REGISTER_UPDATE")
public ActionResponse confirmDailyUpdatesSubscription(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  if (request.isUpdateRegistered()) {
    responseBuilder.add("Ok, I'll start giving you daily updates.");
  } else {
    responseBuilder.add("Ok, I won't give you daily updates.");
  }
  return responseBuilder.endConversation().build();
}
UpdatesApp.java

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "simpleResponse": {
            "textToSpeech": "Ok, I'll start giving you daily updates."
          }
        }
      ]
    }
  }
}

تخصيص التحديثات (اختياري)

لتخصيص النية من عملية التحديث، أضِف مَعلمات مخصّصة عندما يُسجّل المستخدمون. وآخر الأخبار اليومية. عند تنفيذ الغرض من التحديث، يُرجى الإشارة إلى هذه المَعلمات. لتخصيص التحديث اليومي لهذا المستخدم.

تختلف تعليمات هذه الميزة بناءً على ما إذا كنت تستخدم Dialogflow أو حزمة SDK للإجراءات في عملية التطوير.

app.intent('setup_update', (conv) => {
  conv.ask(new RegisterUpdate({
    intent: 'update_of_the_day',
    arguments: [
      {
        name: 'category',
        textValue: 'Daily_lowest_temperature',
      },
    ],
    frequency: 'DAILY',
  }));
});

@ForIntent("setup_update")
public ActionResponse setupUpdate2(ActionRequest request) {
  List<Argument> args =
      Arrays.asList(
          new Argument()
              .setName("category")
              .setTextValue(request.getParameter("category").toString()));
  return getResponseBuilder(request)
      .add(new RegisterUpdate().setIntent("intent_name").setArguments(args).setFrequency("DAILY"))
      .build();
}

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "PLACEHOLDER"
            }
          }
        ]
      },
      "userStorage": "{\"data\":{}}",
      "systemIntent": {
        "intent": "actions.intent.REGISTER_UPDATE",
        "data": {
          "@type": "type.googleapis.com/google.actions.v2.RegisterUpdateValueSpec",
          "intent": "update_of_the_day",
          "arguments": [
            {
              "name": "category",
              "textValue": "Daily_lowest_temperature"
            }
          ],
          "triggerContext": {
            "timeContext": {
              "frequency": "DAILY"
            }
          }
        }
      }
    }
  },
  "outputContexts": [
    {
      "name": "/contexts/_actions_on_google",
      "lifespanCount": 99,
      "parameters": {
        "data": "{}"
      }
    }
  ]
}

app.intent('actions.intent.TEXT', (conv) => {
  if (conv.input.raw === 'Send daily') {
    conv.ask(new RegisterUpdate({
      intent: 'update_of_the_day',
      arguments: [
        {
          name: 'category',
          textValue: 'Daily_lowest_temperature',
        },
      ],
      frequency: 'DAILY',
    }));
  }
});

@ForIntent("actions.intent.CONFIGURE_UPDATES")
public ActionResponse configureUpdatesActionsSdk(ActionRequest request) {
  List<Argument> args =
      Arrays.asList(
          new Argument()
              .setName("category")
              .setTextValue(request.getParameter("category").toString()));
  return getResponseBuilder(request)
      .add(new RegisterUpdate().setIntent("intent_name").setArguments(args).setFrequency("DAILY"))
      .build();
}

@ForIntent("actions.intent.TEXT")
public ActionResponse text(ActionRequest request) {
  ResponseBuilder rb = getResponseBuilder(request);
  String input = request.getRawInput().getQuery();
  if (input.equals("DAILY_NOTIFICATION_SUGGESTION")) {
    rb.add("For which category do you want to receive daily updates?");
  } else {
    rb.add("Sorry, I didn't get that. Please try again later").endConversation();
  }
  return rb.build();
}

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "inputPrompt": {
        "richInitialPrompt": {
          "items": [
            {
              "simpleResponse": {
                "textToSpeech": "PLACEHOLDER"
              }
            }
          ]
        }
      },
      "possibleIntents": [
        {
          "intent": "actions.intent.REGISTER_UPDATE",
          "inputValueData": {
            "@type": "type.googleapis.com/google.actions.v2.RegisterUpdateValueSpec",
            "intent": "update_of_the_day",
            "arguments": [
              {
                "name": "category",
                "textValue": "Daily_lowest_temperature"
              }
            ],
            "triggerContext": {
              "timeContext": {
                "frequency": "DAILY"
              }
            }
          }
        }
      ]
    }
  ],
  "conversationToken": "{\"data\":{}}",
  "userStorage": "{\"data\":{}}"
}

عندما يستدعي المستخدم التحديث اليومي، ستتضمّن النية من عملية التحديث الآن. الوسيطات التي تحتوي على القيم التي قدمها المستخدم أثناء التسجيل. استخدام هذه لتخصيص التحديث لكل مستخدم.

اختبار التحديثات اليومية

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