বার্তাগুলো প্রেরণ কর

RBM এজেন্টরা বার্তা পাঠিয়ে এবং গ্রহণ করার মাধ্যমে ব্যবহারকারীদের সাথে যোগাযোগ করে। ব্যবহারকারীদের কাছে বার্তা পাঠাতে, আপনার এজেন্ট RCS বিজনেস মেসেজিং API-এ বার্তার অনুরোধ পাঠায়। একটি একক অনুরোধে পাঠ্য, একটি সমৃদ্ধ কার্ড, একটি চিত্র বা একটি ভিডিওর পাশাপাশি প্রস্তাবিত উত্তর এবং প্রস্তাবিত পদক্ষেপগুলি অন্তর্ভুক্ত থাকতে পারে।

আপনি যদি এমন একজন ব্যবহারকারীকে একটি বার্তা পাঠান যার ডিভাইস RCS সমর্থন করে না বা RCS সক্ষম না থাকে, তাহলে RBM প্ল্যাটফর্ম একটি 404 ত্রুটি প্রদান করে। এই ক্ষেত্রে, আপনি আপনার পরিকাঠামোতে সংজ্ঞায়িত ফলব্যাক পদ্ধতির মাধ্যমে ব্যবহারকারীর কাছে পৌঁছানোর চেষ্টা করতে পারেন।

আপনি যদি এমন কোনও নেটওয়ার্কে কোনও RCS ব্যবহারকারীকে একটি বার্তা পাঠান যেখানে আপনার এজেন্ট এখনও চালু হয়নি, বা এমন কোনও নেটওয়ার্কে যা RCS ট্র্যাফিক সক্ষম করেনি, তাহলে RBM প্ল্যাটফর্ম একটি 403 ত্রুটি প্রদান করে।

আপনি যদি ব্যবহারকারীর ডিভাইস সমর্থন করে না এমন বৈশিষ্ট্য সহ একটি বার্তা পাঠান, তাহলে RBM প্ল্যাটফর্ম একটি ত্রুটি ফেরত দেয় এবং আপনার বার্তা সরবরাহ করে না।

আপনার মাল্টি-চ্যানেল মেসেজিং কৌশলের অংশ হিসেবে, যুক্তিসঙ্গত সময়ের পরে যে বার্তাগুলি বিতরণ করা হয় না সেগুলি প্রত্যাহার করা এবং একটি ভিন্ন চ্যানেলের মাধ্যমে প্রেরণ করা ভাল৷ একটি পূর্বনির্ধারিত সময়ে স্বয়ংক্রিয়ভাবে বার্তাগুলি প্রত্যাহার করতে, একটি বার্তার মেয়াদ নির্ধারণ করুন৷

প্রাপক অফলাইন

প্রাপক অফলাইনে থাকলে RBM প্ল্যাটফর্ম এখনও ডেলিভারির জন্য একটি বার্তা গ্রহণ করে। আপনি একটি 200 ওকে প্রতিক্রিয়া পাবেন এবং RBM প্ল্যাটফর্ম বার্তাটি ধারণ করে এবং 30 দিনের জন্য পুনরায় বিতরণ করার চেষ্টা করে। RBM কে আবার মেসেজ পাঠাতে বলার দরকার নেই।

RBM যেকোনও ডেলিভার না করা মেসেজ জমা দেওয়ার 30 দিন পরে মুছে দেয়।

আপনার এজেন্টের ব্যবহারের ক্ষেত্রে নির্ভর করে, আপনি এই 30-দিনের সময়সীমার আগে একটি অবিলম্বিত বার্তা প্রত্যাহার করতে চাইতে পারেন। প্রত্যাহার অফলাইন ব্যবহারকারীরা যখন অনলাইনে ফিরে আসে তখন তাদের একটি পুরানো বার্তা পাওয়া থেকে আটকাতে পারে৷ একটি বার্তা প্রত্যাহার করার একাধিক উপায় আছে:

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

একটি বার্তার মেয়াদ নির্ধারণ করুন

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

একটি বার্তার মেয়াদ শেষ করতে, এজেন্ট বার্তায় নিম্নলিখিত ক্ষেত্রগুলির মধ্যে একটি নির্দিষ্ট করুন:

• expireTime : UTC-তে সঠিক সময় যখন বার্তাটির মেয়াদ শেষ হয়।
• ttl (লাইভের সময়): বার্তার মেয়াদ শেষ হওয়ার আগে সময়ের পরিমাণ।

বিন্যাস এবং মান বিকল্পের জন্য, AgentMessage দেখুন।

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

ttl এবং expireTime সর্বোচ্চ মান বার্তা জমা দেওয়ার 15 দিন পরে।

বার্তা আকার সীমা

সম্পূর্ণ স্ট্রিংফাইড AgentMessage এর সর্বোচ্চ আকার হল 250 KB। রিচ কার্ড এবং অন্যান্য মিডিয়া এই আকার সীমা অবদান. বার্তাটির পাঠ্য অংশের নিজস্ব সীমা 3072 অক্ষর রয়েছে৷

RBM এর মাধ্যমে পাঠানো যায় এমন একটি ফাইলের সর্বোচ্চ আকার হল 100MB। একটি একক RBM বার্তা শুধুমাত্র একটি PDF বা মিডিয়া ফাইল সংযুক্ত থাকতে পারে। আরও তথ্যের জন্য মিডিয়া এবং পিডিএফ ফাইলগুলি পড়ুন।

পাঠ্য

সহজতম বার্তাগুলি পাঠ্য দিয়ে তৈরি। পাঠ্য বার্তাগুলি ভিজ্যুয়াল, জটিল মিথস্ক্রিয়া বা প্রতিক্রিয়ার প্রয়োজন ছাড়াই তথ্য যোগাযোগের জন্য সবচেয়ে উপযুক্ত।

উদাহরণ

নিম্নলিখিত কোড একটি সাধারণ পাঠ্য বার্তা পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, phones.agentMessages.create দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!'
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let params = {
   messageText: 'Hello, world!',
   msisdn: '[phone]',
};

// Send a simple message to the device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Send simple text message to user
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]"
   );
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a simple RBM text message
message_text = messages.TextMessage('Hello, world!')

# Send text message to the device
messages.MessageCluster().append_message(message_text).send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "[phone]",
);

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

মৌলিক বার্তা বিষয়বস্তু - SMS এর রূপান্তর

RBM-এ এসএমএস বার্তা পাঠানোকে সমর্থন করার জন্য ক্যারিয়ারগুলি বিলিং মডেল চালু করেছে। 160টি UTF-8 অক্ষর সমন্বিত একটি RBM বার্তাকে মৌলিক বার্তা বলা হয়।

একটি মৌলিক বার্তা পাঠানোর জন্য একটি অনুরোধ তৈরি করার সময়, মনে রাখবেন যে অক্ষরগুলি 1 বাইট (UTF-8) হিসাবে গণনা করা হয়। আপনি ইমোজি বা মাল্টি-বাইট অক্ষর সেটের মতো বিশেষ অক্ষর সম্বলিত একটি বার্তা পাঠালে, প্রতিটি অক্ষর 2টি UTF-8 অক্ষর হিসাবে গণনা করে।

