পুশ বিজ্ঞপ্তি (Dialogflow)

Dialogflow-তে এক্সপ্লোর করুন

Dialogflow-এ আমাদের বিজ্ঞপ্তি স্যাম্পেল ইমপোর্ট করতে চালিয়ে যান বিকল্পে ক্লিক করুন। তারপর, স্যাম্পেল ডিপ্লয় ও পরীক্ষা করতে নিচে উল্লেখ করা ধাপগুলি অনুসরণ করুন:

  1. এজেন্টের নাম লিখুন এবং স্যাম্পেলের জন্য নতুন Dialogflow এজেন্ট তৈরি করুন।
  2. এজেন্ট ইমপোর্ট করা হয়ে গেলে, এজেন্টে যান বিকল্পে ক্লিক করুন।
  3. প্রধান নেভিগেশন মেনু থেকে, ফুলফিলমেন্ট বিকল্পে যান।
  4. ইনলাইন এডিটর চালু করে ডিপ্লয় করুন বিকল্পে ক্লিক করুন। এডিটরে স্যাম্পেল কোড আছে।
  5. প্রধান নেভিগেশন মেনু থেকে, ইন্টিগ্রেশন বিকল্পে যান, তারপর Google Assistant বিকল্পে ক্লিক করুন।
  6. যে মোডাল উইন্ডোটি দেখা যাবে, সেখানে পরিবর্তন অটো-প্রিভিউ করুন বিকল্প চালু করুন এবং অ্যাকশন সিমুলেটর খুলতে পরীক্ষা করুন বিকল্পে ক্লিক করুন।
  7. সিমুলেটরে, স্যাম্পেল পরীক্ষা করতে Talk to my test app লিখুন!
চালিয়ে যান

আপনার অ্যাকশন প্রাসঙ্গিক হলে ব্যবহারকারীদের পুশ বিজ্ঞপ্তি পাঠাতে পারে, যেমন কোনও টাস্কের শেষ করার তারিখ কাছাকাছি এলে রিমাইন্ডার পাঠানো।

এই গাইডে, আপনার অ্যাকশনের জন্য কীভাবে পুশ বিজ্ঞপ্তি সেট-আপ করবেন তা দেখানোর জন্য আমরা রেফারেন্স হিসেবে Actions on Google সংক্রান্ত পরামর্শের স্যাম্পেল ব্যবহার করি। ব্যবহারকারী এই অ্যাকশন চালু করলে, এটি জিজ্ঞাসা করে যে তিনি নিজের অ্যাকশন ডেভেলপ করার ব্যাপারে কোনও পরামর্শ শুনতে চান কিনা। ব্যবহারকারীরা পরামর্শের জন্য নির্দিষ্ট বা র‍্যান্ডমভাবে বেছে নেওয়া বিভাগ বেছে নিতে পারেন অথবা সবচেয়ে সাম্প্রতিক পরামর্শ শোনার বিকল্প বেছে নিতে পারেন।

যেসব সারফেসে কাজ করে

Android ও iOS ডিভাইসে পুশ বিজ্ঞপ্তি উপলভ্য (পুশ বিজ্ঞপ্তি পেতে iOS ডিভাইসে Assistant অ্যাপ ইনস্টল করা থাকতে হবে)। বর্তমানে ভয়েস-অ্যাক্টিভেটেড স্পিকার, স্মার্ট ডিসপ্লে বা অন্যান্য সারফেসে এগুলি কাজ করে না।

পূর্বশর্ত

আপনার অ্যাকশন প্রোজেক্টের অন্তত একটি অ্যাকশনকে ট্রিগার ইনটেন্ট হিসেবে কনফিগার করতে হবে, যা ব্যবহারকারী Assistant থেকে পাওয়া বিজ্ঞপ্তিতে ট্যাপ করলে চালু হবে।

পুশ বিজ্ঞপ্তি থেকে ডিফল্ট স্বাগত ইনটেন্ট ট্রিগার করার জন্য আপনার অ্যাকশন কনফিগার করা যাবে না।

কনসোল সেট-আপ

