ব্যবহারকারীরা যখন Google Chat-এ একটি লিঙ্ক শেয়ার করেন তখন প্রসঙ্গ পরিবর্তন রোধ করতে, আপনার Chat অ্যাপ তাদের মেসেজের সাথে একটি কার্ড সংযুক্ত করে লিঙ্কটির পূর্বরূপ দেখতে পারে যা আরও তথ্য দেয় এবং লোকেদের সরাসরি Google Chat থেকে পদক্ষেপ নিতে দেয়।
উদাহরণস্বরূপ, একটি Google চ্যাট স্পেস কল্পনা করুন যাতে একটি কোম্পানির সমস্ত গ্রাহক পরিষেবা এজেন্ট এবং Case-y নামে একটি চ্যাট অ্যাপ অন্তর্ভুক্ত থাকে। এজেন্টরা প্রায়শই চ্যাট স্পেসে কাস্টমার সার্ভিস কেসের লিঙ্ক শেয়ার করে এবং প্রতিবারই তাদের সহকর্মীদের কেস লিংক খুলতে হবে যাতে অ্যাসাইনি, স্ট্যাটাস এবং বিষয়ের মতো বিশদ বিবরণ দেখতে হয়। একইভাবে, কেউ যদি কোনও মামলার মালিকানা নিতে বা স্ট্যাটাস পরিবর্তন করতে চান তবে তাদের লিঙ্কটি খুলতে হবে।
লিংক প্রিভিউ করার মাধ্যমে স্পেসের রেসিডেন্ট চ্যাট অ্যাপ, কেস-ওয়াই, যখনই কেউ একটি কেস লিঙ্ক শেয়ার করে তখন অ্যাসাইনি, স্ট্যাটাস এবং বিষয় দেখানো একটি কার্ড সংযুক্ত করতে সক্ষম করে। কার্ডের বোতামগুলি এজেন্টদের কেসের মালিকানা নিতে এবং চ্যাট স্ট্রীম থেকে সরাসরি স্থিতি পরিবর্তন করতে দেয়।
কিভাবে লিঙ্ক প্রিভিউ কাজ করে
যখন কেউ তাদের বার্তায় একটি লিঙ্ক যোগ করে, তখন একটি চিপ উপস্থিত হয় যা তাদের জানতে দেয় যে একটি চ্যাট অ্যাপ লিঙ্কটির পূর্বরূপ দেখতে পারে।
বার্তা পাঠানোর পরে, লিঙ্কটি চ্যাট অ্যাপে পাঠানো হয়, যা তারপর ব্যবহারকারীর বার্তায় কার্ড তৈরি করে এবং সংযুক্ত করে।
লিঙ্কের পাশাপাশি, কার্ডটি বোতামের মতো ইন্টারেক্টিভ উপাদান সহ লিঙ্ক সম্পর্কে অতিরিক্ত তথ্য প্রদান করে। আপনার চ্যাট অ্যাপ ব্যবহারকারীর ইন্টারঅ্যাকশনের প্রতিক্রিয়া হিসেবে সংযুক্ত কার্ড আপডেট করতে পারে, যেমন বোতামে ক্লিক করা।
যদি কেউ চান না যে চ্যাট অ্যাপ তাদের বার্তার সাথে একটি কার্ড সংযুক্ত করে তাদের লিঙ্কের পূর্বরূপ দেখুক, তারা প্রিভিউ চিপে
ক্লিক করে প্রিভিউ করা প্রতিরোধ করতে পারে। ব্যবহারকারীরা যেকোন সময় রিমুভ প্রিভিউ এ ক্লিক করে সংযুক্ত কার্ডটি সরাতে পারেন।পূর্বশর্ত
Node.js
একটি Google চ্যাট অ্যাপ যা ইন্টারেক্টিভ বৈশিষ্ট্যের জন্য সক্ষম। একটি HTTP পরিষেবা ব্যবহার করে একটি ইন্টারেক্টিভ চ্যাট অ্যাপ তৈরি করতে, এই কুইকস্টার্টটি সম্পূর্ণ করুন।অ্যাপস স্ক্রিপ্ট
একটি Google চ্যাট অ্যাপ যা ইন্টারেক্টিভ বৈশিষ্ট্যের জন্য সক্ষম। Apps Script-এ একটি ইন্টারেক্টিভ চ্যাট অ্যাপ তৈরি করতে, এই কুইকস্টার্টটি সম্পূর্ণ করুন।লিঙ্ক প্রিভিউ কনফিগার করুন
Google ক্লাউড কনসোলে আপনার চ্যাট অ্যাপের কনফিগারেশন পৃষ্ঠায় URL প্যাটার্ন হিসাবে example.com
, support.example.com
, এবং support.example.com/cases/
মতো নির্দিষ্ট লিঙ্কগুলি নিবন্ধন করুন যাতে আপনার চ্যাট অ্যাপ তাদের পূর্বরূপ দেখতে পারে।
- গুগল ক্লাউড কনসোল খুলুন।
- "Google ক্লাউড"-এর পাশে, নিচের তীর ক্লিক করুন এবং আপনার চ্যাট অ্যাপের প্রোজেক্ট খুলুন।
- অনুসন্ধান ক্ষেত্রে,
Google Chat API
টাইপ করুন এবং Google Chat API-এ ক্লিক করুন। - পরিচালনা > কনফিগারেশন ক্লিক করুন।
- লিঙ্ক পূর্বরূপের অধীনে, একটি URL প্যাটার্ন যোগ করুন বা সম্পাদনা করুন।
- একটি নতুন URL প্যাটার্নের জন্য লিঙ্কের পূর্বরূপ কনফিগার করতে, URL প্যাটার্ন যোগ করুন ক্লিক করুন।
- একটি বিদ্যমান URL প্যাটার্নের জন্য কনফিগারেশন সম্পাদনা করতে, নিচের তীর ক্লিক করুন।
হোস্ট প্যাটার্ন ক্ষেত্রে, URL প্যাটার্নের ডোমেন লিখুন। চ্যাট অ্যাপ এই ডোমেনের লিঙ্কগুলির পূর্বরূপ দেখাবে।
একটি নির্দিষ্ট সাবডোমেনের জন্য চ্যাট অ্যাপ প্রিভিউ লিঙ্ক পেতে, যেমন
subdomain.example.com
, সাবডোমেন অন্তর্ভুক্ত করুন।পুরো ডোমেনের জন্য চ্যাট অ্যাপের প্রিভিউ লিঙ্ক পেতে, সাবডোমেন হিসেবে তারকাচিহ্ন (*) সহ একটি ওয়াইল্ডকার্ড অক্ষর উল্লেখ করুন। উদাহরণস্বরূপ,
*.example.com
subdomain.example.com
এবংany.number.of.subdomains.example.com
সাথে মেলে।পথ উপসর্গ ক্ষেত্রে, হোস্ট প্যাটার্ন ডোমেনে যুক্ত করার জন্য একটি পাথ লিখুন।
হোস্ট প্যাটার্ন ডোমেনে সমস্ত ইউআরএল মেলানোর জন্য, পাথ উপসর্গ খালি রাখুন।
উদাহরণস্বরূপ, যদি হোস্ট প্যাটার্ন হয়
support.example.com
, তাহলেsupport.example.com/cases/
এ হোস্ট করা ক্ষেত্রে URL-এর সাথে মিল রাখতে,cases/
লিখুন।সম্পন্ন ক্লিক করুন.
Save এ ক্লিক করুন।
এখন, যখনই কেউ একটি লিঙ্ক অন্তর্ভুক্ত করে যা একটি লিঙ্ক প্রিভিউ URL প্যাটার্নের সাথে মেলে এমন একটি চ্যাট স্পেসের একটি বার্তার সাথে যার মধ্যে আপনার চ্যাট অ্যাপ রয়েছে, আপনার অ্যাপ লিঙ্কটির পূর্বরূপ দেখায়।
একটি লিঙ্ক পূর্বরূপ
আপনি একটি প্রদত্ত লিঙ্কের জন্য লিঙ্ক প্রিভিউ কনফিগার করার পরে, আপনার চ্যাট অ্যাপ এটিতে আরও তথ্য সংযুক্ত করে লিঙ্কটিকে চিনতে এবং পূর্বরূপ দেখতে পারে।
চ্যাট স্পেসগুলির ভিতরে যা আপনার চ্যাট অ্যাপকে অন্তর্ভুক্ত করে, যখন কারও বার্তায় একটি লিঙ্ক থাকে যা লিঙ্কের পূর্বরূপ URL প্যাটার্নের সাথে মেলে, তখন আপনার চ্যাট অ্যাপ একটি MESSAGE
ইন্টারঅ্যাকশন ইভেন্ট পায়। ইন্টারঅ্যাকশন ইভেন্টের জন্য JSON পেলোডে matchedUrl
ক্ষেত্র রয়েছে:
JSON
"message": {
. . . // other message attributes redacted
"matchedUrl": {
"url": "https://support.example.com/cases/case123"
},
. . . // other message attributes redacted
}
MESSAGE
ইভেন্ট পেলোডে matchedUrl
ফিল্ডের উপস্থিতি পরীক্ষা করে, আপনার চ্যাট অ্যাপটি প্রিভিউ করা লিঙ্ক সহ মেসেজে তথ্য যোগ করতে পারে। আপনার চ্যাট অ্যাপটি হয় একটি সাধারণ পাঠ্য বার্তার মাধ্যমে উত্তর দিতে পারে বা একটি কার্ড সংযুক্ত করতে পারে।
একটি পাঠ্য বার্তা দিয়ে উত্তর দিন
সাধারণ প্রতিক্রিয়াগুলির জন্য, আপনার চ্যাট অ্যাপ একটি লিঙ্কে একটি সাধারণ পাঠ্য বার্তার সাথে উত্তর দিয়ে একটি লিঙ্কের পূর্বরূপ দেখতে পারে। এই উদাহরণটি এমন একটি বার্তা সংযুক্ত করে যা লিঙ্কের URLটির পুনরাবৃত্তি করে যা একটি লিঙ্কের পূর্বরূপ URL প্যাটার্নের সাথে মেলে।
Node.js
অ্যাপস স্ক্রিপ্ট
একটি কার্ড সংযুক্ত করুন
একটি পূর্বরূপ লিঙ্কে একটি কার্ড সংযুক্ত করতে, UPDATE_USER_MESSAGE_CARDS
টাইপের একটি ActionResponse
ফেরত দিন। এই উদাহরণটি একটি সাধারণ কার্ড সংযুক্ত করে।
Node.js
অ্যাপস স্ক্রিপ্ট
এই উদাহরণ কার্ড JSON ফেরত দিয়ে একটি কার্ড বার্তা পাঠায়। আপনি Apps স্ক্রিপ্ট কার্ড পরিষেবাও ব্যবহার করতে পারেন৷
একটি কার্ড আপডেট করুন
একটি প্রিভিউ করা লিঙ্কে সংযুক্ত কার্ড আপডেট করতে, UPDATE_USER_MESSAGE_CARDS
টাইপের একটি ActionResponse
ফেরত দিন। চ্যাট অ্যাপগুলি শুধুমাত্র সেই কার্ডগুলি আপডেট করতে পারে যেগুলি একটি চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টের প্রতিক্রিয়া হিসাবে লিঙ্কগুলির পূর্বরূপ দেখে। চ্যাট অ্যাপগুলি অ্যাসিঙ্ক্রোনাসভাবে Chat API কল করে এই কার্ডগুলি আপডেট করতে পারে না।
লিঙ্ক প্রিভিউ UPDATE_MESSAGE
ধরনের একটি ActionResponse
ফেরত দেওয়া সমর্থন করে না। কারণ UPDATE_MESSAGE
শুধুমাত্র কার্ডের পরিবর্তে সম্পূর্ণ বার্তা আপডেট করে, এটি শুধুমাত্র তখনই কাজ করে যদি চ্যাট অ্যাপ আসল বার্তাটি তৈরি করে। লিঙ্ক প্রিভিউ করা ব্যবহারকারীর তৈরি বার্তার সাথে একটি কার্ড সংযুক্ত করে, তাই চ্যাট অ্যাপের এটি আপডেট করার অনুমতি নেই।
চ্যাট স্ট্রীমে ব্যবহারকারীর তৈরি এবং অ্যাপ-তৈরি কার্ড উভয়ই একটি ফাংশন আপডেট করে তা নিশ্চিত করতে, চ্যাট অ্যাপ বা ব্যবহারকারী মেসেজ তৈরি করেছেন কিনা তার উপর ভিত্তি করে গতিশীলভাবে ActionResponse
সেট করুন।
- যদি কোনো ব্যবহারকারী বার্তাটি তৈরি করে থাকেন, তাহলে
ActionResponse
কেUPDATE_USER_MESSAGE_CARDS
এ সেট করুন। - যদি কোনো চ্যাট অ্যাপ বার্তাটি তৈরি করে, তাহলে
ActionResponse
কেUPDATE_MESSAGE
এ সেট করুন।
এটি করার দুটি উপায় রয়েছে: সংযুক্ত কার্ডের onclick
সম্পত্তির অংশ হিসাবে একটি কাস্টম actionMethodName
নির্দিষ্ট করা এবং পরীক্ষা করা (যা বার্তাটিকে ব্যবহারকারীর তৈরি হিসাবে চিহ্নিত করে) বা বার্তাটি কোনও ব্যবহারকারী দ্বারা তৈরি করা হয়েছে কিনা তা পরীক্ষা করা৷
বিকল্প 1: actionMethodName
চেক করুন
প্রিভিউ করা কার্ডে CARD_CLICKED
ইন্টারঅ্যাকশন ইভেন্টগুলি সঠিকভাবে পরিচালনা করতে actionMethodName
ব্যবহার করতে, সংযুক্ত কার্ডের onclick
সম্পত্তির অংশ হিসাবে একটি কাস্টম actionMethodName
সেট করুন:
JSON
. . . // Preview card details
{
"textButton": {
"text": "ASSIGN TO ME",
"onClick": {
// actionMethodName identifies the button to help determine the
// appropriate ActionResponse.
"action": {
"actionMethodName": "assign",
}
}
}
}
. . . // Preview card details
"actionMethodName": "assign"
এর সাথে, একটি ম্যাচিং actionMethodName
চেক করে গতিশীলভাবে সঠিক ActionResponse
ফেরত দেওয়া সম্ভব:
Node.js
অ্যাপস স্ক্রিপ্ট
এই উদাহরণ কার্ড JSON ফেরত দিয়ে একটি কার্ড বার্তা পাঠায়। আপনি Apps স্ক্রিপ্ট কার্ড পরিষেবাও ব্যবহার করতে পারেন৷
বিকল্প 2: প্রেরকের ধরন পরীক্ষা করুন
message.sender.type
HUMAN
বা BOT
কিনা তা পরীক্ষা করে দেখুন। HUMAN
হলে, ActionResponse
UPDATE_USER_MESSAGE_CARDS
এ সেট করুন, অন্যথায় ActionResponse
UPDATE_MESSAGE
এ সেট করুন। এখানে কিভাবে:
Node.js
অ্যাপস স্ক্রিপ্ট
এই উদাহরণ কার্ড JSON ফেরত দিয়ে একটি কার্ড বার্তা পাঠায়। আপনি Apps স্ক্রিপ্ট কার্ড পরিষেবাও ব্যবহার করতে পারেন৷
একটি কার্ড আপডেট করার একটি সাধারণ কারণ হল একটি বোতাম ক্লিকের প্রতিক্রিয়া। পূর্ববর্তী বিভাগ থেকে আমাকে বরাদ্দ করুন বোতামটি স্মরণ করুন, একটি কার্ড সংযুক্ত করুন । নীচের সম্পূর্ণ উদাহরণটি কার্ডটিকে আপডেট করে যাতে এটি বলে যে এটি "আপনি"-কে অ্যাসাইন করা হয়েছে একজন ব্যবহারকারী আমাকে অ্যাসাইন টু ক্লিক করার পরে৷ উদাহরণটি প্রেরকের ধরন পরীক্ষা করে গতিশীলভাবে ActionResponse
সেট করে।
সম্পূর্ণ উদাহরণ: Case-y গ্রাহক পরিষেবা চ্যাট অ্যাপ
এখানে Case-y-এর সম্পূর্ণ কোড দেওয়া হল, একটি চ্যাট অ্যাপ যা গ্রাহক পরিষেবা এজেন্টদের সহযোগিতা করে এমন একটি চ্যাট স্পেসে শেয়ার করা কেসগুলির লিঙ্কগুলির পূর্বরূপ দেখায়।
Node.js
অ্যাপস স্ক্রিপ্ট
এই উদাহরণ কার্ড JSON ফেরত দিয়ে একটি কার্ড বার্তা পাঠায়। আপনি Apps স্ক্রিপ্ট কার্ড পরিষেবাও ব্যবহার করতে পারেন৷
সীমা এবং বিবেচনা
আপনি আপনার চ্যাট অ্যাপের জন্য লিঙ্ক প্রিভিউ কনফিগার করার সময়, এই সীমা এবং বিবেচনাগুলি নোট করুন:
- প্রতিটি চ্যাট অ্যাপ 5টি পর্যন্ত URL প্যাটার্নের জন্য লিঙ্ক প্রিভিউ সমর্থন করে।
- চ্যাট অ্যাপস প্রতি বার্তা প্রতি একটি লিঙ্কের পূর্বরূপ। যদি একাধিক পূর্বদর্শনযোগ্য লিঙ্ক একটি একক বার্তায় উপস্থিত থাকে, তবে শুধুমাত্র প্রথম পূর্বদর্শনযোগ্য লিঙ্কের পূর্বরূপ।
- চ্যাট অ্যাপগুলি শুধুমাত্র
https://
দিয়ে শুরু হওয়া লিঙ্কগুলির পূর্বরূপ দেখায়, তাইhttps://support.example.com/cases/
previews, কিন্তুsupport.example.com/cases/
করে না৷ - স্ল্যাশ কমান্ডের মতো চ্যাট অ্যাপে পাঠানো অন্যান্য তথ্য বার্তাটিতে না থাকলে, শুধুমাত্র লিঙ্কের ইউআরএলটি চ্যাট অ্যাপে লিঙ্ক প্রিভিউ দ্বারা পাঠানো হয়।
- প্রিভিউ করা লিঙ্কগুলির সাথে সংযুক্ত কার্ডগুলি শুধুমাত্র
UPDATE_USER_MESSAGE_CARDS
ধরনের একটিActionResponse
সমর্থন করে এবং শুধুমাত্র একটি চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টের প্রতিক্রিয়ায়। লিঙ্কের পূর্বরূপগুলিUPDATE_MESSAGE
বা চ্যাট API এর মাধ্যমে একটি পূর্বরূপ দেখা লিঙ্কের সাথে সংযুক্ত কার্ড আপডেট করার জন্য অ্যাসিঙ্ক্রোনাস অনুরোধগুলিকে সমর্থন করে না৷ আরও জানতে, একটি কার্ড আপডেট করুন দেখুন। - চ্যাট অ্যাপ্লিকেশানগুলিকে অবশ্যই স্থানের প্রত্যেকের জন্য লিঙ্কগুলির পূর্বরূপ দেখতে হবে, তাই বার্তাটি অবশ্যই
privateMessageViewer
ক্ষেত্রটি বাদ দিতে হবে৷
ডিবাগ লিঙ্ক প্রিভিউ
আপনি লিঙ্ক প্রিভিউ প্রয়োগ করার সময়, আপনাকে অ্যাপের লগ পড়ে আপনার চ্যাট অ্যাপ ডিবাগ করতে হতে পারে। লগগুলি পড়তে, Google ক্লাউড কনসোলে লগ এক্সপ্লোরারে যান৷