এর দৈর্ঘ্য পরীক্ষা করতে বাক্সে কিছু পাঠ্য লিখুন:

ব্যবহারকারী যাচাইকরণের জন্য এককালীন পাসওয়ার্ড

আপনি SMS Retriever API-এর মাধ্যমে স্বয়ংক্রিয় ব্যবহারকারী যাচাইয়ের জন্য ওয়ান-টাইম পাসওয়ার্ড (OTPs) পাঠাতে RBM ব্যবহার করতে পারেন। এসএমএস রিট্রিভার এবং সম্পর্কিত API সম্পর্কে আরও জানতে, এসএমএস রিট্রিভার ডকুমেন্টেশন দেখুন। এসএমএস রিট্রিভার API এর সাথে নিবন্ধিত অ্যাপগুলিতে স্বয়ংক্রিয় ব্যবহারকারী যাচাইকরণ সম্পর্কে বিশদ বিবরণের জন্য, এই ফ্লো ডায়াগ্রামটি দেখুন।

যাচাইকরণ প্রক্রিয়া চলাকালীন, SMS Retriever API একটি RBM বার্তা শোনে। এই বার্তাটিতে অবশ্যই একটি OTP এবং একটি হ্যাশ থাকতে হবে যা অ্যাপটিকে সনাক্ত করে৷ অ্যাপের সাথে হ্যাশ মিলে যাওয়ার পর, OTP বের করা হয় এবং স্বয়ংক্রিয় ব্যবহারকারী যাচাইয়ের জন্য অ্যাপে ফরওয়ার্ড করা হয়।

ব্যবহারকারী যাচাইকরণের জন্য এখানে একটি নমুনা RBM পাঠ্য বার্তা রয়েছে: আপনার কোড হল <OTP> <app হ্যাশ>।

উদাহরণস্বরূপ, Your code is 123456 M8tue43FGT.

টিপ: ওটিপি এবং অন্যান্য সময়-সংবেদনশীল বার্তাগুলির জন্য একটি বার্তার মেয়াদ শেষ করতে মনে রাখবেন৷

মিডিয়া এবং পিডিএফ ফাইল

আপনি যখন একটি ছবি, ভিডিও, অডিও, বা PDF ফাইল সহ একটি বার্তা পাঠান, তখন আপনার এজেন্টকে অবশ্যই সামগ্রীর জন্য একটি সর্বজনীনভাবে অ্যাক্সেসযোগ্য URL প্রদান করতে হবে বা সরাসরি ফাইল আপলোড করতে হবে৷ মিডিয়া ফাইলগুলির জন্য, আপনি একটি থাম্বনেইল চিত্রও নির্দিষ্ট করতে পারেন যা ব্যবহারকারীদের এটিতে ক্লিক করার আগে বিষয়বস্তুর পূর্বরূপ দেখতে দেয়। অডিও ফাইলের জন্য, ডিফল্ট অডিও উইজেট একটি স্থানধারক হিসাবে ব্যবহৃত হয়।

RBM প্ল্যাটফর্ম 60 দিনের জন্য ফাইল ক্যাশ করে, এবং API একটি ফাইল আইডি ফেরত দেয় যা আপনার এজেন্ট ব্যবহারকারীদের বার্তাগুলিতে অন্তর্ভুক্ত করতে পারে। 60 দিন পরে, RBM ক্যাশে থেকে ফাইলগুলি সরিয়ে দেয়।

URL দ্বারা ফাইলগুলি নির্দিষ্ট করার সময়, contentMessage.forceRefresh কে false তে সেট করা সর্বোত্তম অভ্যাস। true এ contentMessage.forceRefresh সেট করা RBM কে নির্দিষ্ট ইউআরএল থেকে নতুন কন্টেন্ট আনতে বাধ্য করে, এমনকি ইউআরএল কন্টেন্ট ক্যাশ করা থাকলেও, যা ব্যবহারকারীদের মেসেজ ডেলিভারির সময় বাড়ায়।

ফাইলের আকারের সুপারিশ এবং সীমার জন্য সর্বোত্তম অনুশীলন দেখুন।

ফাইল URL উদাহরণ

নিম্নলিখিত কোড একটি ছবি পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, AgentContentMessage দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'contentInfo': {
      'fileUrl': 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif',
      'forceRefresh': 'false'
    }
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let params = {
   fileUrl: 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif',
   msisdn: '[phone]',
};

// Send an image/video to a device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.AgentContentMessage;
import com.google.api.services.rcsbusinessmessaging.v1.model.AgentMessage;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   String fileUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

   // create media only message
   AgentContentMessage agentContentMessage = new AgentContentMessage();
   agentContentMessage.setContentInfo(new ContentInfo().setFileUrl(fileUrl));

   // attach content to message
   AgentMessage agentMessage = new AgentMessage();
   agentMessage.setContentMessage(agentContentMessage);

   rbmApiHelper.sendAgentMessage(agentMessage, "[phone]");
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create media file attachment
file_message = messages.FileMessage('http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif')

messages.MessageCluster().append_message(file_message).send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

string fileUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

// Create content info with the file url
ContentInfo contentInfo = new ContentInfo
{
    FileUrl = fileUrl
};

// Attach content info to a message
AgentContentMessage agentContentMessage = new AgentContentMessage
{
    ContentInfo = contentInfo,
};

// Attach content to message
AgentMessage agentMessage = new AgentMessage
{
    ContentMessage = agentContentMessage
};

rbmApiHelper.SendAgentMessage(agentMessage, "[phone]");

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

বিকল্পভাবে, আপনি files.create এর মাধ্যমে একটি বার্তা পাঠানোর আগে মিডিয়া আপলোড করতে পারেন।

ফাইল আপলোড উদাহরণ

নিম্নলিখিত কোডটি একটি ভিডিও ফাইল এবং একটি থাম্বনেল ফাইল আপলোড করে, তারপর এটি একটি বার্তায় উভয় ফাইল পাঠায়। বিন্যাস এবং মান বিকল্পের জন্য, files.create এবং AgentContentMessage দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/upload/v1/files?agentId=AGENT_ID" \
-H "Content-Type: video/mp4" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
--upload-file "FULL_PATH_TO_VIDEO_MEDIA_FILE"

# Capture server-specified video file name from response body JSON


curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/upload/v1/files?agentId=AGENT_ID" \
-H "Content-Type: image/jpeg" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
--upload-file "FULL_PATH_TO_THUMBNAIL_MEDIA_FILE"

# Capture server-specified image file name from response body JSON


curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'uploadedRbmFile': {
      'fileName': 'SERVER-SPECIFIED_VIDEO_FILE_NAME'
        'thumbnailName': 'SERVER-SPECIFIED_THUMBNAIL_FILE_NAME'
   }
  }
}"

সমর্থিত মিডিয়া প্রকার

RBM নিম্নলিখিত ধরনের মিডিয়া সমর্থন করে:

