ব্যবহারকারীরা Google Chat-এ কোনও লিঙ্ক শেয়ার করলে প্রসঙ্গ পরিবর্তন রোধ করতে, আপনার Chat অ্যাপ তাদের মেসেজে একটি কার্ড সংযুক্ত করে লিঙ্কটির প্রিভিউ দেখতে পারে যা আরও তথ্য দেয় এবং Google Chat থেকে সরাসরি পদক্ষেপ নিতে সাহায্য করে।
উদাহরণস্বরূপ, একটি গুগল চ্যাট স্পেস কল্পনা করুন যেখানে একটি কোম্পানির সমস্ত গ্রাহক পরিষেবা এজেন্ট এবং Case-y নামক একটি চ্যাট অ্যাপ রয়েছে। এজেন্টরা প্রায়শই চ্যাট স্পেসে গ্রাহক পরিষেবা মামলার লিঙ্কগুলি ভাগ করে নেয় এবং প্রতিবার তারা যখন এটি করে তখন তাদের সহকর্মীদের অ্যাসাইনি, স্ট্যাটাস এবং বিষয়ের মতো বিশদ দেখতে কেস লিঙ্কটি খুলতে হয়। একইভাবে, যদি কেউ কোনও মামলার মালিকানা নিতে বা স্ট্যাটাস পরিবর্তন করতে চায়, তাহলে তাদের লিঙ্কটি খুলতে হবে।
লিঙ্ক প্রিভিউ করার মাধ্যমে স্পেসের রেসিডেন্ট চ্যাট অ্যাপ, কেস-ওয়াই, যখনই কেউ কেস লিঙ্ক শেয়ার করে তখন অ্যাসাইনি, স্ট্যাটাস এবং বিষয় দেখানো একটি কার্ড সংযুক্ত করতে পারে। কার্ডের বোতামগুলি এজেন্টদের কেসের মালিকানা নিতে এবং চ্যাট স্ট্রিম থেকে সরাসরি স্ট্যাটাস পরিবর্তন করতে দেয়।
লিঙ্ক প্রিভিউ কিভাবে কাজ করে
যখন কেউ তাদের মেসেজে একটি লিঙ্ক যোগ করে, তখন একটি চিপ প্রদর্শিত হয় যা তাদের জানায় যে একটি চ্যাট অ্যাপ লিঙ্কটির প্রিভিউ দেখতে পারে।


বার্তা পাঠানোর পর, লিঙ্কটি চ্যাট অ্যাপে পাঠানো হয়, যা পরে কার্ডটি তৈরি করে এবং ব্যবহারকারীর বার্তার সাথে সংযুক্ত করে।


লিঙ্কের পাশাপাশি, কার্ডটি লিঙ্ক সম্পর্কে অতিরিক্ত তথ্য প্রদান করে, যার মধ্যে বোতামের মতো ইন্টারেক্টিভ উপাদানও অন্তর্ভুক্ত থাকে। আপনার চ্যাট অ্যাপ ব্যবহারকারীর ইন্টারঅ্যাকশনের প্রতিক্রিয়ায় সংযুক্ত কার্ডটি আপডেট করতে পারে, যেমন বোতাম ক্লিক।
যদি কেউ চান না যে চ্যাট অ্যাপ তাদের মেসেজে একটি কার্ড সংযুক্ত করে তাদের লিঙ্কটি প্রিভিউ করুক, তাহলে তারা প্রিভিউ চিপে ক্লিক করে প্রিভিউ প্রতিরোধ করতে পারেন। ব্যবহারকারীরা প্রিভিউ সরান ক্লিক করে যেকোনো সময় সংযুক্ত কার্ডটি সরাতে পারেন।
পূর্বশর্ত
HTTP সম্পর্কে
একটি Google Workspace অ্যাড-অন যা Google Chat কে প্রসারিত করে। এটি তৈরি করতে, HTTP কুইকস্টার্ট সম্পূর্ণ করুন।
অ্যাপস স্ক্রিপ্ট
একটি Google Workspace অ্যাড-অন যা Google Chat কে প্রসারিত করে। এটি তৈরি করতে, Apps Script quickstart সম্পূর্ণ করুন।
লিঙ্ক প্রিভিউ কনফিগার করুন
Google Cloud Console-এ আপনার Chat অ্যাপের কনফিগারেশন পৃষ্ঠায় URL প্যাটার্ন হিসেবে example.com , support.example.com , এবং support.example.com/cases/ - এর মতো নির্দিষ্ট লিঙ্কগুলি নিবন্ধন করুন যাতে আপনার Chat অ্যাপ সেগুলি প্রিভিউ করতে পারে।