আপনার অ্যাকশনে পুশ বিজ্ঞপ্তির জন্য সহায়তা যোগ করতে:

  1. অ্যাকশন কনসোল-এ যান এবং তৈরি করুন > অ্যাকশন বিকল্পে নেভিগেট করুন।

  2. যে অতিরিক্ত ট্রিগারিং ইনটেন্টের জন্য পুশ বিজ্ঞপ্তি চালু করতে চান, সেটির সাথে ম্যাচ করে এমন অ্যাকশনে ক্লিক করুন।

    Actions on Google-এর পরামর্শের স্যাম্পেলের জন্য, আপনি "tell_latest_tip" বেছে নেবেন।

  3. স্ক্রল করে ব্যবহারকারীর এনগেজমেন্ট বিভাগে যান এবং আপনি কি পুশ বিজ্ঞপ্তি পাঠাতে চান বিকল্পটি চালু করুন।

  4. কন্টেন্টের নাম লিখুন।

    Actions on Google-এর পরামর্শের স্যাম্পেলের জন্য, শিরোনাম "নতুন পরামর্শ যোগ করা হয়েছে" হতে পারে।

  5. সেভ করুন বিকল্পে ক্লিক করুন।

ইমপোর্ট

পরবর্তী বিভাগের উদ্দেশ্যে, আপনার ফুলফিলমেন্ট কোডে, আপনাকে নিম্নলিখিত ইমপোর্ট ঘোষণা করতে হবে:

Dialogflow
const {
  dialogflow,
  UpdatePermission,
  Suggestions,
} = require('actions-on-google');
Actions SDK
const {
  actionssdk,
  UpdatePermission,
  Suggestions,
} = require('actions-on-google');

অপ্ট-ইন করা ব্যবহারকারী

ব্যবহারকারীদের পুশ বিজ্ঞপ্তি পাঠানোর আগে, আপনাকে অবশ্যই তাদের অপ্ট-ইন করতে বলতে হবে। আপনি তাদের অনুমতি চাওয়ার জন্য সাজেশন চিপ দেখিয়ে এটি করতে পারেন। তিনি অনুমতি দিলে, আপনি একটি আপডেট করা ব্যবহারকারীর আইডি পাবেন যার মাধ্যমে সেই ব্যবহারকারীকে পুশ বিজ্ঞপ্তি পাঠাতে পারবেন।

চালু করার জন্য সাজেশন চিপ দেখুন

ব্যবহারকারীরা আপনার অ্যাকশন থেকে পুশ বিজ্ঞপ্তি পাওয়ার আগে, আপনাকে অবশ্যই তাদের একটি সাজেশন চিপ দেখাতে হবে যাতে তারা পুশ বিজ্ঞপ্তির জন্য অপ্ট-ইন করার আমন্ত্রণ পান।

নিম্নলিখিত কোড স্নিপেট ব্যবহারকারীকে টেক্সট উত্তরের পাশাপাশি 'নতুন পরামর্শ সম্পর্কে আমাকে সতর্ক করুন' সাজেশন চিপ পাঠায়।

Dialogflow Node.js
conv.ask('I can send you push notifications. Would you like that?');
conv.ask(new Suggestions('Send notifications'));
Actions SDK Node.js
conv.ask(' I can send you push notifications. Would you like that?');
conv.ask(new Suggestions('Send notifications'));
Dialogflow Java
responseBuilder
    .add("I can send you push notifications. Would you like that?")
    .addSuggestions(new String[] {
        "Send notifications"
    });
Actions SDK Java
responseBuilder
    .add("I can send you push notifications. Would you like that?")
    .addSuggestions(new String[] {
        "Send notifications"
    });
Dialogflow JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "Hi! Welcome to Push Notifications!"
            }
          },
          {
            "simpleResponse": {
              "textToSpeech": "I can send you push notifications. Would you like that?"
            }
          }
        ],
        "suggestions": [
          {
            "title": "Send notifications"
          }
        ]
      }
    }
  }
}
Actions SDK JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.TEXT"
        }
      ],
      "inputPrompt": {
        "richInitialPrompt": {
          "items": [
            {
              "simpleResponse": {
                "textToSpeech": "Hi! Welcome to Push Notifications!"
              }
            },
            {
              "simpleResponse": {
                "textToSpeech": " I can send you push notifications. Would you like that?"
              }
            }
          ],
          "suggestions": [
            {
              "title": "Send notifications"
            }
          ]
        }
      }
    }
  ]
}

তিনি চিপে ট্যাপ করার পরে, আপনাকে অবশ্যই UPDATE-এর অনুমতি চাইতে হবে। Node.js ক্লায়েন্ট লাইব্রেরির askForUpdatePermission ফাংশন ব্যবহার করে কীভাবে এটি করবেন তা নিম্নলিখিত কোড থেকে জানতে পারবেন।