মিডিয়া টাইপ	নথির ধরন	এক্সটেনশন	রিচ কার্ডের সাথে কাজ করে
অ্যাপ্লিকেশন/ogg	OGG অডিও	.ogx	না
অ্যাপ্লিকেশন/পিডিএফ	PDF	.pdf	না
অডিও/aac	AAC অডিও	.aac	না
অডিও/mp3	MP3 অডিও	mp3	না
অডিও/এমপিইজি	MPEG অডিও	.mpeg	না
অডিও/এমপিজি	MPG অডিও	mp3	না
অডিও/mp4	MP4 অডিও	.mp4	না
audio/mp4-latm	MP4-latm অডিও	.mp4	না
audio/3gpp	3GPP অডিও	.3gp	না
image/jpeg	জেপিইজি	.jpeg, .jpg	হ্যাঁ
ছবি/জিআইএফ	জিআইএফ	.gif	হ্যাঁ
image/png	পিএনজি	.png	হ্যাঁ
video/h263	H263 ভিডিও	.h263	হ্যাঁ
ভিডিও/m4v	M4V ভিডিও	.m4v	হ্যাঁ
ভিডিও/mp4	MP4 ভিডিও	.mp4	হ্যাঁ
video/mpeg4	MPEG-4 ভিডিও	.mp4, .m4p	হ্যাঁ
ভিডিও/এমপিইজি	MPEG ভিডিও	.mpeg	হ্যাঁ
ভিডিও/ওয়েবএম	WEBM ভিডিও	.webm	হ্যাঁ

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

প্রস্তাবিত উত্তর ব্যবহারকারীদের কথোপকথনের মাধ্যমে এমন প্রতিক্রিয়া প্রদান করে যা আপনার এজেন্ট জানে কিভাবে প্রতিক্রিয়া জানাতে হয়। আপনার এজেন্ট সাজেশন চিপ তালিকায় বা রিচ কার্ডে প্রস্তাবিত উত্তর পাঠায়।

যখন একজন ব্যবহারকারী একটি প্রস্তাবিত উত্তরে ট্যাপ করে, তখন আপনার এজেন্ট একটি ইভেন্ট পায় যাতে উত্তরের পাঠ্য এবং পোস্টব্যাক ডেটা থাকে।

প্রস্তাবিত উত্তরে সর্বোচ্চ ২৫টি অক্ষর থাকতে পারে।

উদাহরণ

নিম্নলিখিত কোড দুটি প্রস্তাবিত উত্তর সহ পাঠ্য পাঠায়। বিন্যাস এবং মান বিকল্পের জন্য, SuggestedReply দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!',
    'suggestions': [
      {
        'reply': {
          'text': 'Suggestion #1',
          'postbackData': 'suggestion_1'
        }
      },
      {
        'reply': {
          'text': 'Suggestion #2',
          'postbackData': 'suggestion_2'
        }
      }
    ]
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let suggestions = [
   {
      reply: {
         'text': 'Suggestion #1',
         'postbackData': 'suggestion_1',
      },
   },
   {
      reply: {
         'text': 'Suggestion #2',
         'postbackData': 'suggestion_2',
      },
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '[phone]',
   suggestions: suggestions,
};

// Send a simple message with suggestion chips to the device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();
   suggestions.add(
      new SuggestionHelper("Suggestion #1", "suggestion_1").getSuggestedReply());

   suggestions.add(
      new SuggestionHelper("Suggestion #2", "suggestion_2").getSuggestedReply());

   // Send simple text message to user
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggested replies for the message to send to the user
cluster.append_suggestion_chip(messages.SuggestedReply('Suggestion #1', 'reply:suggestion_1'))
cluster.append_suggestion_chip(messages.SuggestedReply('Suggestion #2', 'reply:suggestion_2'))

# Send a simple message with suggestion chips to the device
cluster.send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

List<Suggestion> suggestions = new List<Suggestion>
{
   // Create suggestion chips
   new SuggestionHelper("Suggestion #1", "suggestion_1").SuggestedReply(),
   new SuggestionHelper("Suggestion #2", "suggestion_2").SuggestedReply()
};

// Send simple text message with suggestions to user
rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "[phone]",
   suggestions
);

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

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

প্রস্তাবিত ক্রিয়াগুলি ব্যবহারকারীদের তাদের ডিভাইসের অন্তর্নির্মিত কার্যকারিতা ছেড়ে দিয়ে কথোপকথনের মাধ্যমে গাইড করে। আপনার এজেন্ট পরামর্শ দিতে পারে যে ব্যবহারকারীরা একটি নম্বর ডায়াল করুন, একটি মানচিত্রে একটি অবস্থান খুলুন, একটি অবস্থান ভাগ করুন, একটি URL খুলুন বা একটি ক্যালেন্ডার ইভেন্ট তৈরি করুন৷ আপনার এজেন্ট সাজেশন চিপ তালিকায় বা রিচ কার্ডে প্রস্তাবিত অ্যাকশন পাঠায়।

যখন একজন ব্যবহারকারী একটি প্রস্তাবিত অ্যাকশনে ট্যাপ করে, তখন আপনার এজেন্ট একটি ইভেন্ট পায় যাতে অ্যাকশনের পোস্টব্যাক ডেটা থাকে।

প্রস্তাবিত ক্রিয়াগুলিতে সর্বাধিক 25টি অক্ষর রয়েছে৷

বিন্যাস এবং মান বিকল্পের জন্য, SuggestedAction দেখুন।

একটি নম্বর ডায়াল করুন