- গুগল ক্লাউড কনসোলটি খুলুন।
- "গুগল ক্লাউড" এর পাশে, ডাউন অ্যারো ক্লিক করুন এবং আপনার চ্যাট অ্যাপের প্রজেক্টটি খুলুন।
- অনুসন্ধানের ক্ষেত্রে,
Google Chat APIটাইপ করুন এবং Google Chat API এ ক্লিক করুন। - পরিচালনা > কনফিগারেশন ক্লিক করুন।
- লিঙ্ক প্রিভিউ-এর অধীনে, একটি URL প্যাটার্ন যোগ বা সম্পাদনা করুন।
- নতুন URL প্যাটার্নের জন্য লিঙ্ক প্রিভিউ কনফিগার করতে, URL প্যাটার্ন যোগ করুন এ ক্লিক করুন।
- বিদ্যমান URL প্যাটার্নের কনফিগারেশন সম্পাদনা করতে, নিচের তীরটি ক্লিক করুন।
হোস্ট প্যাটার্ন ক্ষেত্রে, URL প্যাটার্নের ডোমেনটি লিখুন। চ্যাট অ্যাপটি এই ডোমেনের লিঙ্কগুলির প্রিভিউ দেখাবে।
subdomain.example.comএর মতো একটি নির্দিষ্ট সাবডোমেনের জন্য Chat অ্যাপ প্রিভিউ লিঙ্ক পেতে, সাবডোমেনটি অন্তর্ভুক্ত করুন।সম্পূর্ণ ডোমেনের জন্য Chat অ্যাপ প্রিভিউ লিঙ্ক পেতে, সাবডোমেন হিসেবে তারকাচিহ্ন (*) সহ একটি ওয়াইল্ডকার্ড অক্ষর নির্দিষ্ট করুন। উদাহরণস্বরূপ,
*.example.comsubdomain.example.comএবংany.number.of.subdomains.example.comএর সাথে মেলে।পাথ প্রিফিক্স ক্ষেত্রে, হোস্ট প্যাটার্ন ডোমেনে যোগ করার জন্য একটি পাথ লিখুন।
হোস্ট প্যাটার্ন ডোমেনের সমস্ত URL মেলাতে, পাথ প্রিফিক্স খালি রাখুন।
উদাহরণস্বরূপ, যদি হোস্ট প্যাটার্নটি
support.example.comহয়, তাহলেsupport.example.com/cases/এ হোস্ট করা কেসের URL গুলি মেলাতে,cases/লিখুন।সম্পন্ন ক্লিক করুন।
সংরক্ষণ করুন ক্লিক করুন।
এখন, যখনই কেউ এমন একটি লিঙ্ক অন্তর্ভুক্ত করে যা আপনার চ্যাট অ্যাপ অন্তর্ভুক্ত চ্যাট স্পেসে থাকা কোনও বার্তার সাথে লিঙ্ক প্রিভিউ URL প্যাটার্নের সাথে মেলে, তখন আপনার অ্যাপটি লিঙ্কটির প্রিভিউ দেখায়।
একটি লিঙ্কের প্রিভিউ দেখুন
কোনও নির্দিষ্ট লিঙ্কের জন্য লিঙ্ক প্রিভিউ কনফিগার করার পরে, আপনার চ্যাট অ্যাপ লিঙ্কটিতে আরও তথ্য সংযুক্ত করে লিঙ্কটি চিনতে এবং প্রিভিউ করতে পারে।
আপনার চ্যাট অ্যাপের অন্তর্ভুক্ত চ্যাট স্পেসের ভিতরে, যখন কারো বার্তায় এমন একটি লিঙ্ক থাকে যা একটি লিঙ্ক প্রিভিউ URL প্যাটার্নের সাথে মেলে, তখন আপনার চ্যাট অ্যাপটি MessagePayload সহ একটি ইভেন্ট অবজেক্ট পায়। পেলোডে, message.matchedUrl অবজেক্টে সেই লিঙ্কটি থাকে যা ব্যবহারকারী বার্তায় অন্তর্ভুক্ত করেছেন:
JSON সম্পর্কে
message: {
matchedUrl: {
url: "https://support.example.com/cases/case123"
},
... // other message attributes redacted
}
MESSAGE ইভেন্ট পেলোডে matchedUrl ফিল্ডের উপস্থিতি পরীক্ষা করে, আপনার চ্যাট অ্যাপ প্রিভিউ করা লিঙ্ক সহ বার্তায় তথ্য যোগ করতে পারে। আপনার চ্যাট অ্যাপ হয় একটি মৌলিক টেক্সট বার্তা দিয়ে উত্তর দিতে পারে অথবা একটি কার্ড সংযুক্ত করতে পারে।
একটি টেক্সট মেসেজ দিয়ে উত্তর দিন
সাধারণ উত্তরের জন্য, আপনার চ্যাট অ্যাপটি একটি লিঙ্কের উত্তরে একটি টেক্সট মেসেজ দিয়ে একটি লিঙ্কের প্রিভিউ করতে পারে। এই উদাহরণে একটি বার্তা সংযুক্ত করা হয়েছে যা লিঙ্কের URL পুনরাবৃত্তি করে যা একটি লিঙ্ক প্রিভিউ URL প্যাটার্নের সাথে মেলে।
নোড.জেএস
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
পাইথন
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
জাভা
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
অ্যাপস স্ক্রিপ্ট
লিঙ্কটির প্রিভিউ দেখাবে এমন একটি কার্ড সংযুক্ত করুন
একটি প্রিভিউ করা লিঙ্কে একটি কার্ড সংযুক্ত করতে, UpdateInlinePreviewAction ধরণের ChatDataActionMarkup অবজেক্ট দিয়ে DataActions অ্যাকশনটি ফেরত পাঠান।
নিম্নলিখিত উদাহরণে, একটি চ্যাট অ্যাপ URL প্যাটার্ন support.example.com ধারণকারী বার্তাগুলিতে একটি প্রিভিউ কার্ড যোগ করে।