Dialogflow Node.js
  1. Dialogflow কনসোলে আপনার এজেন্ট খুলুন এবং আপডেটের জন্য আপনি যে ইনটেন্ট কনফিগার করছেন সেটি বেছে নিন।
  2. নিচের দিকে স্ক্রল করে উত্তর বিকল্পে যান এবং Google Assistant ট্যাব খুলুন।
  3. মেসেজের কন্টেন্ট যোগ করুন বিকল্পে ক্লিক করে সাজেশন চিপ বেছে নিন।
  4. চিপ টেক্সট এমনভাবে সেট করুন যাতে ব্যবহারকারী অপ্ট-ইন করতে আগ্রহী হন। Actions on Google-এর পরামর্শের স্যাম্পেলে আমরা চিপটি নতুন পরামর্শ সম্পর্কে আমাকে সতর্ক করুন হিসেবে সেট করেছি।
  5. আরেকটি Dialogflow ইনটেন্ট যোগ করুন, যেমন setup_push এবং সংশ্লিষ্ট অ্যাকশন সেট করুন, যেমন setup.push। এই ইনটেন্টের ব্যবহারকারীর এক্সপ্রেশন অবশ্যই অপ্ট-ইন চিপের টেক্সটের সাথে মিলতে হবে, আমাদের উদাহরণে নতুন পরামর্শ সম্পর্কে আমাকে সতর্ক করুন।
নিচের স্নিপেট থেকে জানতে পারবেন যে Node.js-এর জন্য Actions on Google ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কীভাবে অনুমতি চাইতে হয়:
app.intent('Subscribe to Notifications', (conv) => {
  conv.ask(new UpdatePermission({
    intent: 'Notification',
  }));
});
Actions SDK Node.js

ব্যবহারকারীর এক্সপ্রেশন পুশ বিজ্ঞপ্তির অপ্ট-ইন প্রম্পটের ভ্যালুর সাথে মিলে গেলে, অনুমতি চাওয়ার ফাংশন ট্রিগার করার জন্য আপনার NLU সলিউশন কনফিগার করা উচিত। স্ট্রিং ম্যাচিংয়ের উপর ভিত্তি করে এখানে একটি খুব সাধারণ উদাহরণ দেওয়া হল:

conv.ask(new UpdatePermission({
  intent: 'Notification',
}));
Dialogflow Java
  1. Dialogflow কনসোলে আপনার এজেন্ট খুলুন এবং আপডেটের জন্য আপনি যে ইনটেন্ট কনফিগার করছেন সেটি বেছে নিন।
  2. নিচের দিকে স্ক্রল করে উত্তর বিকল্পে যান এবং Google Assistant ট্যাব খুলুন।
  3. মেসেজের কন্টেন্ট যোগ করুন বিকল্পে ক্লিক করে সাজেশন চিপ বেছে নিন।
  4. চিপ টেক্সট এমনভাবে সেট করুন যাতে ব্যবহারকারী অপ্ট-ইন করতে আগ্রহী হন। Actions on Google-এর পরামর্শের স্যাম্পেলে আমরা চিপটি নতুন পরামর্শ সম্পর্কে আমাকে সতর্ক করুন হিসেবে সেট করেছি।
  5. আরেকটি Dialogflow ইনটেন্ট যোগ করুন, যেমন setup_push এবং সংশ্লিষ্ট অ্যাকশন সেট করুন, যেমন setup.push। এই ইনটেন্টের ব্যবহারকারীর এক্সপ্রেশন অবশ্যই অপ্ট-ইন চিপের টেক্সটের সাথে মিলতে হবে, আমাদের উদাহরণে নতুন পরামর্শ সম্পর্কে আমাকে সতর্ক করুন।
Actions on Google Java/Kotlin ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কীভাবে অনুমতির অনুরোধ করতে হয় তা নিম্নলিখিত স্নিপেট থেকে জানতে পারবেন:
@ForIntent("Subscribe to Notifications")
public ActionResponse subscribeToNotifications(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  responseBuilder.add(new UpdatePermission().setIntent("Notification"));
  return responseBuilder.build();
}
Actions SDK Java

ব্যবহারকারীর এক্সপ্রেশন পুশ বিজ্ঞপ্তির অপ্ট-ইন প্রম্পটের ভ্যালুর সাথে মিলে গেলে, অনুমতি চাওয়ার ফাংশন ট্রিগার করার জন্য আপনার NLU সলিউশন কনফিগার করা উচিত। স্ট্রিং ম্যাচিংয়ের উপর ভিত্তি করে এখানে একটি খুব সাধারণ উদাহরণ দেওয়া হল:

ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder.add(new UpdatePermission().setIntent("Notification"));
return responseBuilder.build();
Dialogflow JSON

