RCS for Business এজেন্টরা বার্তা আদান-প্রদানের মাধ্যমে ব্যবহারকারীদের সাথে যোগাযোগ করে। ব্যবহারকারীদের কাছে বার্তা পাঠাতে, আপনার এজেন্ট RCS Business Messaging API-এর কাছে বার্তার অনুরোধ পাঠায়। একটি অনুরোধে টেক্সট , রিচ কার্ড , মিডিয়া ও পিডিএফ ফাইল , প্রস্তাবিত উত্তর এবং প্রস্তাবিত কার্যকলাপ অন্তর্ভুক্ত থাকতে পারে।
মেসেজ ডেলিভারি পরিচালনায় আপনাকে সাহায্য করার জন্য, RCS for Business প্ল্যাটফর্মটি নির্দিষ্ট কিছু পরিস্থিতিতে এরর প্রদর্শন করে:
- যদি আপনি এমন কোনো ব্যবহারকারীকে বার্তা পাঠান যার ডিভাইস RCS সমর্থন করে না বা যেখানে RCS সক্রিয় করা নেই, তাহলে RCS for Business প্ল্যাটফর্মটি একটি 404 NOT_FOUND ত্রুটি ফেরত দেয়। এই ক্ষেত্রে, আপনি আপনার পরিকাঠামোতে সংজ্ঞায়িত ফলব্যাক পদ্ধতিগুলোর মাধ্যমে ব্যবহারকারীর কাছে পৌঁছানোর চেষ্টা করতে পারেন।
- যদি আপনি এমন কোনো নেটওয়ার্কের RCS ব্যবহারকারীকে বার্তা পাঠান যেখানে আপনার এজেন্ট এখনও চালু হয়নি, অথবা যেখানে RCS ট্র্যাফিক সক্রিয় করা হয়নি, তাহলে RCS for Business প্ল্যাটফর্মটি একটি 404 NOT_FOUND ত্রুটি ফেরত দেয়।
- যদি আপনি এমন কোনো বৈশিষ্ট্যসহ বার্তা পাঠান যা ব্যবহারকারীর ডিভাইস সমর্থন করে না, তাহলে RCS for Business প্ল্যাটফর্মটি 400 INVALID_ARGUMENT ত্রুটি ফেরত দেয় এবং আপনার বার্তাটি পৌঁছে দেয় না।
আপনার মাল্টি-চ্যানেল মেসেজিং কৌশলের অংশ হিসেবে, একটি যুক্তিসঙ্গত সময়ের পরেও ডেলিভারি না হওয়া মেসেজগুলো প্রত্যাহার করে অন্য কোনো চ্যানেলের মাধ্যমে পাঠানোই শ্রেয়। একটি পূর্বনির্ধারিত সময়ে স্বয়ংক্রিয়ভাবে মেসেজ প্রত্যাহার করতে, একটি মেসেজ এক্সপায়ারেশন (মেসেজ এক্সপায়ারেশন) সেট করুন।
প্রাপক অফলাইনে আছেন
প্রাপক অফলাইনে থাকলেও RCS for Business প্ল্যাটফর্মটি ডেলিভারির জন্য মেসেজ গ্রহণ করে। আপনি একটি 200 OK রেসপন্স পাবেন এবং RCS for Business প্ল্যাটফর্মটি মেসেজটি ধরে রাখে ও ৩০ দিনের জন্য পুনরায় ডেলিভারির চেষ্টা করে। মেসেজটি আবার পাঠানোর জন্য RCS for Business-কে অনুরোধ করার কোনো প্রয়োজন নেই।
RCS for Business জমা দেওয়ার ৩০ দিন পর যেকোনো ডেলিভারি না হওয়া মেসেজ মুছে দেয়।
আপনার এজেন্টের ব্যবহারের ধরনের ওপর নির্ভর করে, আপনি এই ৩০-দিনের সময়সীমার আগেই একটি ডেলিভারি না হওয়া মেসেজ প্রত্যাহার করতে চাইতে পারেন। প্রত্যাহারের ফলে অফলাইন ব্যবহারকারীরা অনলাইনে ফিরে আসার পর একটি পুরনো মেসেজ পাওয়া থেকে বিরত থাকতে পারেন। একটি মেসেজ প্রত্যাহার করার একাধিক উপায় রয়েছে:
- বাতিলকরণ কার্যকর করতে একটি বাতিলকরণ অনুরোধ পাঠান ।
- উপযুক্ত সময়ে বার্তাটি স্বয়ংক্রিয়ভাবে বাতিল করার জন্য একটি বার্তা মেয়াদোত্তীর্ণের সময় নির্ধারণ করুন ।
বার্তার মেয়াদ শেষ হওয়ার সময় নির্ধারণ করুন
আপনার এজেন্টের মেসেজ কি সময়-সংবেদনশীল? উদাহরণস্বরূপ, ওটিপি (OTP) শুধুমাত্র অল্প সময়ের জন্য বৈধ থাকে। সীমিত-সময়ের অফারগুলোর মেয়াদ শেষ হয়ে যায়। এবং অ্যাপয়েন্টমেন্টের তারিখের পরে অ্যাপয়েন্টমেন্ট রিমাইন্ডারগুলো আর প্রাসঙ্গিক থাকে না। মেসেজগুলোকে সময়োপযোগী এবং প্রাসঙ্গিক রাখতে, একটি মেসেজ এক্সপায়ারেশন বা মেয়াদ শেষ হওয়ার সময় নির্ধারণ করুন। এটি অফলাইন ব্যবহারকারীদের অনলাইনে ফিরে আসার পর পুরনো বা বাসি কন্টেন্ট পাওয়া থেকে বিরত রাখতে পারে। মেয়াদ শেষ হওয়ার সময়টি আপনার ফলব্যাক মেসেজিং কৌশল চালু করার জন্যও একটি ভালো সংকেত, যাতে ব্যবহারকারীরা সময়মতো তাদের প্রয়োজনীয় তথ্য পান।
মেসেজের মেয়াদ নির্ধারণ করতে, এজেন্ট মেসেজে নিম্নলিখিত ফিল্ডগুলির মধ্যে একটি নির্দিষ্ট করুন:
-
expireTime: UTC অনুযায়ী সঠিক সময়, যখন বার্তাটির মেয়াদ শেষ হবে। -
ttl(টাইম টু লিভ): বার্তাটির মেয়াদ শেষ হওয়ার আগের সময়কাল।
ফরম্যাটিং এবং মানের বিকল্পগুলির জন্য, AgentMessage দেখুন।
বার্তা জমা দেওয়ার পর ttl এবং expireTime এর সর্বোচ্চ মান হলো ১৫ দিন ।
যদিও ttl এবং expireTime কোনো সর্বনিম্ন মান নেই, তবুও বার্তা জমা দেওয়ার অন্তত ১০ সেকেন্ড পর এটি চালু রাখার পরামর্শ দেওয়া হয়, যাতে প্রত্যাহার এবং বিতরণ উভয়টির বিজ্ঞপ্তি পাওয়ার সম্ভাবনা উল্লেখযোগ্যভাবে হ্রাস পায়।
একটি বার্তার জন্য বাঁচার সময় (TTL)
যখন আপনি একটি RCS for Business মেসেজের জন্য TTL সেট করেন, তখন আপনি নির্দিষ্ট করে দেন যে মেসেজটি কতক্ষণ পর্যন্ত বৈধ এবং ডেলিভারিযোগ্য বলে বিবেচিত হবে। যদি এই TTL সময়ের মধ্যে মেসেজটি ব্যবহারকারীর ডিভাইসে সফলভাবে ডেলিভারি না হয়, তাহলে RCS for Business প্ল্যাটফর্মটি স্বয়ংক্রিয়ভাবে এটি বাতিল করার চেষ্টা করে।
যখন আপনি কোনো বার্তা প্রত্যাহারের উদ্যোগ নেন, তখন আপনি RCS for Business প্ল্যাটফর্মকে সেই নির্দিষ্ট বার্তাটির ডেলিভারির চেষ্টা বন্ধ করার জন্য অনুরোধ করেন। তবে, এই পদক্ষেপটি শুধুমাত্র ভবিষ্যতের ডেলিভারির প্রচেষ্টাগুলোকেই প্রভাবিত করে। যদি কোনো ব্যবহারকারীর ডিভাইস ইতোমধ্যে সফলভাবে বার্তাটি গ্রহণ করে ফেলে, বার্তাটি প্রক্রিয়াকরণাধীন থাকে, এবং RCS for Business প্ল্যাটফর্ম ব্যবহারকারীর ডিভাইস থেকে বার্তাটি প্রত্যাহার করতে পারে না।
নোটিফিকেশন সম্পর্কে যা আশা করা যায় তা নিচে দেওয়া হলো:
TTL-এর মধ্যে বার্তা পৌঁছে গেলে: যদি ব্যবহারকারীর ডিভাইস TTL শেষ হওয়ার আগেই অনলাইনে আসে এবং বার্তাটি গ্রহণ করে, তাহলে আপনি একটি
DELIVEREDনোটিফিকেশন পাবেন। কোনো বাতিলকরণ নোটিফিকেশন পাঠানো হবে না, কারণ বার্তাটি সফলভাবে পৌঁছে গেছে। এটিই সবচেয়ে সাধারণ এবং প্রত্যাশিত পরিস্থিতি।TTL শেষ হওয়ার আগে মেসেজ ডেলিভারি হয়নি: যদি মেসেজটি ব্যবহারকারীর ডিভাইসে পৌঁছানোর আগেই TTL-এর মেয়াদ শেষ হয়ে যায় (উদাহরণস্বরূপ, ডিভাইসটি অফলাইন থাকলে), তাহলে RCS for Business প্ল্যাটফর্মটি মেসেজটি বাতিল করার চেষ্টা করে। আপনি একটি
TTL_EXPIRATION_REVOKEDনোটিফিকেশন পাবেন, যা নির্দেশ করে যে মেসেজটি ডেলিভারি কিউ থেকে সফলভাবে সরানো হয়েছে। এই ক্ষেত্রে, ব্যবহারকারী মেসেজটি পাবেন না।
প্রান্তিক পরিস্থিতি মোকাবেলার জন্য সুপারিশসমূহ
আমাদের সিস্টেম RCS for Business মেসেজ ডেলিভারি এবং TTL মেয়াদোত্তীর্ণ হওয়াকে সমান্তরালভাবে প্রক্রিয়া করে। এই কারণে, খুব কম ক্ষেত্রেই আপনি এমন ব্যতিক্রমী পরিস্থিতি দেখতে পারেন যেখানে নোটিফিকেশনের সময় অপ্রত্যাশিত হয়। উদাহরণস্বরূপ, আপনি ডেলিভারি এবং TTL উভয় নোটিফিকেশনই পেতে পারেন, অথবা কোনোটিই নাও পেতে পারেন।
RCS for Business মেসেজ নোটিফিকেশন পরিচালনার জন্য আমাদের সুপারিশগুলো নিচে দেওয়া হলো:
DELIVEREDনোটিফিকেশন: আপনি যদি কোনো মেসেজের জন্য একটিDELIVEREDনোটিফিকেশন পান, তবে এটি নিশ্চিত করে যে মেসেজটি ব্যবহারকারীর কাছে পৌঁছেছে। আপনি সেই নির্দিষ্ট মেসেজটির জন্য পরবর্তী যেকোনো TTL নোটিফিকেশন নিরাপদে উপেক্ষা করতে পারেন।TTL_EXPIRATION_REVOKEDনোটিফিকেশন: যদি আপনিTTL_EXPIRATION_REVOKEDস্ট্যাটাস সহ একটি TTL নোটিফিকেশন পান, তার মানে হলো RCS for Business সিস্টেম সেই নির্দিষ্ট মেসেজটি ডেলিভারি করার চেষ্টা বন্ধ করে দিয়েছে। আপনার এই মেসেজটিকে ডেলিভারি না হওয়া হিসেবে গণ্য করা উচিত এবং প্রয়োজনে আপনার ফলব্যাক কৌশল অনুসরণ করা উচিত।অন্য কোনো স্ট্যাটাস সহ TTL নোটিফিকেশন: আপনি যদি অন্য কোনো স্ট্যাটাস সহ একটি TTL নোটিফিকেশন পান, তাহলে এটি একটি অসম্পূর্ণ প্রত্যাহারের প্রচেষ্টা নির্দেশ করে।
- ওয়ান-টাইম পাসওয়ার্ড (OTP)-এর মতো গুরুত্বপূর্ণ বার্তাগুলির জন্য আপনার বিকল্প পদ্ধতিটি চালু করুন।
- অ-গুরুত্বপূর্ণ বার্তাগুলির জন্য, ফলব্যাক শুরু করা হবে কি না, সে বিষয়ে সিদ্ধান্ত নিন।
- কোনো নোটিফিকেশন নেই: কিছু বিরল ক্ষেত্রে, সিস্টেম TTL নোটিফিকেশন পাঠাতে ব্যর্থ হতে পারে এবং ক্লায়েন্টও ডেলিভারি নোটিফিকেশন তৈরি করতে ব্যর্থ হতে পারে। এটি একটি অত্যন্ত বিরল ঘটনা।
মেসেজ ট্র্যাফিকের ধরণ সেট করুন
RBM API-তে মেসেজগুলোকে শ্রেণিবদ্ধ করার জন্য একটি messageTrafficType ফিল্ড রয়েছে। যদিও এজেন্ট ইউজ কেসগুলো এজেন্টের আচরণ এবং কোন ব্যবসায়িক নিয়মগুলো প্রযোজ্য হবে তা নির্ধারণ করে, messageTrafficType মেসেজের বিষয়বস্তুকে আরও বিস্তারিতভাবে শ্রেণিবদ্ধ করার সুযোগ দেয়। ফলস্বরূপ, এটি একটিমাত্র এজেন্টকে একাধিক ইউজ কেস পরিচালনা করতে সক্ষম করে। বর্তমানে বিদ্যমান এজেন্ট ইউজ কেস বা ব্যবসায়িক নিয়মগুলোর উপর এর কোনো প্রভাব নেই।
এই ফিল্ডটি ঐচ্ছিক, কিন্তু এখনই এটি সেট করার পরামর্শ দেওয়া হচ্ছে, যাতে ফিল্ডটি আবশ্যক হয়ে গেলে আপনি কোনো ত্রুটি বার্তা না পান।
মেসেজ ট্র্যাফিক টাইপ সেট করতে, প্রতিটি মেসেজের বিষয়বস্তুর উপর ভিত্তি করে সেটির জন্য উপযুক্ত messageTrafficType নির্ধারণ করুন। RCS for Business নিম্নলিখিত ট্র্যাফিক টাইপগুলো সমর্থন করে।
| ট্র্যাফিকের ধরন | বার্তার বিষয়বস্তু | এজেন্ট ব্যবহারের ক্ষেত্র |
|---|---|---|
AUTHENTICATION | প্রমাণীকরণ বার্তাগুলির জন্য। | ওটিপি |
TRANSACTION | ব্যবহারকারীর বিদ্যমান পরিষেবা বা পণ্য সম্পর্কিত বার্তার জন্য। যেমন: নিশ্চিতকরণ, অর্থপ্রদানের রসিদ, বা বুকিংয়ের বিবরণ। | লেনদেনমূলক বা বহুবিধ ব্যবহার |
PROMOTION | অফার, ছাড়, ঘোষণা বা অন্যান্য প্রচারমূলক বার্তার জন্য। | প্রচারমূলক বা বহুমুখী ব্যবহার |
SERVICEREQUEST | যেসব পরিষেবার জন্য ব্যবহারকারী স্পষ্টভাবে অনুরোধ করেছেন, সেই পরিষেবা সম্পর্কিত বার্তাগুলির জন্য। | ওটিপি, লেনদেনমূলক, প্রচারমূলক, বা একাধিক ব্যবহার |
ACKNOWLEDGEMENT | ব্যবহারকারীর কোনো পদক্ষেপ—বিশেষত আনসাবস্ক্রাইব করার অনুরোধ—স্বীকার করার জন্য ব্যবহৃত বার্তাগুলোর ক্ষেত্রে এটি নিশ্চিত করে যে, ব্যবহারকারীর অনুরোধটি গৃহীত হয়েছে এবং তা প্রক্রিয়াধীন রয়েছে। | ওটিপি, লেনদেনমূলক, প্রচারমূলক, বা একাধিক ব্যবহার |
যদি কোনো ট্র্যাফিক টাইপ সেট করা না থাকে, তাহলে সিস্টেম এজেন্টের ব্যবহারের ক্ষেত্রের জন্য ডিফল্ট টাইপটি নির্ধারণ করে দেয়।
| এজেন্ট ব্যবহারের ক্ষেত্র | ডিফল্ট ট্র্যাফিকের ধরণ |
|---|---|
| ওটিপি | AUTHENTICATION |
| লেনদেনমূলক | TRANSACTION |
| প্রচারমূলক | PROMOTION |
| বহুমুখী ব্যবহার | MESSAGE_TRAFFIC_TYPE_UNSPECIFIED |
মাল্টি-ইউজ এজেন্টদের কোনো ডিফল্ট ট্র্যাফিক টাইপ নেই। আপনাকে প্রতিটি মেসেজের বিষয়বস্তুর উপর ভিত্তি করে তার জন্য ট্র্যাফিক টাইপ স্পষ্টভাবে সেট করতে হবে। আপনি যদি MESSAGE_TRAFFIC_TYPE_UNSPECIFIED ভ্যালুটি প্রতিস্থাপন না করেন, তাহলে একটি এরর দেখা দেবে।
বার্তার আকারের সীমা
সম্পূর্ণ স্ট্রিং-এ রূপান্তরিত AgentMessage- টির সর্বোচ্চ আকার ২৫০ কিলোবাইট। মেসেজটির টেক্সট অংশের নিজস্ব সীমা ৩০৭২ অক্ষর।
ব্যবহারকারীদের জন্য অপ্রত্যাশিত ডেটা খরচ রোধ করতে, RCS for Business-এর মাধ্যমে পাঠানো ফাইলের সর্বোচ্চ আকার হলো ১০০ MiB, এবং একটিমাত্র RCS for Business মেসেজের মধ্যে থাকা সমস্ত মিডিয়া ও পিডিএফ অ্যাটাচমেন্টের মোট সম্মিলিত আকার অবশ্যই ১০০ MiB-এর বেশি হবে না। (১ MiB = ১,০৪৮,৫৭৬ বাইট)। আরও তথ্যের জন্য, মিডিয়া এবং পিডিএফ ফাইল অংশটি দেখুন।
পাঠ্য
সবচেয়ে সহজ বার্তাগুলো টেক্সট বা লিখিত আকারে তৈরি হয়। কোনো দৃশ্য, জটিল মিথস্ক্রিয়া বা প্রতিক্রিয়ার প্রয়োজন ছাড়াই তথ্য আদান-প্রদানের জন্য টেক্সট মেসেজ সবচেয়ে উপযুক্ত।
উদাহরণ
নিম্নলিখিত কোডটি একটি সাধারণ টেক্সট মেসেজ পাঠায়। ফরম্যাটিং এবং ভ্যালু অপশনের জন্য 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!" }, "messageTrafficType": "PROMOTION" }'
নোড.জেএস
// Reference to RBM API helper const rbmApiHelper = require('@google/rcsbusinessmessaging'); let params = { messageText: 'Hello, world!', msisdn: '+12223334444', }; // Send a simple message to the device rbmApiHelper.sendMessage(params, function(response) { console.log(response); });
জাভা
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!", "+12223334444" ); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444')
সি#
using RCSBusinessMessaging; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation, projectId); rbmApiHelper.SendTextMessage( "Hello, world!", "+12223334444", );
বার্তার মূল বিষয়বস্তু - এসএমএস-এর রূপান্তর
এসএমএস বার্তাগুলোকে আরসিএস ফর বিজনেস-এ স্থানান্তরের জন্য পরিষেবা প্রদানকারীরা বিলিং মডেল চালু করেছে। ১৬০টি পর্যন্ত ইউটিএফ-৮ অক্ষর ধারণকারী একটি আরসিএস ফর বিজনেস বার্তাকে বেসিক মেসেজ বলা হয়।
বেসিক মেসেজ পাঠানোর জন্য রিকোয়েস্ট তৈরি করার সময় মনে রাখবেন যে, প্রতিটি ক্যারেক্টারকে ১ বাইট (UTF-8) হিসেবে গণনা করা হয়। যদি আপনি ইমোজি বা মাল্টি-বাইট ক্যারেক্টার সেটের মতো বিশেষ ক্যারেক্টারযুক্ত কোনো মেসেজ পাঠান, তাহলে প্রতিটি ক্যারেক্টারকে ২-৪টি বা তার বেশি UTF-8 ক্যারেক্টার হিসেবে গণনা করা হবে।
এর দৈর্ঘ্য যাচাই করতে বক্সে কিছু লেখা লিখুন:
টেক্সট মেসেজের বিষয়বস্তু এবং লিঙ্কের প্রিভিউ
আরসিএস ক্লায়েন্টরা লিঙ্ক প্রিভিউ প্রয়োগ করতে পারে। যদি কোনো টেক্সট-অনলি আরসিএস ফর বিজনেস মেসেজে ওপেনগ্রাফ ট্যাগসহ কোনো ওয়েবসাইটের ইউআরএল অন্তর্ভুক্ত থাকে, তাহলে ক্লায়েন্ট একটি প্রিভিউ (ছবি, শিরোনাম, ইত্যাদি) তৈরি করতে পারে, যা আরও সমৃদ্ধ অভিজ্ঞতা প্রদান করে। উদাহরণস্বরূপ, ইউআরএল প্রিভিউসহ একটি সাধারণ মেসেজ দেখুন।
মনে রাখবেন যে, আরসিএস ক্লায়েন্ট ব্যবহারকারীকে লিঙ্ক প্রিভিউ নিষ্ক্রিয় করার অনুমতি দিতে পারে।
ব্যবহারকারী যাচাইকরণের জন্য এককালীন পাসওয়ার্ড
আপনি SMS Retriever API ব্যবহার করে স্বয়ংক্রিয় ব্যবহারকারী যাচাইকরণের জন্য ওয়ান-টাইম পাসওয়ার্ড (OTP) পাঠাতে RCS for Business ব্যবহার করতে পারেন। RCS for Business-এর মাধ্যমে আসা OTP পড়ার জন্য কোনো নির্দিষ্ট API নেই।
অ্যান্ড্রয়েডের জন্য এটি কীভাবে কাজ করে
যেসব অ্যান্ড্রয়েড অ্যাপ SMS Retriever API- তে রেজিস্টার করেছে, সেই অ্যাপগুলো একটি সঠিকভাবে ফরম্যাট করা RCS for Business মেসেজের জন্য অপেক্ষা করে। এই মেসেজটিতে অবশ্যই OTP এবং আপনার অ্যাপকে শনাক্তকারী একটি অনন্য হ্যাশ থাকতে হবে।
যখন সঠিক ফরম্যাটে একটি RCS for Business মেসেজ আসে, তখন SMS Retriever API সেটিকে ঠিক একটি SMS OTP-এর মতোই প্রসেস করে। হ্যাশটি আপনার অ্যাপের সাথে মিলে যাওয়ার পর, OTP-টি বের করে স্বয়ংক্রিয় ব্যবহারকারী যাচাইকরণের জন্য আপনার অ্যাপে পাঠিয়ে দেওয়া হয়।
- ব্যবহারকারী যাচাইকরণের জন্য ব্যবসায়িক আরসিএস-এর একটি নমুনা টেক্সট মেসেজ:
Your code is <OTP><app hash>. - উদাহরণ:
Your code is 123456 M8tue43FGT.
এসএমএস রিট্রিভার এবং সম্পর্কিত এপিআইগুলো সম্পর্কে আরও জানতে, এসএমএস রিট্রিভার ডকুমেন্টেশন দেখুন। এসএমএস রিট্রিভার এপিআই-এর সাথে নিবন্ধিত অ্যাপগুলোতে স্বয়ংক্রিয় ব্যবহারকারী যাচাইকরণ সম্পর্কে বিস্তারিত জানতে, এই ফ্লো ডায়াগ্রামটি দেখুন।
iOS-এর জন্য এটি কীভাবে কাজ করে
iOS-এর ক্ষেত্রে, সিস্টেমের বিল্ট-ইন OTP হ্যান্ডলিং স্বয়ংক্রিয়ভাবে RCS for Business OTP শনাক্ত করে এবং SMS OTP-এর মতোই অটো-ফিলের জন্য সেগুলোর পরামর্শ দেয়। iOS অ্যাপটির OTP পড়ার জন্য কোনো নির্দিষ্ট API ইন্টিগ্রেশনের প্রয়োজন হয় না।
মিডিয়া এবং পিডিএফ ফাইল
যখন আপনি কোনো ছবি, ভিডিও, অডিও বা পিডিএফ ফাইলসহ বার্তা পাঠান, তখন আপনার এজেন্টকে অবশ্যই কন্টেন্টটির জন্য একটি সর্বজনীনভাবে প্রবেশযোগ্য ইউআরএল প্রদান করতে হবে অথবা সরাসরি ফাইলটি আপলোড করতে হবে।
প্রেরণযোগ্য ফাইলের সর্বোচ্চ আকার হলো ১০০ MiB, এবং একটি বার্তার মধ্যে থাকা সমস্ত মিডিয়া ও পিডিএফ সংযুক্তিগুলোর মোট সম্মিলিত আকার ১০০ MiB-এর বেশি হওয়া যাবে না।
থাম্বনেইল স্পেসিফিকেশন
মিডিয়া ফাইলের জন্য, আপনি একটি থাম্বনেইল ছবিও নির্দিষ্ট করতে পারেন, যা ব্যবহারকারীদের ক্লিক করার আগে বিষয়বস্তুটির প্রিভিউ দেখতে দেয়। অডিও ফাইলের জন্য, ডিফল্ট অডিও উইজেটটি একটি প্লেসহোল্ডার হিসেবে ব্যবহৃত হয়।
- একটি থাম্বনেইলের সর্বোচ্চ ফাইলের আকার হলো ১০০ কিলোবাইট। ব্যবহারকারীর সর্বোত্তম অভিজ্ঞতার জন্য, আমরা এর আকার ৫০ কিলোবাইট বা তার কম রাখার পরামর্শ দিই।
- থাম্বনেইলের অ্যাস্পেক্ট রেশিও মূল ফাইলের রেশিওর সাথে মিলতে হবে।
ক্যাশিং এবং ইউআরএল ব্যবস্থাপনা
RCS for Business প্ল্যাটফর্মটি ৬০ দিনের জন্য ফাইল ক্যাশ করে রাখে এবং এপিআই একটি ফাইল আইডি ফেরত দেয়, যা আপনার এজেন্ট ব্যবহারকারীদের পাঠানো মেসেজে অন্তর্ভুক্ত করতে পারে। ৬০ দিন পর, RCS for Business ক্যাশ থেকে ফাইলগুলো মুছে ফেলে।
URL দ্বারা ফাইল নির্দিষ্ট করার সময়, contentMessage.forceRefresh কে false সেট করাই উত্তম। contentMessage.forceRefresh কে true সেট করলে, RCS for Business নির্দিষ্ট URL থেকে নতুন কন্টেন্ট আনতে বাধ্য হয়, এমনকি যদি 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 } } }'
নোড.জেএস
// 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: '+12223334444', }; // Send an image/video to a device rbmApiHelper.sendMessage(params, function(response) { console.log(response); });
জাভা
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, "+12223334444"); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444')
সি#
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, "+12223334444");
বিকল্পভাবে, আপনি 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 JSONcurl -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 JSONcurl -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" } } }'
সমর্থিত মিডিয়া প্রকার
RCS for Business নিম্নলিখিত মিডিয়া টাইপগুলো সাপোর্ট করে। থাম্বনেইলের জন্য শুধুমাত্র image/jpeg, image/jpg, image/gif, এবং image/png সমর্থিত।
| মিডিয়ার ধরণ | নথির ধরন | সম্প্রসারণ | রিচ কার্ডের সাথে কাজ করে |
|---|---|---|---|
| অ্যাপ্লিকেশন/ওজিজি | ওজিজি অডিও | .ogx | না |
| অ্যাপ্লিকেশন/পিডিএফ | পিডিএফ | হ্যাঁ (শুধুমাত্র ভারতে গুগল মেসেজের জন্য) | |
| অডিও/এএসি | এএসি অডিও | .aac | না |
| অডিও/এমপি৩ | MP3 অডিও | .mp3 | না |
| অডিও/এমপিইজি | এমপিইজি অডিও | .mpeg | না |
| অডিও/এমপিজি | এমপিজি অডিও | .mp3 | না |
| অডিও/এমপি৪ | MP4 অডিও | .mp4 | না |
| অডিও/mp4-latm | MP4-latm অডিও | .mp4 | না |
| অডিও/3gpp | 3GPP অডিও | .3gp | না |
| ছবি/জেপিইজি | জেপিইজি | .jpeg, .jpg | হ্যাঁ |
| ছবি/জিআইএফ | জিআইএফ | .gif | হ্যাঁ |
| ছবি/পিএনজি | পিএনজি | .png | হ্যাঁ |
| ভিডিও/এইচ২৬৩ | H263 ভিডিও | .h263 | হ্যাঁ |
| ভিডিও/m4v | M4V ভিডিও | .m4v | হ্যাঁ |
| ভিডিও/এমপি৪ | MP4 ভিডিও | .mp4 | হ্যাঁ |
| ভিডিও/এমপিইজি৪ | MPEG-4 ভিডিও | .mp4, .m4p | হ্যাঁ |
| ভিডিও/এমপিইজি | এমপিইজি ভিডিও | .mpeg | হ্যাঁ |
| ভিডিও/ওয়েবএম | ওয়েবম ভিডিও | .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" } } ] } }'
নোড.জেএস
// 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: '+12223334444', suggestions: suggestions, }; // Send a simple message with suggestion chips to the device rbmApiHelper.sendMessage(params, function(response) { console.log(response); });
জাভা
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!", "+12223334444", suggestions ); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444')
সি#
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!", "+12223334444", suggestions );
প্রস্তাবিত পদক্ষেপ
সাজেস্টেড অ্যাকশনগুলো ব্যবহারকারীদের ডিভাইসের অন্তর্নির্মিত কার্যকারিতা ব্যবহার করে কথোপকথনে পথ দেখায়। আপনার এজেন্ট ব্যবহারকারীদের একটি নম্বর ডায়াল করতে, ম্যাপে কোনো অবস্থান খুলতে, কোনো লোকেশন শেয়ার করতে, একটি ইউআরএল খুলতে বা ক্যালেন্ডারে একটি ইভেন্ট তৈরি করতে পরামর্শ দিতে পারে।
প্রতিটি প্রস্তাবিত কাজের জন্য, আপনি ঐচ্ছিকভাবে একটি ফলব্যাক ইউআরএল (সর্বোচ্চ ২০৪৮ অক্ষর) প্রদান করতে পারেন। ব্যবহারকারীর ডিভাইসটি প্রস্তাবিত কাজটি সমর্থন না করলে, এই ইউআরএলটি একটি নতুন ব্রাউজার উইন্ডোতে খুলবে।
যখন কোনো ব্যবহারকারী প্রস্তাবিত কোনো অ্যাকশনে ট্যাপ করেন, তখন আপনার এজেন্ট একটি ইভেন্ট পায়, যেটিতে অ্যাকশনটির পোস্টব্যাক ডেটা থাকে ।
ফরম্যাটিং এবং মানের বিকল্পগুলির জন্য, SuggestedAction দেখুন।
একটি নম্বরে ডায়াল করুন
ডায়াল অ্যাকশনটি ব্যবহারকারীকে আপনার এজেন্ট দ্বারা নির্দিষ্ট করা একটি ফোন নম্বর ডায়াল করতে নির্দেশ দেয়। ফোন নম্বরে শুধুমাত্র অঙ্ক ( 0-9 ), যোগ চিহ্ন ( + ), তারকাচিহ্ন ( * ) এবং হ্যাশ চিহ্ন ( # ) থাকতে পারে। E.164 আন্তর্জাতিক ফরম্যাট (উদাহরণস্বরূপ, +14155555555 ) সমর্থিত, কিন্তু বাধ্যতামূলক নয়। অর্থাৎ, +14155555555 এবং 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": "+15556667777" } } } ] } }'
নোড.জেএস
// 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: '+15556667777' } } }, ]; let params = { messageText: 'Hello, world!', msisdn: '+12223334444', 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.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("+15556667777"); // 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!", "+12223334444", suggestions ); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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', '+15556667777') ] # 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('+12223334444')
সি#
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 = "+15556667777" }; // 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!", "+12223334444", suggestions );
একটি অবস্থান দেখুন
'অবস্থান দেখুন' অ্যাকশনটি ব্যবহারকারীর ডিফল্ট ম্যাপ অ্যাপে একটি অবস্থান প্রদর্শন করে। আপনি অক্ষাংশ ও দ্রাঘিমাংশ দ্বারা অথবা ব্যবহারকারীর বর্তমান অবস্থানের উপর ভিত্তি করে একটি কোয়েরির মাধ্যমে অবস্থানটি নির্দিষ্ট করতে পারেন। এছাড়াও, ম্যাপ অ্যাপে প্রদর্শিত পিনটির জন্য আপনি একটি কাস্টম লেবেল সেট করতে পারেন।
উদাহরণ
নিম্নলিখিত কোডটি একটি ভিউ লোকেশন অ্যাকশন প্রেরণ করে। ফরম্যাটিং এবং ভ্যালু অপশনগুলির জন্য, 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" } } } ] } }'
নোড.জেএস
// 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: '+12223334444', suggestions: suggestions, }; // Send a simple message with a view location suggested action rbmApiHelper.sendMessage(params, function(response) { console.log(response); });
জাভা
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!", "+12223334444", suggestions ); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444')
সি#
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!", "+12223334444", suggestions );
একটি অবস্থান শেয়ার করুন
‘শেয়ার লোকেশন’ অ্যাকশনটি ব্যবহারকারীকে আপনার এজেন্টের সাথে একটি অবস্থান শেয়ার করার সুযোগ দেয়। ব্যবহারকারী তার বর্তমান অবস্থান অথবা ম্যাপস অ্যাপ থেকে নিজে থেকে বেছে নেওয়া কোনো অবস্থান শেয়ার করতে পারেন।
উদাহরণ
নিম্নলিখিত কোডটি একটি শেয়ার লোকেশন অ্যাকশন প্রেরণ করে। ফরম্যাটিং এবং ভ্যালু অপশনগুলির জন্য, 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": {} } } ] } }'
নোড.জেএস
// 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: '+12223334444', suggestions: suggestions, }; // Send a simple message with a share location suggested action rbmApiHelper.sendMessage(params, function(response) { console.log(response); });
জাভা
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!", "+12223334444", suggestions ); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444')
সি#
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!", "+12223334444", suggestions );
একটি ইউআরএল খুলুন
ওপেন ইউআরএল অ্যাকশনটি ব্যবহারকারীদের আপনার এজেন্ট দ্বারা নির্দিষ্ট একটি ওয়েব পেজে নিয়ে যেতে সাহায্য করে। ডিফল্টরূপে, ওয়েব পেজটি ব্যবহারকারীর ব্রাউজারে খোলে। আপনি ওয়েব পেজটিকে একটি ওয়েবভিউতে খোলার জন্যও সেট করতে পারেন। বিস্তারিত জানতে ‘ওয়েবভিউ দিয়ে একটি ইউআরএল খুলুন’ দেখুন।
শুধুমাত্র গুগল মেসেজে
অন্তর্নিহিত ইউআরএল প্রদর্শন : A2P মেসেজিং-এ স্বচ্ছতা বাড়ানোর জন্য, গুগল মেসেজেস 'ওপেন এ ইউআরএল' সাজেস্টেড অ্যাকশনগুলোর মধ্যে অন্তর্নিহিত ইউআরএল অ্যাড্রেসটি প্রদর্শন করে। এই পরিবর্তনটি স্ট্যান্ডার্ড রিচ কার্ড এবং রিচ কার্ড ক্যারোসেলের সাজেস্টেড অ্যাকশনগুলোকে প্রভাবিত করে।

