বার্তা গ্রহণ

RBM এজেন্ট একটি ওয়েবহুকের মাধ্যমে বার্তা এবং ইভেন্টগুলি গ্রহণ করে৷ যখন একজন ব্যবহারকারী আপনার এজেন্টকে একটি বার্তা পাঠান, তখন Google-এর RBM পরিষেবা আপনার কনফিগার করা ওয়েবহুকে বার্তা পাঠায়। আপনার এজেন্ট তারপর বার্তাটি ডিকোড করতে পারে, এটি প্রক্রিয়া করতে পারে এবং ব্যবহারকারীকে একটি প্রতিক্রিয়া জারি করতে পারে।

ব্যবহারকারীরা তাদের আরসিএস ক্লায়েন্ট অনুমতি দেয় এমন পাঠ্য, অবস্থান বা ফাইল পাঠাতে পারেন। আপনার এজেন্ট যেকোন পাঠ্য, অবস্থান, বা ব্যবহারকারী পাঠাতে পারে এমন ফাইলগুলি পরিচালনা করতে হবে, সেইসাথে সেই বার্তাগুলি ট্রিগার হতে পারে এমন কোনো ত্রুটির বর্ণনা দেয়।

আগত বার্তা পরিচালনা করুন

আপনার এজেন্ট কীভাবে ব্যবহারকারীদের বার্তাগুলি পরিচালনা করে এবং প্রতিক্রিয়া জানায় তা আপনার ব্যবসার যুক্তির উপর নির্ভর করে। সাধারণত, যাইহোক, ব্যবহারকারীর বার্তায় প্রতিক্রিয়া জানানোর পদক্ষেপগুলি সামঞ্জস্যপূর্ণ।

ধাপ 1: ব্যবহারকারীর পাঠানো বার্তার ধরন সনাক্ত করুন

ব্যবহারকারীরা চার ধরনের বার্তা পাঠাতে পারেন:

• টেক্সট মেসেজ ফ্রিফর্ম প্রতিক্রিয়া।
• পরামর্শ বার্তাগুলির মধ্যে পোস্টব্যাক ডেটা এবং প্রস্তাবিত ক্রিয়াকলাপের পাঠ্য বা ব্যবহারকারী ট্যাপ করা প্রস্তাবিত উত্তর অন্তর্ভুক্ত করে৷

• অবস্থান বার্তা অক্ষাংশ এবং দ্রাঘিমাংশ মান অন্তর্ভুক্ত.

  সতর্কতা: অবস্থানের মান যেকোন ব্যবহারকারী-নির্দিষ্ট অবস্থান হতে পারে, শুধুমাত্র ব্যবহারকারীর বর্তমান অবস্থান নয়।

• ফাইল বার্তাগুলি একটি ফাইল এবং সংশ্লিষ্ট ডেটার জন্য URI অন্তর্ভুক্ত করে।

ধাপ 2: বার্তা সামগ্রী প্রক্রিয়া করুন

ব্যবহারকারীর বার্তার বিষয়বস্তু আপনার এজেন্টের যুক্তি এবং কথোপকথনের পরবর্তী প্রতিক্রিয়া নির্দেশ করবে।

ব্যবহারকারীর অভিপ্রায় সনাক্ত করার সবচেয়ে সহজ উপায় হল একটি প্রস্তাবিত উত্তর বা প্রস্তাবিত পদক্ষেপ থেকে পোস্টব্যাক ডেটা। পরামর্শের সাথে যুক্ত পাঠ্য নির্বিশেষে, পোস্টব্যাক ডেটা মেশিন-পাঠযোগ্য।

যদি একজন ব্যবহারকারী একটি পাঠ্য বার্তা পাঠায়, আপনার এজেন্ট সমর্থিত কীওয়ার্ডগুলির জন্য প্রতিক্রিয়া বিশ্লেষণ করতে পারে বা ব্যবহারকারীর বার্তা প্রক্রিয়া করতে এবং এগিয়ে যাওয়ার পথ সনাক্ত করতে NLU (যেমন Dialogflow ) ব্যবহার করতে পারে।

