REST Resource: phones.agentMessages

রিসোর্স: এজেন্টমেসেজ

এজেন্ট থেকে ব্যবহারকারীর কাছে পাঠানো একটি বার্তা।

JSON উপস্থাপনা 
{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },
  "messageTrafficType": enum (MessageTrafficType),
  "richMessageClassification": {
    object (RichMessageClassification)
  },
  "totalPayloadSizeBytes": string,
  "carrier": string,

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
ক্ষেত্র
name

string

এই ফিল্ডটি RCS for Business প্ল্যাটফর্ম দ্বারা সেট করা হয়। এজেন্ট মেসেজ তৈরি করার সময় এটি অন্তর্ভুক্ত করবেন না। ফিল্ডটি "phones/{E.164}/agentMessages/{messageId}" হিসেবে কাজ করে, যেখানে {E.164} হলো E.164 ফরম্যাটে ব্যবহারকারীর ফোন নম্বর এবং {messageId} হলো এজেন্ট মেসেজের জন্য এজেন্ট কর্তৃক নির্ধারিত আইডি।

sendTime

string ( Timestamp format)

এই ফিল্ডটি RCS for Business প্ল্যাটফর্ম দ্বারা সেট করা হয়। এজেন্ট মেসেজ তৈরি করার সময় এটি অন্তর্ভুক্ত করবেন না। এই ফিল্ডটি ব্যবহারকারীর কাছে মেসেজ পাঠানোর সময় নির্ধারণ করে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

contentMessage

object ( AgentContentMessage )

এজেন্ট বার্তার বিষয়বস্তু।

messageTrafficType

enum ( MessageTrafficType )

বার্তা ট্র্যাফিকের ধরণ।

richMessageClassification

object ( RichMessageClassification )

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

totalPayloadSizeBytes

string ( int64 format)

শুধুমাত্র আউটপুট। মেসেজটির মোট পেলোড সাইজ বাইটে পরিমাপ করা হয়। পেলোডটি একটি RCS for Business মেসেজের সমস্ত অ্যাটাচমেন্ট গণনা করে, যা ভিডিও, ছবি, পিডিএফ ইত্যাদি হতে পারে, তবে মেসেজের টেক্সট বা সাজেশন এর অন্তর্ভুক্ত নয়। বর্তমানে, এই ফিল্ডটি শুধুমাত্র মার্কিন ফোন নম্বরের জন্য পূরণ করা হয়।

carrier

string

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

ইউনিয়ন ক্ষেত্রের expiration ।

expiration নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

expireTime

string ( Timestamp format)

ঐচ্ছিক। এই রিসোর্সটি কখন মেয়াদোত্তীর্ণ বলে বিবেচিত হবে, তার UTC টাইমস্ট্যাম্প। এই মানটি সেট করা থাকলে অথবা TTL ফিল্ডটি সেট করা থাকলে, আউটপুটে প্রদান করা হয়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

ttl

string ( Duration format)

ঐচ্ছিক। শুধু ইনপুট করতে হবে। স্বয়ংক্রিয়ভাবে বাতিল হওয়ার আগে বার্তাটি কতক্ষণ কার্যকর থাকবে।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

এজেন্ট কন্টেন্ট মেসেজ

এজেন্ট থেকে ব্যবহারকারীর কাছে পাঠানো বার্তার বিষয়বস্তু।