ডায়াল অ্যাকশন ব্যবহারকারীকে আপনার এজেন্ট দ্বারা নির্দিষ্ট একটি ফোন নম্বর ডায়াল করতে নির্দেশিত করে৷ ফোন নম্বরে শুধুমাত্র সংখ্যা ( 0-9 ), প্লাস চিহ্ন ( + ), তারকাচিহ্ন ( * ) এবং নম্বর চিহ্ন ( # ) অন্তর্ভুক্ত থাকতে পারে। E.164 আন্তর্জাতিক বিন্যাস (উদাহরণস্বরূপ, [phone] ) সমর্থিত কিন্তু প্রয়োজনীয় নয়। অর্থাৎ, [phone] এবং 1011 উভয়ই বৈধ এন্ট্রি।

উদাহরণ

নিম্নলিখিত কোড একটি ডায়াল কর্ম পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, DialAction দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!',
    'suggestions': [
      {
        'action': {
          'text': 'Call',
          'postbackData': 'postback_data_1234',
          'fallbackUrl': 'https://www.google.com/contact/',
          'dialAction': {
            'phoneNumber': '[phone]'
          }
        }
      }
    ]
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a dial suggested action
let suggestions = [
   {
      action: {
         text: 'Call',
         postbackData: 'postback_data_1234',
         dialAction: {
            phoneNumber: '[phone]'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '[phone]',
   suggestions: suggestions,
};

// Send a simple message with a dial suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.DialAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a dial suggested action
   DialAction dialAction = new DialAction();
   dialAction.setPhoneNumber("[phone]");

   // creating a suggested action based on a dial action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Call");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setDialAction(dialAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a dial suggested action
suggestions = [
      messages.DialAction('Call', 'reply:postback_data_1234', '[phone]')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a dial an agent suggested action
DialAction dialAction = new DialAction
{
    PhoneNumber = "[phone]"
};

// Creating a suggested action based on a dial action
SuggestedAction suggestedAction = new SuggestedAction
{
    Text = "Call",
    PostbackData = "postback_data_1234",
    DialAction = dialAction
};

// Attach action to a suggestion
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "[phone]",
    suggestions
);

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

একটি অবস্থান দেখুন

ভিউ লোকেশন অ্যাকশন ব্যবহারকারীর ডিফল্ট ম্যাপ অ্যাপে একটি অবস্থান প্রদর্শন করে। আপনি অক্ষাংশ এবং দ্রাঘিমাংশ দ্বারা বা ব্যবহারকারীর বর্তমান অবস্থানের উপর ভিত্তি করে একটি প্রশ্নের সাথে অবস্থানটি নির্দিষ্ট করতে পারেন৷ আপনি মানচিত্র অ্যাপে প্রদর্শিত পিনের জন্য একটি কাস্টম লেবেলও সেট করতে পারেন।

উদাহরণ

নিম্নলিখিত কোড একটি ভিউ অবস্থান কর্ম পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, দেখুন ViewLocationAction ।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!',
    'suggestions': [
      {
        'action': {
          'text': 'View map',
          'postbackData': 'postback_data_1234',
          'fallbackUrl': 'https://www.google.com/maps/@37.4220188,-122.0844786,15z',
          'viewLocationAction': {
            'latLong': {
              'latitude': "37.4220188',
              'longitude': "-122.0844786'
            },
            'label': 'Googleplex'
          }
        }
      }
    ]
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a view location suggested action
let suggestions = [
   {
      action: {
         text: 'View map',
         postbackData: 'postback_data_1234',
         viewLocationAction: {
            latLong: {
               latitude: 37.4220188,
               longitude: -122.0844786
            },
            label: 'Googleplex'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '[phone]',
   suggestions: suggestions,
};

// Send a simple message with a view location suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.ViewLocationAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a view location suggested action
   ViewLocationAction viewLocationAction = new ViewLocationAction();
   viewLocationAction.setQuery("Googleplex, Mountain View, CA");

   // creating a suggested action based on a view location action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("View map");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setViewLocationAction(viewLocationAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a view location suggested action
suggestions = [
      messages.ViewLocationAction('View map',
            'reply:postback_data_1234',
            query='Googleplex, Mountain View, CA')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// create an view location action
ViewLocationAction viewLocationAction = new ViewLocationAction
{
    Query = "Googleplex Mountain View, CA"
};

// Attach the view location action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    ViewLocationAction = viewLocationAction,
    Text = "View map",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "[phone]",
    suggestions
);

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

একটি অবস্থান শেয়ার করুন

শেয়ার লোকেশন অ্যাকশন ব্যবহারকারীকে আপনার এজেন্টের কাছে একটি অবস্থান পাঠাতে দেয়। ব্যবহারকারী যে অবস্থানটি নির্দিষ্ট করে তা অবশ্যই ব্যবহারকারীর অবস্থান নয়।

উদাহরণ

নিম্নলিখিত কোড একটি শেয়ার অবস্থান কর্ম পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, ShareLocationAction দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!',
    'suggestions': [
      {
        'action': {
          'text': 'Share your location',
          'postbackData': 'postback_data_1234',
          'shareLocationAction': {}
        }
      }
    ]
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a share location suggested action
let suggestions = [
   {
      action: {
         text: 'Share your location',
         postbackData: 'postback_data_1234',
         shareLocationAction: {
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '[phone]',
   suggestions: suggestions,
};

// Send a simple message with a share location suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.ShareLocationAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a share location suggested action
   ShareLocationAction shareLocationAction = new ShareLocationAction();

   // creating a suggested action based on a share location action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Share location");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setShareLocationAction(shareLocationAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a share location suggested action
suggestions = [
      messages.ShareLocationAction('Share location',
            'reply:postback_data_1234')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a share location action
ShareLocationAction shareLocationAction = new ShareLocationAction();

// Attach the share location action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    ShareLocationAction = shareLocationAction,
    Text = "Share location",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "[phone]",
    suggestions
);

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

একটি URL খুলুন

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

ওপেন ইউআরএল অ্যাকশন সমন্বিত ওয়েবভিউ সমর্থন করে; ওয়েবভিউ সহ ইউআরএল খুলুন দেখুন।

উদাহরণ

নিম্নলিখিত কোড একটি খোলা URL কর্ম পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, OpenUrlAction দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!',
    'suggestions': [
      {
        'action': {
          'text': 'Open Google',
          'postbackData': 'postback_data_1234',
          'openUrlAction': {
            'url': 'https://www.google.com'
          }
        }
      }
    ]
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define an open URL suggested action
let suggestions = [
   {
      action: {
         text: 'Open Google',
         postbackData: 'postback_data_1234',
         openUrlAction: {
            url: 'https://www.google.com'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '[phone]',
   suggestions: suggestions,
};

// Send a simple message with an open URL suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.OpenUrlAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating an open url suggested action
   OpenUrlAction openUrlAction = new OpenUrlAction();
   openUrlAction.setUrl("https://www.google.com");

   // creating a suggested action based on an open url action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Open Google");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setOpenUrlAction(openUrlAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create an open url suggested action
suggestions = [
      messages.OpenUrlAction('Open Google',
            'reply:postback_data_1234',
            'https://www.google.com')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create an open url action
OpenUrlAction openUrlAction = new OpenUrlAction
{
    Url = "https://www.google.com"
};

// Attach the open url action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    OpenUrlAction = openUrlAction,
    Text = "Open Google",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "[phone]",
    suggestions
);

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

ওয়েবভিউ সহ একটি URL খুলুন

গুরুত্বপূর্ণ: ওয়েবভিউ RBM-এ উপলব্ধ। যাইহোক, আমরা ধীরে ধীরে Google বার্তাগুলিতে RBM-এর জন্য ওয়েবভিউ সমর্থন চালু করছি। এখন Google বার্তাগুলিতে ওয়েবভিউ ব্যবহার করতে, আপনাকে পরীক্ষার জন্য প্রাথমিক অ্যাক্সেস প্রোগ্রামে যোগ দিতে হবে৷ (ফিচারটি পরবর্তী সময়ে প্রোডাকশন এজেন্টদের জন্য Google Messages-এ উপলব্ধ হবে।) Google Messages-এ ওয়েবভিউ পরীক্ষা করার জন্য প্রাথমিক অ্যাক্সেসের অনুরোধ করতে, আপনার RBM পরিচিতির সাথে যোগাযোগ করুন।

ওয়েবভিউ অ্যাকশন সহ ওপেন URL আপনার ডিফল্ট ব্রাউজারের রেন্ডারিং ইঞ্জিনের সাথে মেসেজিং অ্যাপের ভিতরে নির্দিষ্ট ওয়েব পৃষ্ঠা লোড করে। এটি ব্যবহারকারীকে RBM কথোপকথন ছাড়াই ওয়েব পৃষ্ঠার সাথে ইন্টারঅ্যাক্ট করতে দেয়। ওয়েবভিউ সক্ষম করতে, OpenURLApplication দেখুন।

ওয়েবভিউতে তিনটি প্রদর্শন মোড রয়েছে। বিন্যাস এবং মান বিকল্পের জন্য, WebviewViewMode দেখুন।

• সম্পূর্ণ: ওয়েব পৃষ্ঠাটি পুরো স্ক্রিনটি নেয়
• অর্ধেক: ওয়েব পেজটি স্ক্রিনের অর্ধেক জায়গা নেয়
• লম্বা: ওয়েব পৃষ্ঠাটি স্ক্রিনের তিন চতুর্থাংশ জায়গা নেয়

উদাহরণ

নিম্নলিখিত কোড ওয়েবভিউ অ্যাকশন সহ একটি ওপেন ইউআরএল পাঠায়। বিন্যাস এবং মান বিকল্পের জন্য, OpenURLAction দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
 "contentMessage": {
   "text": "Hello, world!",
   "suggestions": [
     {
       "action": {
         "text": "Open Google",
         "postbackData": "postback_data_1234",
         "openUrlAction": {
           "url": "https://www.google.com",
           "application": "WEBVIEW",
           "webviewViewMode": "FULL",
           "description": "Accessibility description"
         }
       }
     }
   ]
 }
}'

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.OpenUrlAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…
  
try {
  
   String URL = "https://www.google.com";
  
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();
  
   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // Create suggestion to view webpage in full mode
   Suggestion viewInFullMode =  getUrlActionInWebview(URL, "FULL")
   suggestions.add(viewInFullMode);
  
   // create suggestion to view webpage in half mode
   Suggestion viewInHalfMode =  getUrlActionInWebview(URL, "HALF")
   suggestions.add(viewInHalfMode);
     
   // create suggestion to view webpage in tall mode
   Suggestion viewInTallMode =  getUrlActionInWebview(URL, "TALL")
   suggestions.add(viewInTallMode);
     
   // Send simple text message with the suggested action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

  /**
    * Creates a suggested action to open URL in webview.
    *
    * @return a suggestion object for an open URL in webview action .
    */
    private Suggestion getUrlActionInWebview(String url,
                                             String viewMode) {
      // create an open url action
      OpenUrlAction openUrlAction = new OpenUrlAction();
      openUrlAction.setUrl(url);
      openUrlAction.setApplication("WEBVIEW");
      openUrlAction.setWebviewViewMode(viewMode);
      openUrlAction.setDescription("Accessibility description");
     
      // attach the open url action to a suggested action
      SuggestedAction suggestedAction = new SuggestedAction();
      suggestedAction.setOpenUrlAction(openUrlAction);
      suggestedAction.setText('display_text');
      suggestedAction.setPostbackData('postback_data_123');
     
      // attach the action to a suggestion object
      Suggestion suggestion = new Suggestion();
      suggestion.setAction(suggestedAction);
     
      return suggestion;
    }

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

ক্যালেন্ডার ইভেন্ট তৈরি করুন অ্যাকশন ব্যবহারকারীর ক্যালেন্ডার অ্যাপ খোলে এবং নির্দিষ্ট তথ্য দিয়ে একটি নতুন ইভেন্ট তৈরি করা শুরু করে।

উদাহরণ

নিম্নলিখিত কোড একটি তৈরি ক্যালেন্ডার ইভেন্ট কর্ম পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, CreateCalendarEventAction দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!',
    'suggestions': [
      {
        'action': {
          'text': 'Save to calendar',
          'postbackData': 'postback_data_1234',
          'fallbackUrl': 'https://www.google.com/calendar',
          'createCalendarEventAction': {
            'startTime': '2020-06-30T19:00:00Z',
            'endTime': '2020-06-30T20:00:00Z',
            'title': 'My calendar event',
            'description': 'Description of the calendar event'
          }
        }
      }
    ]
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a create calendar event suggested action
let suggestions = [
   {
      action: {
         text: 'Save to calendar',
         postbackData: 'postback_data_1234',
         createCalendarEventAction: {
            startTime: '2020-06-30T19:00:00Z',
            endTime: '2020-06-30T20:00:00Z',
            title: 'My calendar event',
            description: 'Description of the calendar event',
         },
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '[phone]',
   suggestions: suggestions,
};

// Send a simple message with a create calendar event suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.CreateCalendarEventAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a create calendar event suggested action
   CreateCalendarEventAction createCalendarEventAction = new CreateCalendarEventAction();
   calendarEventAction.setTitle("My calendar event");
   calendarEventAction.setDescription("Description of the calendar event");
   calendarEventAction.setStartTime("2020-06-30T19:00:00Z");
   calendarEventAction.setEndTime("2020-06-30T20:00:00Z");

   // creating a suggested action based on a create calendar event action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Save to calendar");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setCreateCalendarEventAction(createCalendarEventAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a calendar event suggested action
suggestions = [
      messages.CreateCalendarEventAction('Save to Calendar',
                             'reply:postback_data_1234',
                             '2020-06-30T19:00:00Z',
                             '2020-06-30T20:00:00Z',
                             'My calendar event',
                             'Description of the calendar event')

]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a calendar event action
CreateCalendarEventAction calendarEventAction = new CreateCalendarEventAction
{
    Title = "My calendar event",
    Description = "Description of the calendar event",
    StartTime = "2020-06-30T19:00:00Z",
    EndTime = "2020-06-30T20:00:00Z"
};

// Attach the calendar event action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    CreateCalendarEventAction = calendarEventAction,
    Text = "Save to calendar",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "[phone]",
    suggestions
);

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

বার্তা রচনা করুন

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

বিটা: আমরা ধীরে ধীরে Google বার্তাগুলিতে রচনা অ্যাকশন চালু করছি, তাই আপনি এখনই এটিতে অ্যাক্সেস নাও পেতে পারেন৷ সম্পূর্ণ রোলআউটের আগে অ্যাক্সেস পেতে, আপনি বার্তা ওপেন বিটা প্রোগ্রামে যোগ দিতে পারেন।

কম্পোজ অ্যাকশন তিন ধরনের। চাক্ষুষ উদাহরণের জন্য, একটি পাঠ্য, অডিও বা ভিডিও বার্তা রচনা করুন দেখুন।

• একটি পাঠ্য বার্তা রচনা করুন : ব্যবহারকারীর পাঠানোর জন্য প্রিফিল করা পাঠ্য সহ মেসেজিং অ্যাপটি খোলে।
• একটি অডিও বার্তা রচনা করুন : মেসেজিং অ্যাপটি খোলে এবং মাইক্রোফোন চালু করে যাতে ব্যবহারকারী অডিও রেকর্ড করতে পারে।
• একটি ভিডিও বার্তা রচনা করুন : মেসেজিং অ্যাপটি খোলে এবং ক্যামেরা চালু করে যাতে ব্যবহারকারী একটি ভিডিও রেকর্ড করতে পারে।

উদাহরণ

নিম্নলিখিত কোড একটি রচনা কর্ম পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, ComposeAction দেখুন।

cURL

  curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
  -H "Content-Type: application/json" \
  -H "User-Agent: curl/rcs-business-messaging" \
  -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \  
-d "{
  'contentMessage': {
    'text': 'Hello, world!',
    'suggestions': [
      {
        'action': {
          'text': 'Compose a text message',
          'postbackData': 'postback_data_123',
          'composeAction': {
            'composeTextMessage': {
              'phoneNumber': '[phone]'
              'text': 'Draft to go into the send message text field.'
            }
          }
        }
      },{
        'action': {
          'text': 'Compose an audio message',
          'postbackData': 'postback_data_456',
          'composeAction': {
            'composeRecordingMessage': {
              'phoneNumber': '[phone]'
              'type': 'ACTION_TYPE_AUDIO'
            }
          }
        }
      },{
        'action': {
          'text': 'Compose a video message',
          'postbackData': 'postback_data_789',
          'composeAction': {
            'composeRecordingMessage': {
              'phoneNumber': '[phone]'
              'type': 'ACTION_TYPE_VIDEO'
            }
          }
        }
      }
    ]
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a compose suggested action
let suggestions = [
   {
      action: {
         text: 'Compose a text message',
         postbackData: 'postback_data_123',
         'composeAction': {
            'composeTextMessage': {
               'phoneNumber': '[phone]'
               'text': 'Draft to go into the send message text field.'
            }
         }
      }
   },{
      action: {
         text: 'Compose an audio message',
         postbackData: 'postback_data_456',
         'composeAction': {
            'composeRecordingMessage': {
               'phoneNumber': '[phone]'
               'type': 'ACTION_TYPE_AUDIO'
            }
         }
      }
   },{
      action: {
         text: 'Compose a video message',
         postbackData: 'postback_data_789',
         'composeAction': {
            'composeRecordingMessage': {
               'phoneNumber': '[phone]'
               'type': 'ACTION_TYPE_VIDEO'
            }
         }
      }
   }
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '[phone]',
   suggestions: suggestions,
};

// Send a simple message with a dial suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.ComposeAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.ComposeRecordingMessage;
import com.google.api.services.rcsbusinessmessaging.v1.model.ComposeTextMessage;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating compose text suggested action
   Suggestion composeTextSuggestion =  getComposeTextAction()
   suggestions.add(composeTextSuggestion);

   // creating compose audio suggested action
   Suggestion composeAudioSuggestion =  getComposeAudioAction()
   suggestions.add(composeAudioSuggestion);


   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

 /**
   * Creates a compose text suggested action.
   * @return A suggestion object for a compose text action.
 */
 private Suggestion getComposeTextAction() {
        // creating a compose text suggested action
        ComposeTextMessage message = new ComposeTextMessage();
        message.setPhoneNumber("[phone]");
        message.setText("Draft to go into the send message text field.");
        ComposeAction composeAction = new ComposeAction();
        composeAction.setComposeTextMessage(message);

        // creating a suggested action based on a compose text action
        SuggestedAction suggestedAction = new SuggestedAction();
        suggestedAction.setText("Send a text message");
        suggestedAction.setPostbackData("postback_data_123");
        suggestedAction.setComposeAction(composeAction);

        // attaching action to a suggestion
        Suggestion suggestion = new Suggestion();
        suggestion.setAction(suggestedAction);

        return suggestion;
    }

    /**
     * Creates a compose audio suggested action.
     * @return A suggestion object for a compose audio action.
    */
    private Suggestion getComposeAudioAction() {
        // creating a compose audio suggested action
        ComposeRecordingMessage message = new ComposeRecordingMessage();
        message.setPhoneNumber("[phone]");
        message.setType("ACTION_TYPE_AUDIO");
        ComposeAction composeAction = new ComposeAction();
        composeAction.setComposeRecordingMessage(message);

        // creating a suggested action based on a compose text action
        SuggestedAction suggestedAction = new SuggestedAction();
        suggestedAction.setText("Send an audio message");
        suggestedAction.setPostbackData("postback_data_456");
        suggestedAction.setComposeAction(composeAction);

        // attaching action to a suggestion
        Suggestion suggestion = new Suggestion();
        suggestion.setAction(suggestedAction);

        return suggestion;
    }

পাইথন

  # Reference to RBM Python client helper and messaging object structure
  from rcs_business_messaging import rbm_service
  from rcs_business_messaging import messages

  # Create a dial suggested action
  suggestions = [
      messages.ComposeTextMessageAction(
          'Send a text message',
          'postback_data_123',
          '[phone]',
          '')
      messages.ComposeRecordingMessageAction(
          'Send an audio message',
          'postback_data_456',
          '[phone]',
          'ACTION_TYPE_AUDIO')
  
  ]

  # Create text message to send to user
  text_msg = messages.TextMessage('Hello, world!')
  cluster = messages.MessageCluster().append_message(text_msg)

  # Append suggestions for the message to send to the user
  for suggestion in suggestions:
      cluster.append_suggestion_chip(suggestion)

  # Send a simple message with suggested action to the device
  cluster.send_to_msisdn('[phone]')

সি#

  using Google.Apis.RCSBusinessMessaging.v1.Data;
  using RCSBusinessMessaging;
  …

  // Create an instance of the RBM API helper
  RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                   projectId);

  // Create a compose text suggested action
  ComposeTextMessage composeTextMessage = new ComposeTextMessage{
      PhoneNumber = "[phone]"
      Text = "Draft to go into the send message text field."
  };

  ComposeAction composeAction = new ComposeAction
  {
      ComposeTextMessage = composeTextMessage
  };

  // Creating a suggested action based on a compose action
  SuggestedAction suggestedAction = new SuggestedAction
  {
      Text = "Send a text message",
      PostbackData = "postback_data_123",
      ComposeAction = composeAction
  };

  // Attach action to a suggestion
  Suggestion suggestion = new Suggestion
  {
      Action = suggestedAction
  };

  List suggestions = new List
  {
      suggestion
  };

  rbmApiHelper.SendTextMessage(
      "Hello, world!",
      "[phone]",
      suggestions
  );  

পরামর্শ চিপ তালিকা

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

তালিকার চিপগুলি প্রস্তাবিত উত্তর এবং প্রস্তাবিত ক্রিয়াকলাপ ।

চিপ তালিকায় সর্বাধিক 11 টি পরামর্শ চিপ রয়েছে এবং প্রতিটি চিপ লেবেলে সর্বাধিক 25টি অক্ষর থাকতে পারে।

বিন্যাস এবং মান বিকল্পের জন্য, AgentContentMessage দেখুন।

রিচ কার্ড

আপনি যখন সম্পর্কিত তথ্য, মিডিয়া বা পরামর্শের একটি অংশ পাঠাতে চান, তখন আপনাকে একটি সমৃদ্ধ কার্ড পাঠাতে হবে। রিচ কার্ড আপনার এজেন্টকে একক বার্তায় একাধিক একক তথ্য পাঠাতে দেয়।

রিচ কার্ডে নিম্নলিখিত আইটেম থাকতে পারে:

• একটি ছবি বা ভিডিও
• শিরোনাম পাঠ্য
• বর্ণনা পাঠ্য
• প্রস্তাবিত উত্তর এবং প্রস্তাবিত কর্মের একটি তালিকা (সর্বাধিক 4)

একটি সমৃদ্ধ কার্ডে তালিকাভুক্ত সমস্ত আইটেম থাকতে পারে, তবে বৈধ হওয়ার জন্য একটি কার্ডে অন্তত একটি ছবি, ভিডিও বা শিরোনাম থাকতে হবে। একটি সমৃদ্ধ কার্ডে সর্বাধিক চারটি প্রস্তাবিত ক্রিয়া বা প্রস্তাবিত উত্তর থাকতে পারে৷ এটি একটি একক কার্ডে প্রস্তাবিত ক্রিয়া এবং প্রস্তাবিত উত্তরগুলির সংমিশ্রণ ধারণ করতে পারে না।

আপনার এজেন্ট একটি রিচ কার্ড ক্যারোজেলে একসাথে একাধিক রিচ কার্ড পাঠাতে পারে।

একটি সমৃদ্ধ কার্ড পেলোডের সর্বোচ্চ আকার হল 250 KB৷ মিডিয়া ফাইলের আকার সুপারিশ এবং সীমার জন্য সর্বোত্তম অনুশীলন দেখুন।

কার্ডের উচ্চতা

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

রিচ কার্ডের মিডিয়া অবশ্যই তিনটি উচ্চতার একটিতে মাপসই হবে:

• সংক্ষিপ্ত: 112 ডিপি
• মাঝারি: 168 ডিপি
• লম্বা: 264 ডিপি

যদি মিডিয়াটি নির্বাচিত উচ্চতা প্রদত্ত কার্ডের মধ্যে মাত্রার সাথে খাপ খায় না, মিডিয়া প্রিভিউটি মিডিয়াকে জুম করে এবং ক্রপ করে বেছে নেওয়া হয়।

উদাহরণ

নিম্নলিখিত কোডটি একটি ছবি এবং প্রস্তাবিত উত্তর সহ একটি সমৃদ্ধ কার্ড পাঠায়৷ বিন্যাস এবং মান বিকল্পের জন্য, RichCard দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'richCard': {
      'standaloneCard': {
        'thumbnailImageAlignment': 'RIGHT',
        'cardOrientation': 'VERTICAL',
        'cardContent': {
          'title': 'Hello, world!',
          'description': 'RBM is awesome!',
          'media': {
            'height': 'TALL',
            'contentInfo':{
              'fileUrl': 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif',
              'forceRefresh': 'false'
            }
          },
          'suggestions': [
            {
              'reply': {
                'text': 'Suggestion #1',
                'postbackData': 'suggestion_1'
              }
            },
            {
              'reply': {
                'text': 'Suggestion #2',
                'postbackData': 'suggestion_2'
              }
            }
          ]
        }
      }
    }
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Suggested replies to be used in the card
let suggestions = [
   {
      reply: {
         'text': 'Suggestion #1',
         'postbackData': 'suggestion_1',
      },
   },
   {
      reply: {
         'text': 'Suggestion #2',
         'postbackData': 'suggestion_2',
      },
   },
];

// Image to be displayed by the card
let imageUrl = 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif';

// Definition of the card parameters
let params = {
   messageText: 'Hello, world!',
   messageDescription: 'RBM is awesome!',
   msisdn: '[phone]',
   suggestions: suggestions,
   imageUrl: imageUrl,
   height: 'TALL',
};

// Send rich card to device
rbmApiHelper.sendRichCard(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.StandaloneCard;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.cards.CardOrientation;
import com.google.rbm.cards.MediaHeight;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();
   suggestions.add(
      new SuggestionHelper("Suggestion #1", "suggestion_1").getSuggestedReply());

   suggestions.add(
      new SuggestionHelper("Suggestion #2", "suggestion_2").getSuggestedReply());

   String imageUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

   // Create a standalone rich card to send to the user
   StandaloneCard standaloneCard = rbmApiHelper.createStandaloneCard(
       "Hello, world!",
       "RBM is awesome!",
       imageUrl,
       MediaHeight.MEDIUM,
       CardOrientation.VERTICAL,
       suggestions
   );

   rbmApiHelper.sendStandaloneCard(standaloneCard, "[phone]");
} catch(Exception e) {
   e.printStackTrace();
}

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Suggested replies to be used in the card
suggestions = [
      messages.SuggestedReply('Suggestion #1', 'reply:suggestion_1'),
      messages.SuggestedReply('Suggestion #2', 'reply:suggestion_2')
]

# Image to be displayed by the card
image_url = 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif';

# Define rich card structure
rich_card = messages.StandaloneCard('VERTICAL',
                                    'Hello, world!',
                                    'RBM is awesome!',
                                    suggestions,
                                    image_url,
                                    None,
                                    None,
                                    'MEDIUM')

# Append rich card and send to the user
cluster = messages.MessageCluster().append_message(rich_card)
cluster.send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
using RCSBusinessMessaging.Cards;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

List<Suggestion> suggestions = new List<Suggestion>
{
   // Create suggestion chips
   new SuggestionHelper("Suggestion #1", "suggestion_1").SuggestedReply(),
   new SuggestionHelper("Suggestion #2", "suggestion_2").SuggestedReply()
};

string imageUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

// Create rich card with suggestions
StandaloneCard standaloneCard = rbmApiHelper.CreateStandaloneCard(
   "Hello, world!",
   "RBM is awesome",
   imageUrl,
   MediaHeight.TALL,
   CardOrientation.VERTICAL,
   suggestions
);

// Send rich card to user
rbmApiHelper.SendStandaloneCard(standaloneCard, "[phone]");

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

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

যখন আপনাকে একটি ব্যবহারকারীকে একাধিক বিকল্পের মধ্যে বেছে নেওয়ার জন্য উপস্থাপন করতে হবে, তখন একটি সমৃদ্ধ কার্ড ক্যারোজেল ব্যবহার করুন। ক্যারোসেলগুলি একাধিক সমৃদ্ধ কার্ডকে একত্রিত করে, ব্যবহারকারীদের আইটেমগুলির তুলনা করতে এবং প্রতিটিতে পৃথকভাবে প্রতিক্রিয়া জানাতে দেয়৷

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

একটি সমৃদ্ধ কার্ড ক্যারোজেল পেলোডের সর্বোচ্চ আকার হল 250 KB৷ মিডিয়া ফাইলের আকার সুপারিশ এবং সীমার জন্য সর্বোত্তম অনুশীলন দেখুন।

ছেদন

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

যদি ডিসপ্লে সীমাবদ্ধতা বা কার্ডের উচ্চতার কারণে একটি ডিভাইস কার্ডের সমস্ত উপাদান প্রদর্শন করতে না পারে, তাহলে নিম্নলিখিত যুক্তি ব্যবহার করে RBM কার্ডটিকে ডিভাইসে প্রদর্শন না করা পর্যন্ত ছেঁটে ফেলে:

1. বর্ণনাকে এক লাইনে কমিয়ে দিন।
2. শিরোনামটি এক লাইনে কমিয়ে দিন।
3. সংজ্ঞায়িত তালিকার শেষ থেকে শুরু করে কার্ডের সাথে খাপ খায় না এমন পরামর্শগুলি বাদ দিন।
4. বর্ণনা বাদ দিন।
5. শিরোনাম বাদ দিন।

ছাঁটাই এড়াতে, শিরোনাম এবং বিবরণ যতটা সম্ভব ছোট রাখুন। লম্বা মিডিয়ার জন্য, একটি শিরোনাম এবং বিবরণ বা একটি পরামর্শ ব্যবহার করুন। মিডিয়াম মিডিয়ার জন্য, দুটি পর্যন্ত পরামর্শ ব্যবহার করুন। সংক্ষিপ্ত মিডিয়ার জন্য, তিনটি পর্যন্ত পরামর্শ ব্যবহার করুন। চারটি পরামর্শের জন্য, কার্ডে মিডিয়া অন্তর্ভুক্ত করবেন না।

বিষয়বস্তুর আকার এবং দৈর্ঘ্যের ক্ষেত্রে কার্ডগুলি মোটামুটি সমতুল্য রাখুন এবং প্রয়োজনে, নিম্নলিখিত কার্ডগুলিতে কাটা এড়াতে আরও বড় কার্ডগুলির সাথে ক্যারোজেলটিকে সামনে লোড করুন৷

উদাহরণ

নিম্নলিখিত কোড একটি সমৃদ্ধ কার্ড ক্যারোজেল পাঠায়. বিন্যাস এবং মান বিকল্পের জন্য, RichCard দেখুন।

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'richCard': {
      'carouselCard': {
        'cardWidth':'MEDIUM',
        'cardContents': [
          {
            'title':'Card #1',
            'description':'The description for card #1',
            'suggestions': [
              {
                'reply': {
                  'text':'Card #1',
                  'postbackData':'card_1'
                }
              }
            ],
            'media': {
              'height':'MEDIUM',
              'contentInfo': {
                'fileUrl':'https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg',
                'forceRefresh':'false'
              }
            }
          },
          {
            'title':'Card #2',
            'description':'The description for card #2',
            'suggestions': [
              {
                'reply': {
                  'text':'Card #2',
                  'postbackData':'card_2'
                }
              }
            ],
            'media': {
              'height':'MEDIUM',
              'contentInfo': {
                'fileUrl':'https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg',
                'forceRefresh': 'false'
              }
            }
          }
        ]
      }
    }
  }
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Images for the carousel cards
let card1Image = 'https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg';
let card2Image = 'https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg';

// Define the card contents for a carousel with two cards, each with one suggested reply
let cardContents = [
   {
      title: 'Card #1',
      description: 'The description for card #1',
      suggestions: [
         {
            reply: {
               text: 'Card #1',
               postbackData: 'card_1',
            }
         }
      ],
      media: {
         height: 'MEDIUM',
         contentInfo: {
            fileUrl: card1Image,
            forceRefresh: false,
         },
      },
   },
   {
      title: 'Card #2',
      description: 'The description for card #2',
      suggestions: [
         {
            reply: {
               text: 'Card #2',
               postbackData: 'card_2',
            }
         }
      ],
      media: {
         height: 'MEDIUM',
         contentInfo: {
            fileUrl: card2Image,
            forceRefresh: false,
         },
      },
   },
];

// Definition of carousel card
let params = {
   msisdn: '[phone]',
   cardContents: cardContents,
};

// Send the device the carousel card defined above
rbmApiHelper.sendCarouselCard(params, function(response) {
   console.log(response);
});

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

জাভা

import com.google.api.services.rcsbusinessmessaging.v1.model.CardContent;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.cards.CardOrientation;
import com.google.rbm.cards.CardWidth;
import com.google.rbm.cards.MediaHeight;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
            // Create an instance of the RBM API helper
            RbmApiHelper rbmApiHelper = new RbmApiHelper();

            List cardContents = new ArrayList();

            // Images for the carousel cards
            String card1Image = "https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg";

            // Create suggestions for first carousel card
            List card1Suggestions = new ArrayList();
            card1Suggestions.add(
                new SuggestionHelper("Card #1", "card_1"));

            cardContents.add(
                new StandaloneCardHelper(
                    "Card #1",
                    "The description for card #1",
                    card1Image,
                    card1Suggestions)
                    .getCardContent(MediaHeight.SHORT)
            );

            // Images for the carousel cards
            String card2Image = "https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg";

            // Create suggestions for second carousel card
            List card2Suggestions = new ArrayList();
            card2Suggestions.add(
                new SuggestionHelper("Card #2", "card_2"));

            cardContents.add(
                new StandaloneCardHelper(
                    "Card #2",
                    "The description for card #2",
                    card2Image,
                    card2Suggestions)
                    .getCardContent(MediaHeight.SHORT)
            );

            // Send the carousel to the user
            rbmApiHelper.sendCarouselCards(cardContents, CardWidth.MEDIUM, "[phone]");
        } catch(Exception e) {
            e.printStackTrace();
        }

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

পাইথন

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Images for the carousel cards
card_image_1 = 'https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg';
card_image_2 = 'https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg';

# Suggested replies to be used in the cards
suggestions1 = [
      messages.SuggestedReply('Card #1', 'reply:card_1')
]

suggestions2 = [
      messages.SuggestedReply('Card #2', 'reply:card_2')
]

# Define the card contents for a carousel with two cards,
# each with one suggested reply
card_contents = []
card_contents.append(messages.CardContent('Card #1',
                                          'The description for card #1',
                                          card_image_1,
                                          'MEDIUM',
                                          suggestions1))

card_contents.append(messages.CardContent('Card #2',
                                          'The description for card #2',
                                          card_image_2,
                                          'MEDIUM',
                                          suggestions2))

# Send the device the carousel card defined above
carousel_card = messages.CarouselCard('MEDIUM', card_contents)
cluster = messages.MessageCluster().append_message(carousel_card)
cluster.send_to_msisdn('[phone]')

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।

সি#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
using RCSBusinessMessaging.Cards;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Image references to be used in the carousel cards
string card1Image = "https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg";
string card2Image = "https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg";

// Suggestion chip lists to be used in carousel cards
List<Suggestion> suggestions1 = new List<Suggestion>
{
   new SuggestionHelper("Card #1", "card_1").SuggestedReply()
};

List<Suggestion> suggestions2 = new List<Suggestion>
{
   new SuggestionHelper("Card #2", "card_2").SuggestedReply()
};

// Create the card content for the carousel
List<CardContent> cardContents = new List<CardContent>
{
   // Add items as card content
   new StandaloneCardHelper(
                    "Card #1",
                    "The description for card #1",
                    card1Image,
                    suggestions1).GetCardContent(),
   new StandaloneCardHelper(
                    "Card #2",
                    "The description for card #2",
                    card2Image,
                    suggestions2).GetCardContent()
};

// Send the carousel to the user
rbmApiHelper.SendCarouselCards(cardContents, CardWidth.MEDIUM, msisdn);

এই কোডটি একটি RBM নমুনা এজেন্টের একটি উদ্ধৃতি।