মনে রাখবেন, নিচের JSON, Dialogflow ব্যবহার করে একটি ওয়েবহুক রেসপন্স বর্ণনা করে।

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "systemIntent": {
        "intent": "actions.intent.PERMISSION",
        "data": {
          "@type": "type.googleapis.com/google.actions.v2.PermissionValueSpec",
          "permissions": [
            "UPDATE"
          ],
          "updatePermissionValueSpec": {
            "intent": "tell_latest_tip"
          }
        }
      }
    }
  }
}
Actions SDK JSON

মনে রাখবেন, নিচে দেওয়া JSON, Actions SDK ব্যবহার করে ওয়েবহুক রেসপন্স বর্ণনা করে।

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.PERMISSION",
          "inputValueData": {
            "@type": "type.googleapis.com/google.actions.v2.PermissionValueSpec",
            "permissions": [
              "UPDATE"
            ],
            "updatePermissionValueSpec": {
              "intent": "tell_latest_tip"
            }
          }
        }
      ]
    }
  ]
}

সাবস্ক্রিপশন চূড়ান্ত করুন

আপনার Node.js ওয়েবহুক থেকে সাবস্ক্রিপশন চূড়ান্ত করতে, আপনাকে ব্যবহারকারীর বিজ্ঞপ্তি আইডি এবং তার বেছে নেওয়া ইনটেন্ট সেভ করতে হবে। ব্যবহারকারী অনুমতি দিলে, দুটিই আর্গুমেন্ট হিসেবে পাস করা হয়।

আপনার অ্যাকশন Dialogflow-এর মাধ্যমে তৈরি করা হলে, আপনাকে এগুলি করতে হবে:

  • actions_intent_PERMISSION ম্যানেজ করে এমন একটি ইনটেন্ট যোগ করুন।
  • ইনটেন্টের অ্যাকশন-এর নাম এমন কিছু দিন যাতে আপনার ওয়েবহুক পরে ফিল্টার করতে পারে।

নিচে দেওয়া কোড থেকে জানতে পারবেন যে finish.push.setup অ্যাকশন নামের সাথে finish_push_setup নামের ইনটেন্ট সহ Dialogflow ইনটেন্ট কীভাবে ম্যানেজ করতে হয়:

Dialogflow Node.js
app.intent('Confirm Notifications Subscription', (conv) => {
  if (conv.arguments.get('PERMISSION')) {
    const updatesUserId = conv.arguments.get('UPDATES_USER_ID');
    // Store user ID in database for later use
    conv.close(`Ok, I'll start alerting you.`);
  } else {
    conv.close(`Ok, I won't alert you.`);
  }
});
Actions SDK Node.js
app.intent('actions.intent.PERMISSION', (conv) => {
  if (conv.arguments.get('PERMISSION')) {
    const updatesUserId = conv.arguments.get('UPDATES_USER_ID');
    // Store user ID in database for later use
    conv.close(`Ok, I'll start alerting you.`);
  } else {
    conv.close(`Ok, I won't alert you.`);
  }
});
Dialogflow Java
@ForIntent("Confirm Notifications Subscription")
public ActionResponse confirmNotificationsSubscription(ActionRequest request) {
  // Verify the user has subscribed for push notifications
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  if (request.isPermissionGranted()) {
    Argument userId = request.getArgument(ConstantsKt.ARG_UPDATES_USER_ID);
    if (userId != null) {
      // Store the user's ID in the database
    }
    responseBuilder.add("Ok, I'll start alerting you.");
  } else {
    responseBuilder.add("Ok, I won't alert you.");
  }
  responseBuilder.endConversation();
  return responseBuilder.build();
}
Actions SDK Java
@ForIntent("actions.intent.PERMISSION")
public ActionResponse confirmNotificationsSubscription(ActionRequest request) {
  // Verify the user has subscribed for push notifications
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  if (request.isPermissionGranted()) {
    Argument userId = request.getArgument(ConstantsKt.ARG_UPDATES_USER_ID);
    if (userId != null) {
      // Store the user's ID in the database
    }
    responseBuilder.add("Ok, I'll start alerting you.");
  } else {
    responseBuilder.add("Ok, I won't alert you.");
  }
  responseBuilder.endConversation();
  return responseBuilder.build();
}
Dialogflow JSON