অবস্থান এবং ফাইল বার্তা টেক্সট বা পোস্টব্যাক ডেটা অন্তর্ভুক্ত করে না, তাই আপনার এজেন্টকে উত্তর দেওয়ার আগে কথোপকথনের প্রেক্ষাপট এবং সাম্প্রতিক বার্তাগুলি বিবেচনা করা উচিত।

যদি আপনার এজেন্ট ব্যবহারকারীর বার্তার প্রতিক্রিয়া জানাতে না পারে তবে এটি একটি ত্রুটির অবস্থার সাথে প্রতিক্রিয়া জানাতে হবে এবং ব্যবহারকারীকে অতিরিক্ত তথ্যের জন্য অনুরোধ করে, অন্য উপায়ে ইনপুট চেয়ে বা প্রস্তাবিত উত্তর উপস্থাপন করে কথোপকথন চালিয়ে যাওয়ার চেষ্টা করবে। এবং এজেন্ট কীভাবে প্রতিক্রিয়া জানাতে হয় তা জানে।

ধাপ 3: ইন্টারঅ্যাকশনের জন্য ব্যবসায়িক যুক্তি পূরণ করুন

একবার আপনার এজেন্ট ব্যবহারকারীর বার্তার সঠিক প্রতিক্রিয়া সনাক্ত করলে, এটি আপনার অবকাঠামো থেকে প্রয়োজনীয় তথ্য সংগ্রহ করে এবং মিথস্ক্রিয়াটির জন্য ব্যবসায়িক যুক্তি পূরণের জন্য প্রয়োজনীয় অন্যান্য সিস্টেমের সাথে জড়িত হয়।

ধাপ 4: ব্যবহারকারীকে উত্তর দিন

এজেন্ট ইন্টারঅ্যাকশনের জন্য ব্যবসায়িক যুক্তি পূরণ করার পরে, এটি অন্য বার্তা পাঠায় এবং ব্যবহারকারীর সাথে কথোপকথন চালিয়ে যায়।

উদাহরণ

নিম্নলিখিত কোডটি দেখায় কিভাবে আপনার এজেন্ট বার্তা গ্রহণ করে। বিন্যাস এবং মান তথ্যের জন্য, UserMessage দেখুন।

এজেন্ট টেক্সট পায়

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "text": "Hello, world!"
}

এজেন্ট একটি পরামর্শ থেকে একটি বার্তা পায়

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "suggestionResponse": {
    "postbackData": "suggestion_1",
    "text": "Suggestion #1"
  }
}

এজেন্ট একটি অবস্থান পায়

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "location": {
    "latitude": 37.422000,
    "longitude": -122.084056
  }
}

এজেন্ট একটি ফাইল পায়

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "userFile": {
    "category": "IMAGE",
    "thumbnail": {
      "mimeType": "image/jpeg",
      "fileSizeBytes": 1280,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c8",
      "fileName": "4_animated.jpeg"
    },
    "payload": {
      "mimeType": "image/gif",
      "fileSizeBytes": 127806,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c9",
      "fileName": "4_animated.gif"
    }
  }
}

ইনকামিং ইভেন্টগুলি পরিচালনা করুন

আপনার এজেন্ট যখন ব্যবহারকারীদের কাছে পাঠানো বার্তাগুলি বিতরণ এবং পড়া হয় তখন বিজ্ঞপ্তিগুলি পায়৷

নিম্নলিখিত কোডটি দেখায় কিভাবে আপনার এজেন্ট বার্তা গ্রহণ করে। বিন্যাস এবং মান তথ্যের জন্য, UserEvent দেখুন।

ব্যবহারকারীর কাছে বার্তা পাঠানো হয়েছে

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "eventType": "DELIVERED"
}

ব্যবহারকারীর দ্বারা পড়া বার্তা

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "eventType": "READ"
}

ব্যবহারকারী টাইপ করছে

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "IS_TYPING",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "agentId": "AGENT_ID"
}