ওয়েব লিঙ্কের জন্য অ্যাপ আইকন প্রদর্শন : যদি কোনো ব্যবহারকারী ওয়েব পেজটির জন্য একটি ডিফল্ট অ্যাপ কনফিগার করে রাখেন, তাহলে ব্রাউজার বা ওয়েবভিউয়ের পরিবর্তে সেই অ্যাপটি খোলে এবং সাজেশন বাটনে অ্যাপটির আইকন প্রদর্শিত হয়। গুগল মেসেজে অ্যাপ আইকনটি দেখানোর জন্য, আপনাকে সম্পূর্ণ ও সরাসরি 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" } } } ] } }'
নোড.জেএস
// 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: '+12223334444', suggestions: suggestions, }; // Send a simple message with an open URL suggested action rbmApiHelper.sendMessage(params, function(response) { console.log(response); });
জাভা
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!", "+12223334444", suggestions ); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444')
সি#
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!", "+12223334444", suggestions );
ওয়েবভিউ দিয়ে একটি URL খুলুন
‘Open URL with webview’ অ্যাকশনটি আপনার ডিফল্ট ব্রাউজারের রেন্ডারিং ইঞ্জিন ব্যবহার করে নির্দিষ্ট ওয়েব পেজটিকে মেসেজিং অ্যাপের ভেতরে লোড করে। এর ফলে ব্যবহারকারী ‘RCS for Business’ কথোপকথন থেকে বের না হয়েই ওয়েব পেজটির সাথে ইন্টারঅ্যাক্ট করতে পারেন। যদি ব্যবহারকারীর ডিভাইস ওয়েবভিউ সাপোর্ট না করে, তবে ওয়েব পেজটি তার পরিবর্তে ব্যবহারকারীর ব্রাউজারে খোলে। ওয়েবভিউ সক্রিয় করতে, 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!", "+12223334444", 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" } } } ] } }'
নোড.জেএস
// 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: '+12223334444', suggestions: suggestions, }; // Send a simple message with a create calendar event suggested action rbmApiHelper.sendMessage(params, function(response) { console.log(response); });
জাভা
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!", "+12223334444", suggestions ); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444')
সি#
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!", "+12223334444", suggestions );
পরামর্শ চিপ তালিকা
আপনার এজেন্ট ব্যবহারকারীদের পরবর্তী পদক্ষেপ নির্দেশ করার জন্য বার্তার সাথে সাজেশন চিপ লিস্ট পাঠায়। চিপ লিস্টটি কেবল তখনই প্রদর্শিত হয় যখন সংশ্লিষ্ট বার্তাটি কথোপকথনের একেবারে শেষে থাকে। কথোপকথনের পরবর্তী যেকোনো বার্তা (ব্যবহারকারী বা আপনার এজেন্টের কাছ থেকে আসা) চিপ লিস্টটিকে মুছে দেয়।
তালিকার চিপগুলো হলো প্রস্তাবিত উত্তর এবং প্রস্তাবিত পদক্ষেপ ।
চিপ তালিকায় সর্বাধিক ১১টি সাজেশন চিপ থাকতে পারে এবং প্রতিটি চিপ লেবেলে সর্বাধিক ২৫টি অক্ষর থাকতে পারে।
ফরম্যাটিং এবং মানের বিকল্পগুলির জন্য, AgentContentMessage দেখুন।
রিচ কার্ডস
রিচ কার্ড একটি একক বার্তায় মিডিয়া, টেক্সট এবং ইন্টারেক্টিভ সাজেশনকে একত্রিত করে। সম্পর্কিত তথ্য (যেমন, কোনো পণ্যের ছবি, নাম ও দাম) উপস্থাপন করার জন্য এবং 'বিস্তারিত দেখুন'-এর মতো স্পষ্ট পরবর্তী পদক্ষেপের মাধ্যমে ব্যবহারকারীদের নির্দেশনা দেওয়ার জন্য এগুলো আদর্শ।
একটি রিচ কার্ডে নিম্নলিখিত বিষয়গুলো থাকতে পারে:
- মিডিয়া (ছবি বা জিআইএফ)
- শিরোনাম পাঠ্য
- বর্ণনা পাঠ্য
- প্রস্তাবিত উত্তর এবং প্রস্তাবিত পদক্ষেপ (সর্বোচ্চ ৪টি)
এই ক্ষেত্রগুলোর প্রতিটিই ঐচ্ছিক, কিন্তু রিচ কার্ডে ১–৩ নম্বর ক্ষেত্রগুলোর মধ্যে অন্তত একটি অবশ্যই অন্তর্ভুক্ত থাকতে হবে।
একাধিক কার্ড একসাথে একটি আনুভূমিকভাবে স্ক্রোলিং ক্যারোসেলে পাঠানো যেতে পারে।
উল্লেখ্য যে, একটি রিচ কার্ডের মোট পেলোড হলো ২৫০ কিলোবাইট।
সম্পূর্ণ প্রযুক্তিগত বিবরণের জন্য, রিচ কার্ডস ডকুমেন্টেশন দেখুন।
কার্ডের উচ্চতা
রিচ কার্ডগুলো তাদের ভেতরের বিষয়বস্তু অনুযায়ী উল্লম্বভাবে প্রসারিত হয়। এগুলোর সর্বনিম্ন উচ্চতা ১১২ ডিপি এবং সর্বোচ্চ উচ্চতা ৩৪৪ ডিপি। যদি কার্ডের বিষয়বস্তু সর্বনিম্ন উচ্চতা পূরণের জন্য যথেষ্ট বড় না হয়, তবে কার্ডটি প্রসারিত হয়ে অতিরিক্ত উচ্চতাটি ফাঁকা স্থান দিয়ে পূরণ করে।
রিচ কার্ডের মিডিয়াকে অবশ্যই তিনটি উচ্চতার যেকোনো একটির সাথে মানানসই হতে হবে:
- শর্ট: ১১২ ডিপি
- মাঝারি: ১৬৮ ডিপি
- লম্বা: ২৬৪ ডিপি
নির্বাচিত উচ্চতায় মিডিয়াটি কার্ডের মধ্যে আঁটলে, মিডিয়াটি জুম ও ক্রপ করে প্রিভিউ হিসেবে বেছে নেওয়া হয়।
উদাহরণ
নিম্নলিখিত কোডটি একটি ছবি এবং প্রস্তাবিত উত্তরসহ একটি রিচ কার্ড পাঠায়। ফরম্যাটিং এবং ভ্যালু অপশনের জন্য, 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" } } ] } } } } }'
নোড.জেএস
// 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: '+12223334444', suggestions: suggestions, imageUrl: imageUrl, height: 'TALL', }; // Send rich card to device rbmApiHelper.sendRichCard(params, function(response) { console.log(response); });
জাভা
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, "+12223334444"); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444')
সি#
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, "+12223334444");
রিচ কার্ড ক্যারোসেল
ক্যারোসেল একাধিক রিচ কার্ডকে একসাথে জুড়ে দেয়, যা ব্যবহারকারীদের আইটেমগুলির তুলনা করতে এবং প্রতিটির উপর আলাদাভাবে প্রতিক্রিয়া জানাতে সুযোগ করে দেয়।
একটি ক্যারোসেলে সর্বনিম্ন দুটি এবং সর্বোচ্চ দশটি রিচ কার্ড থাকতে পারে। ক্যারোসেলের ভেতরের রিচ কার্ডগুলোকে অবশ্যই রিচ কার্ডস ডকুমেন্টেশনে বর্ণিত বিষয়বস্তু এবং উচ্চতার সাধারণ আবশ্যকতাগুলো মেনে চলতে হবে। ক্যারোসেলের বিন্যাস এবং নির্দিষ্টকরণ সম্পর্কে আরও তথ্যের জন্য, ক্যারোসেল ডকুমেন্টেশন দেখুন।
উদাহরণ
নিম্নলিখিত কোডটি একটি রিচ কার্ড ক্যারোসেল প্রেরণ করে। ফরম্যাটিং এবং ভ্যালু অপশনগুলির জন্য, 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/welcome-bot-sample-images/200.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/welcome-bot-sample-images/201.jpg", "forceRefresh": false } } } ] } } } }'
নোড.জেএস
// Reference to RBM API helper const rbmApiHelper = require('@google/rcsbusinessmessaging'); // Images for the carousel cards let card1Image = 'https://storage.googleapis.com/welcome-bot-sample-images/200.jpg'; let card2Image = 'https://storage.googleapis.com/welcome-bot-sample-images/201.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: '+12223334444', cardContents: cardContents, }; // Send the device the carousel card defined above rbmApiHelper.sendCarouselCard(params, function(response) { console.log(response); });
জাভা
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/welcome-bot-sample-images/200.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/welcome-bot-sample-images/201.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, "+12223334444"); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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/welcome-bot-sample-images/200.jpg'; card_image_2 = 'https://storage.googleapis.com/welcome-bot-sample-images/201.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('+12223334444')
সি#
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/welcome-bot-sample-images/200.jpg"; string card2Image = "https://storage.googleapis.com/welcome-bot-sample-images/201.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);