মনে রাখবেন, নিচে দেওয়া JSON-এ ওয়েবহুকের জন্য করা অনুরোধের বিবরণ দেওয়া আছে।

{
  "responseId": "ee9e7ed5-fa1a-48c6-aac7-f9fbe94f1f58-712767ed",
  "queryResult": {
    "queryText": "actions_intent_PERMISSION",
    "action": "confirm.subscription",
    "parameters": {},
    "allRequiredParamsPresent": true,
    "fulfillmentMessages": [
      {
        "text": {
          "text": [
            ""
          ]
        }
      }
    ],
    "outputContexts": [
      {
        "name": "projects/PROJECT_ID/agent/sessions/ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k/contexts/actions_capability_screen_output"
      },
      {
        "name": "projects/PROJECT_ID/agent/sessions/ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k/contexts/actions_capability_account_linking"
      },
      {
        "name": "projects/PROJECT_ID/agent/sessions/ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k/contexts/actions_capability_media_response_audio"
      },
      {
        "name": "projects/PROJECT_ID/agent/sessions/ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k/contexts/actions_capability_audio_output"
      },
      {
        "name": "projects/PROJECT_ID/agent/sessions/ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k/contexts/actions_capability_web_browser"
      },
      {
        "name": "projects/PROJECT_ID/agent/sessions/ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k/contexts/google_assistant_input_type_keyboard"
      },
      {
        "name": "projects/PROJECT_ID/agent/sessions/ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k/contexts/actions_intent_permission",
        "parameters": {
          "PERMISSION": true,
          "text": "yes",
          "UPDATES_USER_ID": "ABwppHHssyPbvEBF1mgN7Ddwb7mkhiVohW9PZ--I_svqy7zFElA4DHkf9pn04UBd5gwZo26_RfXCQ8otcztyIfe6MCQ"
        }
      }
    ],
    "intent": {
      "name": "projects/PROJECT_ID/agent/intents/c7f7b30b-5b88-4bb5-b0b8-1cd0862d1dd2",
      "displayName": "Confirm Notifications Subscription"
    },
    "intentDetectionConfidence": 1,
    "languageCode": "en"
  },
  "originalDetectIntentRequest": {
    "source": "google",
    "version": "2",
    "payload": {
      "user": {
        "permissions": [
          "UPDATE"
        ],
        "locale": "en-US",
        "userVerificationStatus": "VERIFIED"
      },
      "conversation": {
        "conversationId": "ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k",
        "type": "ACTIVE",
        "conversationToken": "[]"
      },
      "inputs": [
        {
          "intent": "actions.intent.PERMISSION",
          "rawInputs": [
            {
              "inputType": "KEYBOARD",
              "query": "yes"
            }
          ],
          "arguments": [
            {
              "name": "PERMISSION",
              "boolValue": true,
              "textValue": "true"
            },
            {
              "name": "text",
              "rawText": "yes",
              "textValue": "yes"
            },
            {
              "name": "UPDATES_USER_ID",
              "textValue": "ABwppHHssyPbvEBF1mgN7Ddwb7mkhiVohW9PZ--I_svqy7zFElA4DHkf9pn04UBd5gwZo26_RfXCQ8otcztyIfe6MCQ"
            }
          ]
        }
      ],
      "surface": {
        "capabilities": [
          {
            "name": "actions.capability.SCREEN_OUTPUT"
          },
          {
            "name": "actions.capability.ACCOUNT_LINKING"
          },
          {
            "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
          },
          {
            "name": "actions.capability.AUDIO_OUTPUT"
          },
          {
            "name": "actions.capability.WEB_BROWSER"
          }
        ]
      },
      "availableSurfaces": [
        {
          "capabilities": [
            {
              "name": "actions.capability.AUDIO_OUTPUT"
            },
            {
              "name": "actions.capability.SCREEN_OUTPUT"
            },
            {
              "name": "actions.capability.WEB_BROWSER"
            }
          ]
        }
      ]
    }
  },
  "session": "projects/PROJECT_ID/agent/sessions/ABwppHGIgmmU3zBcYMF_vWoHaM4JUo3wniYBHdbUF25l63G7EQWjRnlne8Ar7AOcRHWn1lrEKGy8qdP0UXLcWDBq93k"
}
Actions SDK JSON

মনে রাখবেন, নিচে দেওয়া JSON-এ ওয়েবহুকের জন্য করা অনুরোধের বিবরণ দেওয়া আছে।

