REST Resource: conversations.messages

সম্পদ: বার্তা

একজন এজেন্ট এবং একজন ব্যবহারকারীর মধ্যে কথোপকথনের একটি বার্তা।

JSON প্রতিনিধিত্ব
{
  "name": string,
  "messageId": string,
  "representative": {
    object (Representative)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "fallback": string,
  "containsRichText": boolean,

  // Union field content can be only one of the following:
  "text": string,
  "image": {
    object (Image)
  },
  "richCard": {
    object (RichCard)
  }
  // End of list of possible types for union field content.
}
ক্ষেত্র
name

string

ব্যবসা বার্তা দ্বারা সেট করা বার্তার নাম। "কথোপকথন/{conversationId}/messages/{messageId}" এর সমাধান করে, যেখানে {conversationId} হল কথোপকথনের অনন্য আইডি এবং {messageId} হল মেসেজের অনন্য আইডি৷

messageId

string

প্রয়োজন। বার্তাটির অনন্য শনাক্তকারী, এজেন্ট দ্বারা নির্ধারিত। যদি কোনো বার্তা পূর্ববর্তী বার্তার মতো একই messageId ব্যবহার করার চেষ্টা করে, তাহলে বার্তাটির সঠিক বিতরণ প্রভাবিত হতে পারে।

representative

object ( Representative )

যে প্রতিনিধি (মানব বা চ্যাটবট) বার্তাটি পাঠিয়েছেন তার সম্পর্কে বিশদ বিবরণ।

suggestions[]

object ( Suggestion )

প্রস্তাবিত উত্তরগুলির একটি তালিকা যা সংশ্লিষ্ট বার্তার পরে পরামর্শ চিপগুলির একটি তালিকা হিসাবে প্রদর্শিত হয়৷ সর্বাধিক 13 টি পরামর্শ।

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

fallback

string

ঐচ্ছিক। ফলব্যাক পাঠ্য যা প্রদর্শন করে যদি ব্যবহারকারীর ডিভাইস বার্তার ধরন বা বিষয়বস্তু সমর্থন না করে। সর্বোচ্চ ৩,০৭২টি অক্ষর।

containsRichText

boolean

ঐচ্ছিক। true হলে, নির্দেশ করে যে বার্তাটিতে সমৃদ্ধ পাঠ্য রয়েছে। যদি বার্তাটিতে অবৈধ বিন্যাস থাকে, ব্যবসা বার্তা একটি ত্রুটি প্রদান করে।

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

string

পাঠ্য বার্তা। সর্বোচ্চ ৩,০৭২টি অক্ষর।

image

object ( Image )

চিত্র বার্তা।

richCard

object ( RichCard )

রিচ কার্ড বার্তা।

ছবি

একটি ছবি।

JSON প্রতিনিধিত্ব
{

  // Union field content can be only one of the following:
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্রের content । ছবির বিষয়বস্তু। content নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
contentInfo

object ( ContentInfo )

ছবির URL এবং ছবির থাম্বনেইলের URL সহ একটি চিত্র সম্পর্কে তথ্য৷

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

বিষয়বস্তু তথ্য ধারণকারী বার্তা.

JSON প্রতিনিধিত্ব
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean,
  "altText": string
}
ক্ষেত্র
fileUrl

string

ফাইলের সর্বজনীনভাবে পৌঁছানো যায় এমন URL। যখন প্ল্যাটফর্ম ফাইলটি নিয়ে আসে তখন প্ল্যাটফর্ম HTTP শিরোলেখের সামগ্রী-টাইপ ক্ষেত্র থেকে ফাইলের MIME প্রকার নির্ধারণ করে। কন্টেন্ট-টাইপ ক্ষেত্রটি অবশ্যই URL থেকে HTTP প্রতিক্রিয়াতে উপস্থিত এবং সঠিক হতে হবে।

সর্বোচ্চ ৫ এমবি।

সমর্থিত বিষয়বস্তুর প্রকার: image/jpeg, image/jpg, image/png, image/webp

thumbnailUrl

string

ঐচ্ছিক। থাম্বনেইলের সর্বজনীনভাবে পৌঁছানো যায় এমন URL।

আপনি একটি থাম্বনেইল URL প্রদান না করলে, ব্যবহারকারীর ডিভাইস ফাইলটি ডাউনলোড না করা পর্যন্ত প্ল্যাটফর্মটি একটি ফাঁকা স্থানধারক থাম্বনেইল প্রদর্শন করে।

সর্বোচ্চ 25 KB।

সমর্থিত বিষয়বস্তুর প্রকার: image/jpeg, image/jpg, image/png, image/webp

forceRefresh

boolean

সেট করা থাকলে, প্ল্যাটফর্মটি নির্দিষ্ট ইউআরএল থেকে ফাইল এবং থাম্বনেইল নিয়ে আসে, এমনকি যদি প্ল্যাটফর্মে ফাইলের (এবং/অথবা থাম্বনেইলের) কপি ক্যাশ করা থাকে।

altText

string

অ্যাক্সেসযোগ্যতার উদ্দেশ্যে মিডিয়া সম্পর্কে বিশদ বিবরণ বর্ণনা করে পাঠ্য।

রিচকার্ড

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

JSON প্রতিনিধিত্ব
{

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

object ( StandaloneCard )

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

carouselCard

object ( CarouselCard )

তাসের ক্যারোজেল।

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

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

JSON প্রতিনিধিত্ব
{
  "cardContent": {
    object (CardContent)
  }
}
ক্ষেত্র
cardContent

object ( CardContent )

কার্ড সামগ্রী।

কার্ড সামগ্রী

কার্ড সামগ্রী।

JSON প্রতিনিধিত্ব
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
ক্ষেত্র
title

string

ঐচ্ছিক। কার্ডের শিরোনাম। সর্বাধিক 200টি অক্ষর।

description

string

ঐচ্ছিক। কার্ডের বর্ণনা। সর্বাধিক 2,000 অক্ষর।

media

object ( Media )

ঐচ্ছিক। কার্ড অন্তর্ভুক্ত মিডিয়া.

suggestions[]

object ( Suggestion )

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

মিডিয়া

একটি সমৃদ্ধ কার্ডের মধ্যে একটি মিডিয়া ফাইল।

JSON প্রতিনিধিত্ব
{
  "height": enum (Height),

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

enum ( Height )

একটি সমৃদ্ধ কার্ডের মধ্যে মিডিয়ার উচ্চতা।

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

object ( ContentInfo )

ফাইলের URL এবং ফাইলের থাম্বনেইলের URL সহ একটি ফাইল সম্পর্কে তথ্য৷

উচ্চতা

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

Enums
HEIGHT_UNSPECIFIED উল্লেখ করা হয়নি।
SHORT 112 ডিপি।
MEDIUM 168 ডিপি।
TALL 264 ডিপি। কার্ডের প্রস্থ SMALL এ সেট করা থাকলে রিচ কার্ড ক্যারোসেলের জন্য উপলব্ধ নয়৷

সাজেশন

একটি চিপ তালিকার মধ্যে একটি পরামর্শ.

JSON প্রতিনিধিত্ব
{

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  },
  "liveAgentRequest": {
    object (LiveAgentRequest)
  },
  "authenticationRequest": {
    object (AuthenticationRequest)
  }
  // End of list of possible types for union field option.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্রের option । একটি প্রস্তাবিত উত্তর. option নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
reply

object ( SuggestedReply )

ব্যবহারকারীকে নির্দিষ্ট পাঠ্য সহ উত্তর দেওয়ার জন্য একটি পরামর্শ৷

action

object ( SuggestedAction )

একটি প্রস্তাবিত ক্রিয়া যা ডিভাইসে একটি নেটিভ অ্যাকশন শুরু করে৷

liveAgentRequest

object ( LiveAgentRequest )

একটি লাইভ এজেন্ট কথোপকথনে যোগদান করার জন্য একটি অনুরোধ.

authenticationRequest

object ( AuthenticationRequest )

প্রমাণীকরণ প্রবাহ শুরু করার জন্য একটি অনুরোধ৷

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

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

JSON প্রতিনিধিত্ব
{
  "text": string,
  "postbackData": string
}
ক্ষেত্র
text

string

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

postbackData

string

একজন ব্যবহারকারী প্রস্তাবিত উত্তরে ট্যাপ করলে এজেন্ট যে স্ট্রিংটি পায়। সর্বাধিক 2,048 অক্ষর।

প্রস্তাবিত কর্ম

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

JSON প্রতিনিধিত্ব
{
  "text": string,
  "postbackData": string,

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

string

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

postbackData

string

একজন ব্যবহারকারী প্রস্তাবিত অ্যাকশনে ট্যাপ করলে এজেন্ট যে স্ট্রিংটি পায়। সর্বাধিক 2,048 অক্ষর।

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

object ( OpenUrlAction )

নির্দিষ্ট URL খোলে।

dialAction

object ( DialAction )

ব্যবহারকারীর ডিফল্ট ডায়ালার অ্যাপ খোলে।

OpenUrlAction

নির্দিষ্ট URL খোলে।

JSON প্রতিনিধিত্ব
{
  "url": string
}
ক্ষেত্র
url

string

URL

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

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

JSON প্রতিনিধিত্ব
{
  "phoneNumber": string
}
ক্ষেত্র
phoneNumber

string

প্রয়োজন। RFC 3966 ফর্ম্যাটে নির্দিষ্ট ফোন নম্বর। উদাহরণস্বরূপ, "+1-201-555-0123"।

LiveAgent অনুরোধ

এই ধরনের কোন ক্ষেত্র আছে.

ট্যাপ করা হলে, কথোপকথনে যোগদানের জন্য একটি লাইভ এজেন্টের জন্য একটি অনুরোধ পাঠায়।

প্রমাণীকরণের অনুরোধ

একটি কথোপকথন প্রমাণীকরণের জন্য অনুরোধ.

JSON প্রতিনিধিত্ব
{

  // Union field authentication_type can be only one of the following:
  "oauth": {
    object (Oauth)
  }
  // End of list of possible types for union field authentication_type.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্র authentication_type । প্রমাণীকরণের ধরন। authentication_type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
oauth

object ( Oauth )

OAuth এর মাধ্যমে প্রমাণীকরণের জন্য বিশদ বিবরণ।

ওউথ

OAuth এর মাধ্যমে প্রমাণীকরণের জন্য বিশদ বিবরণ।

JSON প্রতিনিধিত্ব
{
  "clientId": string,
  "codeChallenge": string,
  "scopes": [
    string
  ],
  "codeChallengeMethod": string
}
ক্ষেত্র
clientId

string

প্রয়োজন। আবেদনের আইডি যা অনুমোদনের জন্য জিজ্ঞাসা করে।

codeChallenge

string

প্রয়োজন। অ্যাক্সেস টোকেন বিনিময় করতে ব্যবহৃত কোড চ্যালেঞ্জ

scopes[]

string

প্রয়োজন। একটি অ্যারে যা অনুরোধের সুযোগ নির্দিষ্ট করে।

codeChallengeMethod

string

ঐচ্ছিক। কোড চ্যালেঞ্জ তৈরি করতে ব্যবহৃত কোড চ্যালেঞ্জ পদ্ধতি । যদি এই প্যারামিটারটি বাদ দেওয়া হয়, সার্ভারটি plain ধরে নেয়।

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

তাসের ক্যারোজেল।

JSON প্রতিনিধিত্ব
{
  "cardWidth": enum (CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
ক্ষেত্র
cardWidth

enum ( CardWidth )

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

cardContents[]

object ( CardContent )

ক্যারোজেলের প্রতিটি কার্ডের জন্য বিষয়বস্তুর তালিকা। একটি ক্যারোজেলে সর্বনিম্ন 2টি কার্ড এবং সর্বোচ্চ 10টি কার্ড থাকতে পারে৷

কার্ড প্রস্থ

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

Enums
CARD_WIDTH_UNSPECIFIED উল্লেখ করা হয়নি
SMALL 136 ডিপি। লম্বা মিডিয়া অন্তর্ভুক্ত করা যাবে না.
MEDIUM 280 ডিপি।

পদ্ধতি

create

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

updateReceipt

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