নোড.জেএস
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
পাইথন
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
জাভা
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
অ্যাপস স্ক্রিপ্ট
একটি লিঙ্ক প্রিভিউ কার্ড আপডেট করুন
ব্যবহারকারীরা যখন কার্ডের বোতামে ক্লিক করার মতো ইন্টারঅ্যাক্ট করে, তখন আপনার চ্যাট অ্যাপটি একটি লিঙ্ক প্রিভিউ কার্ড আপডেট করতে পারে।
কার্ডটি আপডেট করার জন্য, আপনার চ্যাট অ্যাপকে নিম্নলিখিত ChatDataActionMarkup অবজেক্টগুলির মধ্যে একটি দিয়ে DataActions অ্যাকশনটি ফেরত পাঠাতে হবে:
- যদি কোনও ব্যবহারকারী বার্তাটি পাঠিয়ে থাকেন, তাহলে একটি
UpdateMessageActionঅবজেক্ট ফেরত দিন। - যদি চ্যাট অ্যাপটি বার্তাটি পাঠিয়ে থাকে, তাহলে একটি
UpdateInlinePreviewActionঅবজেক্ট ফেরত দিন।
কে বার্তাটি পাঠিয়েছে তা নির্ধারণ করতে, ইভেন্ট পেলোড ( buttonClickedPayload ) ব্যবহার করে প্রেরক ( message.sender.type ) HUMAN (user) নাকি BOT (Chat app) এ সেট করা আছে তা পরীক্ষা করুন।
নিম্নলিখিত উদাহরণটি দেখায় যে কীভাবে একটি চ্যাট অ্যাপ কোনও ব্যবহারকারী যখনই "Assign to Me" বোতামে ক্লিক করে তখনই একটি লিঙ্ক প্রিভিউ আপডেট করে, কার্ডের " Assignee" ক্ষেত্রটি আপডেট করে এবং বোতামটি নিষ্ক্রিয় করে।