{
  "user": {
    "permissions": [
      "UPDATE"
    ],
    "locale": "en-US",
    "userVerificationStatus": "VERIFIED"
  },
  "conversation": {
    "conversationId": "ABwppHEP6OAFZHkSGEiZ5HYM9qrlk8YtIH1DQmJ52cxXELSPvM-kSc_tMJ_5O6ITbgVJlY9i2FIsKWjE_HXLke48",
    "type": "NEW"
  },
  "inputs": [
    {
      "intent": "actions.intent.PERMISSION",
      "rawInputs": [
        {
          "inputType": "KEYBOARD",
          "query": "yes"
        }
      ],
      "arguments": [
        {
          "name": "PERMISSION",
          "boolValue": true,
          "textValue": "true"
        },
        {
          "name": "text",
          "rawText": "yes",
          "textValue": "yes"
        },
        {
          "name": "UPDATES_USER_ID",
          "textValue": "ABwppHFvBKC-tMYUsUjJkm3YECgZvd6A3sOc7KuQvO4ZdQX3bGLmyoQ41dh4Zmtlzv_kaOKBt1Sf6eRpNbayynrl"
        }
      ]
    }
  ],
  "surface": {
    "capabilities": [
      {
        "name": "actions.capability.AUDIO_OUTPUT"
      },
      {
        "name": "actions.capability.WEB_BROWSER"
      },
      {
        "name": "actions.capability.SCREEN_OUTPUT"
      },
      {
        "name": "actions.capability.ACCOUNT_LINKING"
      },
      {
        "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
      }
    ]
  },
  "availableSurfaces": [
    {
      "capabilities": [
        {
          "name": "actions.capability.AUDIO_OUTPUT"
        },
        {
          "name": "actions.capability.SCREEN_OUTPUT"
        },
        {
          "name": "actions.capability.WEB_BROWSER"
        }
      ]
    }
  ]
}

বিজ্ঞপ্তি পাঠান

আপনি Actions API ব্যবহার করে ব্যবহারকারীদের পুশ বিজ্ঞপ্তি পাঠাতে পারেন। এই API ব্যবহার করতে, আপনার Google Cloud প্রোজেক্টে API অ্যাক্টিভেট করতে হবে এবং JSON পরিষেবা অ্যাকাউন্ট 'কী' সেট-আপ ও ডাউনলোড করতে হবে। এখানে কোড স্যাম্পেলে দেওয়া নির্দেশাবলী থেকে ৮ নম্বর ধাপ দেখুন।

এরপর আপনি Google OAuth2 ক্লায়েন্ট লাইব্রেরি ব্যবহার করে অ্যাক্সেস টোকেনের জন্য পরিষেবা অ্যাকাউন্টের কী এক্সচেঞ্জ করতে পারবেন এবং টোকেন ব্যবহার করে Actions API-তে আপনার অনুরোধ যাচাই করতে পারবেন।

পরিষেবা অ্যাকাউন্টের 'কী' পাওয়া

  1. এই URL-এ যান, শেষে "example-project-1" সরিয়ে আপনার প্রোজেক্ট আইডি লিখুন অ্যাকশন কনসোলে: https://console.developers.google.com/apis/api/actions.googleapis.com/overview?project=example-project-1
  2. আপনি চালু করুন বোতাম দেখতে পেলে, সেটিতে ক্লিক করুন। না হলে, ধাপ ৩-এ যান।
  3. এই URL-এ যান, শেষে "example-project-1" আপনার প্রোজেক্ট আইডি দিয়ে পরিবর্তন করুন Actions কনসোলে: https://console.developers.google.com/apis/credentials?project=example-project-1
  4. ক্রেডেনশিয়াল তৈরি করুন > পরিষেবা অ্যাকাউন্টের 'কী' বিকল্পে ক্লিক করুন।
  5. পরিষেবা অ্যাকাউন্ট বিকল্পের অধীনে বেছে নিন বক্সে ক্লিক করুন এবং নতুন পরিষেবা অ্যাকাউন্ট বিকল্পে ক্লিক করুন।
  6. পরিষেবা অ্যাকাউন্টের নাম "বিজ্ঞপ্তি" এবং ভূমিকা প্রোজেক্টের মালিক হিসেবে সেট করুন।
  7. JSON কী-এর ধরন বেছে নিয়ে তৈরি করুন বিকল্পে ক্লিক করুন। আপনার লোকাল মেশিনে JSON পরিষেবা অ্যাকাউন্ট কী ডাউনলোড করা হয়েছে।

অ্যাক্সেস টোকেনের জন্য 'কী' এক্সচেঞ্জ করুন এবং বিজ্ঞপ্তি পাঠান