JSON উপস্থাপনা 
{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // Union field content can be only one of the following:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
ক্ষেত্র
suggestions[]

object ( Suggestion )

প্রস্তাবিত উত্তর এবং প্রস্তাবিত পদক্ষেপের একটি তালিকা, যা সংশ্লিষ্ট এজেন্ট বার্তার পরে সাজেশন চিপের তালিকা হিসাবে প্রদর্শিত হয়। সর্বোচ্চ ১১টি সাজেশন।

চিপগুলো কেবল তখনই প্রদর্শিত হয় যখন সংশ্লিষ্ট এজেন্ট বার্তাটি কথোপকথনের (এজেন্ট এবং ব্যবহারকারী উভয়ের বার্তা সহ) মধ্যে সর্বশেষ বার্তা হয়। ব্যবহারকারী এজেন্টের কাছে টেক্সট উত্তর ফেরত পাঠাতে একটি প্রস্তাবিত উত্তরে ট্যাপ করতে পারেন অথবা ডিভাইসে কোনো নিজস্ব কাজ শুরু করতে একটি প্রস্তাবিত কাজে ট্যাপ করতে পারেন।

সাজেশনের ধরণ দুই প্রকারের হয়: স্থায়ী এবং অস্থায়ী। আরও বিস্তারিত জানতে, সাজেশনস দেখুন।

ইউনিয়ন ফিল্ডের content । এজেন্ট বার্তার content নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
text

string

UTF-8 ফরম্যাটে এনকোড করা টেক্সট। সর্বোচ্চ ৩০৭২টি অক্ষর।

fileName
(deprecated)

string

একটি ফাইলের অনন্য নাম। যখন কোনো এজেন্ট একটি ফাইল আপলোড করেন, তখন RCS for Business প্ল্যাটফর্মটি ফাইলের নামটি ফেরত দেয়। নিচে উল্লিখিত uploadedRbmFile-এর পক্ষে এটি বাতিল করা হয়েছে।

uploadedRbmFile

object ( UploadedRbmFile )

এতে একটি ফাইল এবং থাম্বনেইলের শনাক্তকারী রয়েছে, যা RCS for Business সার্ভারে আপলোড করা হয়েছিল এবং পরিবেশিত হয়েছিল।

richCard

object ( RichCard )

একটি স্বতন্ত্র ধনী কার্ড।

contentInfo

object ( ContentInfo )

একটি ফাইল সম্পর্কিত তথ্য, যার মধ্যে ফাইলটির ইউআরএল এবং ফাইলটির থাম্বনেইলের ইউআরএল অন্তর্ভুক্ত।

RCS for Business প্ল্যাটফর্মটি একটি ক্যাশে থেকে কন্টেন্ট পরিবেশন করে, কিন্তু একজন এজেন্ট RCS for Business প্ল্যাটফর্মটিকে কন্টেন্টের একটি নতুন সংস্করণ আনতে এবং ক্যাশে রিফ্রেশ করতে বাধ্য করতে পারে।

আপলোড করা Rbm ফাইল

ফাইল এবং থাম্বনেইল তথ্য সম্বলিত বার্তা

JSON উপস্থাপনা 
{
  "fileName": string,
  "thumbnailName": string
}
ক্ষেত্র
fileName

string

ফাইলটি আপলোড করার পর RCS for Business প্ল্যাটফর্ম থেকে প্রাপ্ত ফাইলের নাম।

thumbnailName

string

থাম্বনেইলটি আপলোড করার সময় RCS for Business প্ল্যাটফর্ম থেকে প্রাপ্ত থাম্বনেইলটির নাম।

রিচকার্ড

এজেন্টের পক্ষ থেকে ব্যবহারকারীর কাছে পাঠানো একটি স্বতন্ত্র রিচ কার্ড অথবা রিচ কার্ডের একটি ক্যারোসেল।

JSON উপস্থাপনা 
{

  // Union field card can be only one of the following:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of list of possible types for union field card.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড card । একক কার্ড অথবা কার্ডের ঘূর্ণায়মান সেট। card নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
carouselCard

object ( CarouselCard )

তাসের ঘূর্ণি।

standaloneCard

object ( StandaloneCard )

স্বতন্ত্র কার্ড।

ক্যারোসেলকার্ড

তাসের ঘূর্ণি।

JSON উপস্থাপনা 
{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
ক্ষেত্র
cardWidth

enum ( CarouselCard.CardWidth )

ক্যারোসেলের কার্ডগুলোর প্রস্থ।

cardContents[]

object ( CardContent )

ক্যারোসেলের প্রতিটি কার্ডের বিষয়বস্তুর তালিকা। একটি ক্যারোসেলে সর্বনিম্ন ২টি এবং সর্বোচ্চ ১০টি কার্ড থাকতে পারে।

CarouselCard.cardWidth

ক্যারোসেলের কার্ডগুলোর প্রস্থ।

এনাম
CARD_WIDTH_UNSPECIFIED নির্দিষ্ট করা হয়নি।
SMALL ১২০ ডিপি।
MEDIUM ২৩২ ডিপি।

কার্ডের বিষয়বস্তু

কার্ডের বিষয়বস্তু

JSON উপস্থাপনা 
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
ক্ষেত্র
title

string

(ঐচ্ছিক) কার্ডের শিরোনাম। সর্বোচ্চ ২০০ অক্ষর।

description

string

(ঐচ্ছিক) কার্ডটির বিবরণ। সর্বোচ্চ ২০০০ অক্ষর।

media

object ( Media )

(ঐচ্ছিক) কার্ডে অন্তর্ভুক্ত করার জন্য মিডিয়া (ছবি, জিআইএফ, ভিডিও, পিডিএফ)।

suggestions[]

object ( Suggestion )

(ঐচ্ছিক) কার্ডে অন্তর্ভুক্ত করার জন্য পরামর্শের তালিকা। সর্বোচ্চ ৪টি পরামর্শ।

মিডিয়া

একটি রিচ কার্ডের মধ্যে থাকা একটি মিডিয়া ফাইল।

JSON উপস্থাপনা 
{
  "height": enum (Media.Height),

  // Union field content can be only one of the following:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
ক্ষেত্র
height

enum ( Media.Height )

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

ইউনিয়ন ফিল্ডের content । মিডিয়া content নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
fileName
(deprecated)

string

ফাইলটি আপলোড করার সময় RCS for Business প্ল্যাটফর্ম দ্বারা ফেরত আসা ফাইলের অনন্য নাম। নিচে উল্লিখিত uploadedRbmFile-এর পক্ষে এটি বাতিল করা হয়েছে।

uploadedRbmFile

object ( UploadedRbmFile )

এতে একটি ফাইল এবং থাম্বনেইলের শনাক্তকারী রয়েছে, যা RCS for Business সার্ভারে আপলোড করা হয়েছিল এবং পরিবেশিত হয়েছিল।

contentInfo

object ( ContentInfo )

একটি ফাইল সম্পর্কিত তথ্য, যার মধ্যে ফাইলটির ইউআরএল এবং ফাইলটির থাম্বনেইলের ইউআরএল অন্তর্ভুক্ত।

RCS for Business প্ল্যাটফর্মটি একটি ক্যাশে থেকে কন্টেন্ট পরিবেশন করে, কিন্তু একজন এজেন্ট RCS for Business প্ল্যাটফর্মটিকে কন্টেন্টের একটি নতুন সংস্করণ আনতে এবং ক্যাশে রিফ্রেশ করতে বাধ্য করতে পারে।

বিষয়বস্তু তথ্য

বার্তা, যাতে বিষয়বস্তুর তথ্য রয়েছে।

JSON উপস্থাপনা 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}
ক্ষেত্র
fileUrl

string

ফাইলটির সর্বজনীনভাবে প্রবেশযোগ্য ইউআরএল। আরসিএস ফর বিজনেস প্ল্যাটফর্মটি যখন ফাইলটি ফেচ করে, তখন এটি এইচটিটিপি হেডারের কন্টেন্ট-টাইপ ফিল্ড থেকে ফাইলটির মাইম টাইপ (MIME type) নির্ধারণ করে। ইউআরএল থেকে প্রাপ্ত এইচটিটিপি রেসপন্সে কন্টেন্ট-টাইপ ফিল্ডটি অবশ্যই উপস্থিত এবং সঠিক থাকতে হবে। প্রস্তাবিত সর্বোচ্চ ফাইলের আকার ১০০ মেগাবাইট।

দ্রষ্টব্য: ফাইল ইউআরএল-এ রিডাইরেক্ট সমর্থিত নয়। রিডাইরেকশনের প্রয়োজন হলে অনুগ্রহ করে CreateFileRequest ব্যবহার করুন।

thumbnailUrl

string

(ঐচ্ছিক, শুধুমাত্র ছবি, অডিও এবং ভিডিও ফাইলের জন্য) থাম্বনেইলের সর্বজনীনভাবে প্রবেশযোগ্য ইউআরএল। সর্বোচ্চ আকার ১০০ কিলোবাইট।

আপনি যদি কোনো থাম্বনেইল ইউআরএল প্রদান না করেন, তাহলে ব্যবহারকারীর ডিভাইস ফাইলটি ডাউনলোড না করা পর্যন্ত RCS for Business প্ল্যাটফর্মটি একটি ফাঁকা প্লেসহোল্ডার থাম্বনেইল প্রদর্শন করে। ব্যবহারকারীর সেটিংসের ওপর নির্ভর করে, ফাইলটি স্বয়ংক্রিয়ভাবে ডাউনলোড নাও হতে পারে এবং সেক্ষেত্রে ব্যবহারকারীকে একটি ডাউনলোড বোতামে ট্যাপ করতে হতে পারে।

দ্রষ্টব্য: ফাইল ইউআরএল-এ রিডাইরেক্ট সমর্থিত নয়। রিডাইরেকশনের প্রয়োজন হলে অনুগ্রহ করে CreateFileRequest ব্যবহার করুন।

forceRefresh

boolean

সেট করা থাকলে, RCS for Business প্ল্যাটফর্মটি নির্দিষ্ট URL-গুলো থেকে ফাইল এবং থাম্বনেইল সংগ্রহ করে, এমনকি যদি প্ল্যাটফর্মটিতে ফাইলটির (এবং/অথবা থাম্বনেইলের) ক্যাশ করা কপি থাকেও।

মিডিয়া.উচ্চতা

মিডিয়া উচ্চতা

এনাম
HEIGHT_UNSPECIFIED নির্দিষ্ট করা হয়নি।
SHORT ১১২ ডিপি।
MEDIUM ১৬৮ ডিপি।
TALL ২৬৪ ডিপি।

পরামর্শ

একটি রিচ কার্ড বা সাজেশন চিপ তালিকার অন্তর্ভুক্ত একটি প্রস্তাবিত উত্তর বা প্রস্তাবিত পদক্ষেপ।

JSON উপস্থাপনা 
{
  "suggestionDisplay": enum (Suggestion.SuggestionDisplay),

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of list of possible types for union field option.
}
ক্ষেত্র
suggestionDisplay

enum ( Suggestion.SuggestionDisplay )

ঐচ্ছিক। সাজেশনের প্রদর্শনের আচরণ নিয়ন্ত্রণ করে। শুধুমাত্র গুগল মেসেজেস ক্লায়েন্টে (সংস্করণ 20260225.00 বা তার পরবর্তী) পাঠানো প্লেইন টেক্সট মেসেজের জন্য প্রযোজ্য। এই ফিল্ডটি শুধুমাত্র প্লেইন টেক্সট মেসেজের সাথে যুক্ত স্বতন্ত্র সাজেশনগুলিতে সেট করতে হবে। রিচ কার্ডের সাজেশনে বা ফাইল ট্রান্সফার সহ স্বতন্ত্র সাজেশনে এই ফিল্ডটি প্রয়োগ করা হলে সার্ভার মেসেজটি প্রত্যাখ্যান করবে। এই সেটিংটি শুধুমাত্র গুগল মেসেজেসের জন্য সিরিয়ালাইজড; অন্যান্য ক্লায়েন্ট (যেমন iOS বা Samsung) এটি উপেক্ষা করে।

ইউনিয়ন ফিল্ড option । একটি প্রস্তাবিত উত্তর বা একটি প্রস্তাবিত পদক্ষেপ। option নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
reply

object ( SuggestedReply )

ব্যবহারকারীরা প্রস্তাবিত উত্তরে ট্যাপ করে সেই টেক্সট উত্তরটি এজেন্টের কাছে ফেরত পাঠাতে পারেন।

action

object ( SuggestedAction )

ব্যবহারকারীরা কোনো প্রস্তাবিত অ্যাকশনে ট্যাপ করে ডিভাইসে সংশ্লিষ্ট নেটিভ অ্যাকশনটি চালু করতে পারেন।

প্রস্তাবিত উত্তর

ট্যাপ করলে, টেক্সট উত্তরটি এজেন্টের কাছে ফেরত পাঠানো হয়।

JSON উপস্থাপনা 
{
  "text": string,
  "postbackData": string
}
ক্ষেত্র
text

string

প্রস্তাবিত উত্তরে যে লেখাটি দেখানো হয় এবং ব্যবহারকারী ট্যাপ করলে এজেন্টের কাছে ফেরত পাঠানো হয়। সর্বোচ্চ ২৫ অক্ষর।

postbackData

string

ব্যবহারকারী যখন প্রস্তাবিত উত্তরে ট্যাপ করেন, তখন ইউজার ইভেন্টে এজেন্ট যে বেস৬৪-এনকোডেড পেলোডটি পায়।

প্রস্তাবিত পদক্ষেপ

ট্যাপ করলে, ডিভাইসে সংশ্লিষ্ট নেটিভ অ্যাকশনটি চালু হয়।

JSON উপস্থাপনা 
{
  "text": string,
  "postbackData": string,
  "fallbackUrl": string,

  // Union field action can be only one of the following:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of list of possible types for union field action.
}
ক্ষেত্র
text

string

প্রস্তাবিত কার্যক্রমে প্রদর্শিত লেখা। সর্বোচ্চ ২৫ অক্ষর।

postbackData

string

ব্যবহারকারী প্রস্তাবিত অ্যাকশনটিতে ট্যাপ করলে যে ইউজার ইভেন্টটি ঘটে, সেই ইভেন্টে এজেন্টের কাছে পাঠানো পেলোড (বেস৬৪ এনকোডেড)। সর্বোচ্চ ২০৪৮ অক্ষর।

fallbackUrl

string

(ঐচ্ছিক) কোনো ক্লায়েন্ট প্রস্তাবিত পদক্ষেপ সমর্থন না করলে ব্যবহারের জন্য ফলব্যাক ইউআরএল। ফলব্যাক ইউআরএলগুলো নতুন ব্রাউজার উইন্ডোতে খোলে। এটি অবশ্যই RFC 3986-এ সংজ্ঞায়িত একটি বৈধ ইউআরআই হতে হবে। সর্বোচ্চ ২০৪৮ অক্ষর।

ইউনিয়ন ফিল্ড action । ব্যবহারকারী প্রস্তাবিত অ্যাকশনটিতে ট্যাপ করলে ডিভাইসে যে নেটিভ অ্যাকশনটি শুরু হয়। action নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
dialAction

object ( DialAction )

এজেন্টের নির্দিষ্ট করা ফোন নম্বরটি পূরণ করা অবস্থায় ব্যবহারকারীর ডিফল্ট ডায়ালার অ্যাপটি খোলে।

viewLocationAction

object ( ViewLocationAction )

ব্যবহারকারীর ডিফল্ট ম্যাপ অ্যাপটি খোলে এবং এজেন্ট-নির্দিষ্ট অবস্থান নির্বাচন করে, অথবা এজেন্ট-নির্দিষ্ট কোয়েরি অনুযায়ী ব্যবহারকারীর অবস্থানের আশেপাশে অনুসন্ধান করে।

createCalendarEventAction

object ( CreateCalendarEventAction )

ব্যবহারকারীর ডিফল্ট ক্যালেন্ডার অ্যাপটি খোলে এবং এজেন্ট-নির্দিষ্ট ইভেন্টের তথ্য আগে থেকে পূরণ করা অবস্থায় নতুন ক্যালেন্ডার ইভেন্ট প্রবাহ শুরু করে।

openUrlAction

object ( OpenUrlAction )

ব্যবহারকারীর ডিফল্ট ওয়েব ব্রাউজার অ্যাপটি প্রদত্ত ইউআরএল-এ খোলে। যদি ব্যবহারকারীর এমন কোনো অ্যাপ ইনস্টল করা থাকে যা ইউআরএলটির ডিফল্ট হ্যান্ডলার হিসেবে নিবন্ধিত, তাহলে তার পরিবর্তে সেই অ্যাপটিই খোলা হবে এবং সাজেস্টেড অ্যাকশন ইউআই-তে এর আইকনটি ব্যবহার করা হবে।

shareLocationAction

object ( ShareLocationAction )

RCS অ্যাপের লোকেশন চুজারটি খোলে, যাতে ব্যবহারকারী এজেন্টের কাছে পাঠানোর জন্য একটি লোকেশন বেছে নিতে পারেন।

ডায়ালঅ্যাকশন

এজেন্টের নির্দিষ্ট করা ফোন নম্বরটি পূরণ করা অবস্থায় ব্যবহারকারীর ডিফল্ট ডায়ালার অ্যাপটি খোলে।

JSON উপস্থাপনা 
{
  "phoneNumber": string
}
ক্ষেত্র
phoneNumber

string

ফোন নম্বরটি E.164 ফরম্যাটে, যেমন, +12223334444।

অবস্থান দেখুন অ্যাকশন

ব্যবহারকারীর ডিফল্ট ম্যাপ অ্যাপটি খোলে এবং এজেন্ট-নির্দিষ্ট অবস্থান নির্বাচন করে, অথবা এজেন্ট-নির্দিষ্ট কোয়েরি অনুযায়ী ব্যবহারকারীর অবস্থানের আশেপাশে অনুসন্ধান করে।

JSON উপস্থাপনা 
{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}
ক্ষেত্র
latLong

object ( LatLng )

(ঐচ্ছিক) নির্দিষ্ট স্থানটির অক্ষাংশ ও দ্রাঘিমাংশ।

label

string

(ঐচ্ছিক) অক্ষাংশ ও দ্রাঘিমাংশে (latLong) ফেলা পিনটির লেবেল।

query

string

(ঐচ্ছিক, শুধুমাত্র অ্যান্ড্রয়েড মেসেজেস ক্লায়েন্টে সমর্থিত) অক্ষাংশ-দ্রাঘিমাংশ (এবং ঐচ্ছিকভাবে, একটি লেবেল) উল্লেখ করার পরিবর্তে, এজেন্ট একটি কোয়েরি স্ট্রিং উল্লেখ করতে পারেন। সার্চ কার্যকারিতা সমর্থনকারী ডিফল্ট ম্যাপ অ্যাপগুলির (গুগল ম্যাপস সহ) জন্য, এই প্রস্তাবিত অ্যাকশনটিতে ট্যাপ করলে ব্যবহারকারীর বর্তমান অবস্থানকে কেন্দ্র করে একটি লোকেশন সার্চ শুরু হয়। যদি কোয়েরিটি যথেষ্ট সুনির্দিষ্ট হয়, তবে এজেন্টরা এটি ব্যবহার করে বিশ্বের যেকোনো স্থান নির্বাচন করতে পারেন।

উদাহরণস্বরূপ, কোয়েরি স্ট্রিং "Growing Tree Bank" এ সেট করলে ব্যবহারকারীর আশেপাশের সমস্ত Growing Tree Bank-এর শাখা দেখানো হবে। কোয়েরি স্ট্রিং "1600 Amphitheater Parkway, Mountain View, CA 94043" এ সেট করলে ব্যবহারকারীর অবস্থান নির্বিশেষে সেই নির্দিষ্ট ঠিকানাটি নির্বাচিত হবে।

অক্ষাংশ দ্রাঘিমাংশ

একটি অবজেক্ট যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়াকে উপস্থাপন করে। এটি ডিগ্রি অক্ষাংশ এবং ডিগ্রি দ্রাঘিমাংশ বোঝাতে একজোড়া ডাবল (double) হিসেবে প্রকাশ করা হয়। অন্যভাবে নির্দিষ্ট করা না থাকলে, এই অবজেক্টটিকে অবশ্যই WGS84 স্ট্যান্ডার্ড মেনে চলতে হবে। মানগুলো অবশ্যই নর্মালাইজড রেঞ্জের মধ্যে থাকতে হবে।

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

অক্ষাংশ ডিগ্রিতে। এটি অবশ্যই [-90.0, +90.0] সীমার মধ্যে হতে হবে।

longitude

number

দ্রাঘিমাংশ ডিগ্রিতে। এটি অবশ্যই [-180.0, +180.0] সীমার মধ্যে হতে হবে।

ক্যালেন্ডার ইভেন্ট তৈরি করুন

ব্যবহারকারীর ডিফল্ট ক্যালেন্ডার অ্যাপটি খোলে এবং এজেন্ট-নির্দিষ্ট ইভেন্টের তথ্য আগে থেকে পূরণ করা অবস্থায় নতুন ক্যালেন্ডার ইভেন্ট প্রবাহ শুরু করে।

JSON উপস্থাপনা 
{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}
ক্ষেত্র
startTime

string ( Timestamp format)

অনুষ্ঠান শুরুর সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

endTime

string ( Timestamp format)

অনুষ্ঠান শেষ হওয়ার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

title

string

অনুষ্ঠানের শিরোনাম। সর্বোচ্চ ১০০ অক্ষর।

description

string

অনুষ্ঠানের বিবরণ। সর্বোচ্চ ৫০০ অক্ষর।

ওপেনইউআরএলঅ্যাকশন

ব্যবহারকারীর ডিফল্ট ওয়েব ব্রাউজার অ্যাপটি নির্দিষ্ট URL-এ খোলে। যদি ব্যবহারকারীর এমন কোনো অ্যাপ ইনস্টল করা থাকে যা URL-টির ডিফল্ট হ্যান্ডলার হিসেবে নিবন্ধিত, তাহলে তার পরিবর্তে সেই অ্যাপটিই খোলা হবে এবং প্রস্তাবিত অ্যাকশন UI-তে এর আইকনটি ব্যবহার করা হবে।

JSON উপস্থাপনা 
{
  "url": string,
  "application": enum (OpenUrlApplication),
  "webviewViewMode": enum (WebviewViewMode),
  "description": string
}
ক্ষেত্র
url

string

খোলার জন্য ইউআরএল। ১ নভেম্বর, ২০২৫ থেকে কার্যকর, ইউআরএল স্কিম অবশ্যই https:// অথবা http:// হতে হবে। এই তারিখের পর অন্য কোনো স্কিম (যেমন, tel:, mailto:, sms:) ব্যবহার করে করা এপিআই অনুরোধ 400 Bad Request ত্রুটি সহ প্রত্যাখ্যান করা হবে। ইউআরএলটি অবশ্যই RFC 3986-এ সংজ্ঞায়িত একটি বৈধ URI হতে হবে। সর্বোচ্চ ২০৪৮ অক্ষর।

application

enum ( OpenUrlApplication )

URL অ্যাপ্লিকেশন, ব্রাউজার বা ওয়েবভিউ খোলে। ব্যবহারকারীর ডিভাইস ওয়েবভিউ মোড সমর্থন করে কিনা তা পরীক্ষা করতে, প্রথমে একটি ক্যাপাবিলিটি চেক চালান। বিস্তারিত জানতে ডকুমেন্টেশন দেখুন: https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities ।

webviewViewMode

enum ( WebviewViewMode )

ওয়েবভিউয়ের জন্য ভিউ মোড।

description

string

ওয়েবভিউ-এর জন্য প্রবেশগম্যতা বিবরণ।

ওপেনইউআরএলঅ্যাপ্লিকেশন

URL-এর ধরণ অ্যাপ্লিকেশন খুলুন

এনাম
OPEN_URL_APPLICATION_UNSPECIFIED নির্দিষ্ট করা নেই, ব্রাউজার ব্যবহার করে খোলা হবে।
BROWSER ব্রাউজার ব্যবহার করে ইউআরএলটি খুলুন।
WEBVIEW ইন্টিগ্রেটেড ওয়েব ভিউ উইন্ডোতে URL খুলুন

ওয়েবভিউভিউমোড

ওয়েবভিউ-এর ভিউ মোডের ধরণ।

এনাম
WEBVIEW_VIEW_MODE_UNSPECIFIED নির্দিষ্ট করা হয়নি। ওয়েবভিউ ব্যবহার করতে হলে একটি ভিউ মোড নির্দিষ্ট করতে হবে।
FULL এর জন্য একটি পূর্ণ স্ক্রিন ওভারলে প্রয়োজন, যেখানে স্ট্যাটাস বারে চ্যাটবট কথোপকথনটি লেবেল করা থাকবে।
HALF অর্ধ-পর্দা ওভারলে প্রয়োজন।
TALL এর জন্য স্ক্রিনের তিন-চতুর্থাংশ জুড়ে একটি ওভারলে প্রয়োজন।

শেয়ারলোকেশনঅ্যাকশন

এই প্রকারে কোনো ক্ষেত্র নেই।

RCS অ্যাপের লোকেশন চুজারের অপশনটি খোলে, যাতে ব্যবহারকারী এজেন্টের কাছে ফেরত পাঠানোর জন্য একটি লোকেশন বেছে নিতে পারেন।

পরামর্শ।পরামর্শপ্রদর্শন

স্বতন্ত্র টেক্সট সাজেশনের প্রদর্শন আচরণ।

এনাম
SUGGESTION_DISPLAY_UNSPECIFIED

ক্লায়েন্টরা ডিফল্ট প্রদর্শন আচরণ কার্যকর করে:

  • স্বতন্ত্র সাধারণ টেক্সট মেসেজের জন্য গুগল মেসেজেস: নতুন মেসেজ পাঠানো বা গ্রহণ করার পর সাজেশনগুলো অদৃশ্য হয়ে যায়।
  • স্বতন্ত্র সাধারণ টেক্সট মেসেজের জন্য iOS: সাজেশনগুলো ব্যবহারকারী ট্যাপ করার পরেই কেবল অদৃশ্য হয়ে যায়।
  • রিচ কার্ডের সকল ক্লায়েন্টের জন্য: সাজেশনগুলো সর্বদা স্থায়ী থাকে; রিচ কার্ডে suggestionDisplay সেট করলে একটি 400 এরর দেখা দেবে।
PERSISTENT কথোপকথনে নতুন বার্তা যুক্ত হলেও, সাজেশনটি মেসেজ বাবলের মধ্যে ক্রমাগত দৃশ্যমান থাকে।

স্বতন্ত্র কার্ড

স্বতন্ত্র কার্ড

JSON উপস্থাপনা 
{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}
ক্ষেত্র
cardOrientation

enum ( StandaloneCard.CardOrientation )

কার্ডটির অভিমুখ।

thumbnailImageAlignment

enum ( StandaloneCard.ThumbnailImageAlignment )

অনুভূমিক লেআউটে স্বতন্ত্র কার্ডের জন্য ছবির প্রিভিউ অ্যালাইনমেন্ট।

cardContent

object ( CardContent )

কার্ডের বিষয়বস্তু।

স্বতন্ত্র কার্ড। কার্ড ওরিয়েন্টেশন

কার্ডটির অভিমুখ।

এনাম
CARD_ORIENTATION_UNSPECIFIED নির্দিষ্ট করা হয়নি।
HORIZONTAL

অনুভূমিক বিন্যাস।

যদি একটি হরাইজন্টাল রিচ কার্ডের object( CardContent ) media ফিল্ড থাকে, তবে তাতে অবশ্যই অন্তত একটি title , description বা suggestions[] ফিল্ডও অন্তর্ভুক্ত থাকতে হবে।

VERTICAL উল্লম্ব বিন্যাস।

StandaloneCard.ThumbnailImageAlignment

অনুভূমিক লেআউটে স্বতন্ত্র কার্ডের জন্য ছবির প্রিভিউ অ্যালাইনমেন্ট।

এনাম
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED নির্দিষ্ট করা হয়নি।
LEFT ফাইল প্রিভিউটি বাম-সারিবদ্ধ।
RIGHT ফাইল প্রিভিউটি ডানদিকে সারিবদ্ধ।

মেসেজট্র্যাফিকটাইপ

সমর্থিত মেসেজ ট্র্যাফিকের প্রকারভেদ। অতিরিক্ত ট্র্যাফিকের প্রকারভেদ সমর্থন করার জন্য এনামটি সম্প্রসারিত করা হবে।

এনাম
MESSAGE_TRAFFIC_TYPE_UNSPECIFIED ডিফল্ট আচরণ: এজেন্টের ব্যবহারের ক্ষেত্র অনুযায়ী মেসেজ ট্র্যাফিকের ধরন নির্ধারিত হয়। মেসেজের বিষয়বস্তু অনুসারে প্রয়োজন অনুযায়ী ট্র্যাফিকের ধরন আপডেট করুন। একাধিক ব্যবহারের এজেন্টের জন্য কোনো ডিফল্ট ব্যবস্থা নেই। ট্র্যাফিকের ধরন ম্যানুয়ালি সেট করতে হবে (যেমন, ট্রানজ্যাকশন, প্রোমোশন)।
AUTHENTICATION ওটিপি এজেন্ট ব্যবহারের ক্ষেত্রে প্রমাণীকরণ বার্তাগুলির জন্য।
TRANSACTION ট্রানজ্যাকশনাল বা মাল্টি-ইউজ এজেন্ট ব্যবহারের ক্ষেত্রে ট্রানজ্যাকশনাল মেসেজগুলির জন্য।
PROMOTION প্রচারমূলক বা বহুমুখী এজেন্ট ব্যবহারের ক্ষেত্রে প্রচারমূলক বার্তাগুলির জন্য।
SERVICEREQUEST যেসব পরিষেবা গ্রহণ করতে ব্যবহারকারী সম্মতি দিয়েছেন, সে সম্পর্কিত বার্তার জন্য। এটি ওটিপি, লেনদেনমূলক, প্রচারমূলক, বা বহুমুখী এজেন্ট ব্যবহারের ক্ষেত্রে ব্যবহৃত হয়।
ACKNOWLEDGEMENT ব্যবহারকারীর আনসাবস্ক্রাইব অনুরোধ স্বীকার করে পাঠানো বার্তাগুলির জন্য। এটি ওটিপি, ট্রানজ্যাকশনাল, প্রোমোশনাল বা মাল্টি-ইউজ এজেন্ট ব্যবহারের ক্ষেত্রে ব্যবহৃত হয়।

রিচমেসেজক্লাসিফিকেশন

শুধুমাত্র মার্কিন যুক্তরাষ্ট্রের বিলিংয়ের জন্য: বিলিংয়ের জন্য ব্যবহৃত বার্তার শ্রেণিবিভাগ সম্পর্কিত বিবরণ।

JSON উপস্থাপনা 
{
  "classificationType": enum (RichMessageClassificationType),
  "segmentCount": integer
}
ক্ষেত্র
classificationType

enum ( RichMessageClassificationType )

segmentCount

integer

বার্তার পাঠ্যের জন্য ১৬০-বাইট খণ্ডের সংখ্যা, যা সর্বদা ঊর্ধ্বসীমায় পূর্ণসংখ্যায় রূপান্তরিত হয়।

শুধুমাত্র টেক্সট কন্টেন্টের মোট UTF-8 বাইট দৈর্ঘ্যের ভিত্তিতে গণনা করা হয়েছে; প্রস্তাবিত উত্তর বা পদক্ষেপের ডেটা বাদ দেওয়া হয়েছে।

উদাহরণস্বরূপ, ৩০০ বাইট দীর্ঘ একটি টেক্সট মেসেজের segmentCount হলো ২।

এই ফিল্ডটি শুধুমাত্র RICH_MESSAGE টাইপের জন্য পূরণ করা হয়।

রিচমেসেজক্লাসিফিকেশনটাইপ

শুধুমাত্র মার্কিন বিলিংয়ের জন্য: বিলিংয়ের উদ্দেশ্যে বার্তাটির শ্রেণিবিভাগ নির্দিষ্ট করে।

গুরুত্বপূর্ণ: এই পৃষ্ঠায় বর্ণিত বিলযোগ্য মেসেজ প্রকারগুলির মূল্য মার্কিন ক্যারিয়ারগুলি নির্ধারণ করে। মার্কিন ক্যারিয়ারগুলি RCS for Business মেসেজ পাঠানোর জন্য ডেভেলপারের চূড়ান্ত চার্জও নির্ধারণ করে। অতিরিক্ত মূল্য বা বিলিং তথ্যের জন্য, অনুগ্রহ করে সংশ্লিষ্ট ক্যারিয়ার প্রতিনিধিদের সাথে যোগাযোগ করুন।

এনাম
RICH_MESSAGE_CLASSIFICATION_TYPE_UNSPECIFIED নির্দিষ্ট করা হয়নি
RICH_MESSAGE নিম্নলিখিত শর্তগুলো পূরণ হলে একটি মেসেজকে রিচ (RICH) হিসেবে শ্রেণীবদ্ধ করা হয়: ১. এতে কোনো রিচ কার্ড থাকে না। ২. এতে কোনো ফাইল অ্যাটাচমেন্ট থাকে না। ৩. এতে থাকা যেকোনো প্রস্তাবিত অ্যাকশন অবশ্যই একটি ডায়াল অ্যাকশন অথবা একটি ওপেন ইউআরএল অ্যাকশন হতে হবে, যা কোনো ওয়েবভিউ ব্যবহার করে না।
RICH_MEDIA_MESSAGE যে কোনো বার্তা যা RICH_MESSAGE শর্ত পূরণ করে না। এর মধ্যে সেইসব বার্তা অন্তর্ভুক্ত, যেগুলিতে রিচ কার্ড, মিডিয়া ফাইল, অথবা 'ডায়াল' বা 'ব্রাউজারে ইউআরএল খুলুন' ছাড়া অন্য কোনো প্রস্তাবিত পদক্ষেপ থাকে।
SUGGESTED_ACTION_CLICK এটি ব্যবহারকারীর কোনো প্রস্তাবিত কাজে (প্রস্তাবিত উত্তর নয়) ট্যাপ করাকে বোঝায়। এই শ্রেণিবিভাগটি শুধুমাত্র ব্যবহারকারীর কার্যকলাপের ক্ষেত্রে প্রযোজ্য এবং এটি কেবলমাত্র একটি ওয়েবহুকের UserMessage পেলোডে প্রদর্শিত হয়। এটি A2P মেসেজের ক্ষেত্রে প্রযোজ্য নয়।

পদ্ধতি

create

 এজেন্টের পক্ষ থেকে একজন ব্যবহারকারীর কাছে একটি বার্তা পাঠানো হয়।

delete

 প্রেরিত কিন্তু এখনো বিতরণ হয়নি এমন এজেন্ট বার্তা প্রত্যাহার করে।