নোড.জেএস
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
পাইথন
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
জাভা
FUNCTION_URL HTTP এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন যা বোতাম ক্লিক পরিচালনা করে।
অ্যাপস স্ক্রিপ্ট
সীমাবদ্ধতা এবং বিবেচনা
আপনার চ্যাট অ্যাপের জন্য লিঙ্ক প্রিভিউ কনফিগার করার সময়, এই সীমা এবং বিবেচনাগুলি লক্ষ্য করুন:
- প্রতিটি চ্যাট অ্যাপ সর্বোচ্চ ৫টি URL প্যাটার্নের জন্য লিঙ্ক প্রিভিউ সমর্থন করে।
- চ্যাট অ্যাপগুলি প্রতি বার্তায় একটি লিঙ্কের প্রিভিউ করে। যদি একটি বার্তায় একাধিক প্রিভিউযোগ্য লিঙ্ক থাকে, তাহলে শুধুমাত্র প্রথম প্রিভিউযোগ্য লিঙ্কের প্রিভিউ দেখা যাবে।
- চ্যাট অ্যাপগুলি শুধুমাত্র
https://দিয়ে শুরু হওয়া লিঙ্কগুলির প্রিভিউ দেখে, তাইhttps://support.example.com/cases/প্রিভিউ দেখে, কিন্তুsupport.example.com/cases/তা করে না। - যদি না মেসেজে অন্যান্য তথ্য থাকে যা চ্যাট অ্যাপে পাঠানো হয়, যেমন স্ল্যাশ কমান্ড , তাহলে লিঙ্ক প্রিভিউয়ের মাধ্যমে শুধুমাত্র লিঙ্ক URLটি চ্যাট অ্যাপে পাঠানো হয়।
- যদি কোনও ব্যবহারকারী লিঙ্কটি পোস্ট করেন, তাহলে চ্যাট অ্যাপটি কেবল তখনই লিঙ্ক প্রিভিউ কার্ডটি আপডেট করতে পারে যদি ব্যবহারকারীরা কার্ডের সাথে ইন্টারঅ্যাক্ট করে, যেমন একটি বোতাম ক্লিকের মাধ্যমে। আপনি ব্যবহারকারীর বার্তা অ্যাসিঙ্ক্রোনাসভাবে আপডেট করার জন্য
Messageরিসোর্সে চ্যাট API এরupdate()পদ্ধতিতে কল করতে পারবেন না। - চ্যাট অ্যাপগুলিকে স্পেসে থাকা সকলের জন্য লিঙ্কগুলির প্রিভিউ দেখতে হবে, তাই বার্তাটিতে
privateMessageViewerক্ষেত্রটি বাদ দিতে হবে।
লিঙ্ক প্রিভিউ ডিবাগ করুন
লিঙ্ক প্রিভিউ বাস্তবায়নের সময়, অ্যাপের লগগুলি পড়ে আপনার চ্যাট অ্যাপটি ডিবাগ করার প্রয়োজন হতে পারে। লগগুলি পড়তে, Google ক্লাউড কনসোলে লগস এক্সপ্লোরারে যান।