Actions API-এর মাধ্যমে বিজ্ঞপ্তি পাঠাতে, আপনাকে অ্যাক্সেস টোকেনের জন্য পরিষেবা অ্যাকাউন্ট কী এক্সচেঞ্জ করতে হবে। এর জন্য আমরা Google API ক্লায়েন্ট লাইব্রেরি ব্যবহার করার সাজেশন দিই। এর পরে দেখানো কোড স্নিপেটের সিরিজে, আমরা Google API Node.js ক্লায়েন্ট লাইব্রেরি ব্যবহার করছি।

  1. Google API ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন এবং অনুরোধ করুন: npm install googleapis request --save
  2. পরিষেবা অ্যাকাউন্ট কী থেকে অ্যাক্সেস টোকেন পেতে এবং পুশ বিজ্ঞপ্তি পাঠাতে নিম্নলিখিত কোড ব্যবহার করুন:
Dialogflow Node.js
const {google} = require('googleapis');
const request = require('request');

const jwtClient = new google.auth.JWT(
  serviceAccount.client_email, null, serviceAccount.private_key,
  ['https://www.googleapis.com/auth/actions.fulfillment.conversation'],
  null
);

jwtClient.authorize((err, tokens) => {
  if (!err) {
    request.post('https://actions.googleapis.com/v2/conversations:send', {
      auth: {
        bearer: tokens.access_token,
      },
      json: true,
      body: {
        customPushMessage: {
          userNotification: {
            title: 'Push Notification Title',
          },
          target: {
            userId: '<UPDATES_USER_ID>',
            intent: 'Notification Intent',
          },
        },
        isInSandbox: true,
      },
    }, (err, httpResponse, body) => {
      console.log(`${httpResponse.statusCode}: ${httpResponse.statusMessage}`);
    });
  }
});
Actions SDK Node.js
const {google} = require('googleapis');
const request = require('request');

const jwtClient = new google.auth.JWT(
  serviceAccount.client_email, null, serviceAccount.private_key,
  ['https://www.googleapis.com/auth/actions.fulfillment.conversation'],
  null
);

jwtClient.authorize((err, tokens) => {
  if (!err) {
    request.post('https://actions.googleapis.com/v2/conversations:send', {
      auth: {
        bearer: tokens.access_token,
      },
      json: true,
      body: {
        customPushMessage: {
          userNotification: {
            title: 'Push Notification Title',
          },
          target: {
            userId: '<UPDATES_ORDER_ID>',
            intent: 'Notification Intent',
          },
        },
        isInSandbox: true,
      },
    }, (err, httpResponse, body) => {
      console.log(`${httpResponse.statusCode}: ${httpResponse.statusMessage}`);
    });
  }
});
Dialogflow Java
final class Notification {

  private final String title;

  Notification(String title) {
    this.title = title;
  }

  String getTitle() {
    return title;
  }
}

final class Target {

  private final String userId;
  private final String intent;
  private final String locale;

  Target(String userId, String intent, String locale) {
    this.userId = userId;
    this.intent = intent;
    this.locale = locale;
  }

  String getUserId() {
    return userId;
  }

  String getIntent() {
    return intent;
  }

  String getLocale() {
    return locale;
  }
}

final class PushMessage {

  private final Notification userNotification;
  private final Target target;

  PushMessage(Notification userNotification, Target target) {
    this.userNotification = userNotification;
    this.target = target;
  }

  Notification getUserNotification() {
    return userNotification;
  }

  Target getTarget() {
    return target;
  }
}

final class PushNotification {

  private final PushMessage customPushMessage;
  private boolean isInSandbox;

  PushNotification(PushMessage customPushMessage, boolean isInSandbox) {
    this.customPushMessage = customPushMessage;
    this.isInSandbox = isInSandbox;
  }

  PushMessage getCustomPushMessage() {
    return customPushMessage;
  }

  boolean getIsInSandbox() {
    return isInSandbox;
  }
}

private PushNotification createNotification(String title, String userId, String intent, String locale) {
  Notification notification = new Notification(title);
  Target target = new Target(userId, intent, locale);
  PushMessage message = new PushMessage(notification, target);
  boolean isInSandbox = true;
  return new PushNotification(message, isInSandbox);
}

private ServiceAccountCredentials loadCredentials() throws IOException {
  String actionsApiServiceAccountFile =
      this.getClass().getClassLoader().getResource("service-account.json").getFile();
  InputStream actionsApiServiceAccount = new FileInputStream(actionsApiServiceAccountFile);
  ServiceAccountCredentials serviceAccountCredentials =
      ServiceAccountCredentials.fromStream(actionsApiServiceAccount);
  return (ServiceAccountCredentials)
      serviceAccountCredentials.createScoped(
          Collections.singleton(
              "https://www.googleapis.com/auth/actions.fulfillment.conversation"));
}

private String getAccessToken() throws IOException {
  AccessToken token = loadCredentials().refreshAccessToken();
  return token.getTokenValue();
}

public void sendNotification(String title, String userId, String intent, String locale) throws IOException {
  Preconditions.checkNotNull(title, "title cannot be null.");
  Preconditions.checkNotNull(userId, "userId cannot be null.");
  Preconditions.checkNotNull(intent, "intent cannot be null.");
  Preconditions.checkNotNull(locale, "locale cannot be null");
  PushNotification notification = createNotification(title, userId, intent, locale);

  HttpPost request = new HttpPost("https://actions.googleapis.com/v2/conversations:send");

  String token = getAccessToken();

  request.setHeader("Content-type", "application/json");
  request.setHeader("Authorization", "Bearer " + token);

  StringEntity entity = new StringEntity(new Gson().toJson(notification));
  entity.setContentType(ContentType.APPLICATION_JSON.getMimeType());
  request.setEntity(entity);
  HttpClient httpClient = HttpClientBuilder.create().build();
  httpClient.execute(request);
}
Actions SDK Java
final class Notification {

  private final String title;

  Notification(String title) {
    this.title = title;
  }

  String getTitle() {
    return title;
  }
}

final class Target {

  private final String userId;
  private final String intent;

  Target(String userId, String intent) {
    this.userId = userId;
    this.intent = intent;
  }

  String getUserId() {
    return userId;
  }

  String getIntent() {
    return intent;
  }
}

final class PushMessage {

  private final Notification userNotification;
  private final Target target;

  PushMessage(Notification userNotification, Target target) {
    this.userNotification = userNotification;
    this.target = target;
  }

  Notification getUserNotification() {
    return userNotification;
  }

  Target getTarget() {
    return target;
  }
}

final class PushNotification {

  private final PushMessage customPushMessage;
  private boolean isInSandbox;

  PushNotification(PushMessage customPushMessage, boolean isInSandbox) {
    this.customPushMessage = customPushMessage;
    this.isInSandbox = isInSandbox;
  }

  PushMessage getCustomPushMessage() {
    return customPushMessage;
  }

  boolean getIsInSandbox() {
    return isInSandbox;
  }
}

private PushNotification createNotification(String title, String userId, String intent) {
  Notification notification = new Notification(title);
  Target target = new Target(userId, intent);
  PushMessage message = new PushMessage(notification, target);
  boolean isInSandbox = true;
  return new PushNotification(message, isInSandbox);
}

private ServiceAccountCredentials loadCredentials() throws IOException {
  String actionsApiServiceAccountFile =
      this.getClass().getClassLoader().getResource("service-account.json").getFile();
  InputStream actionsApiServiceAccount = new FileInputStream(actionsApiServiceAccountFile);
  ServiceAccountCredentials serviceAccountCredentials =
      ServiceAccountCredentials.fromStream(actionsApiServiceAccount);
  return (ServiceAccountCredentials)
      serviceAccountCredentials.createScoped(
          Collections.singleton(
              "https://www.googleapis.com/auth/actions.fulfillment.conversation"));
}

private String getAccessToken() throws IOException {
  AccessToken token = loadCredentials().refreshAccessToken();
  return token.getTokenValue();
}

public void sendNotification(String title, String userId, String intent) throws IOException {
  Preconditions.checkNotNull(title, "title cannot be null.");
  Preconditions.checkNotNull(userId, "userId cannot be null.");
  Preconditions.checkNotNull(intent, "intent cannot be null.");
  PushNotification notification = createNotification(title, userId, intent);

  HttpPost request = new HttpPost("https://actions.googleapis.com/v2/conversations:send");

  String token = getAccessToken();

  request.setHeader("Content-type", "application/json");
  request.setHeader("Authorization", "Bearer " + token);

  StringEntity entity = new StringEntity(new Gson().toJson(notification));
  entity.setContentType(ContentType.APPLICATION_JSON.getMimeType());
  request.setEntity(entity);
  HttpClient httpClient = HttpClientBuilder.create().build();
  httpClient.execute(request);
}