Google Chat ব্যবহারকারীদের ব্যক্তিগত বার্তা পাঠান

এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে একটি Google চ্যাট অ্যাপ হিসেবে ব্যক্তিগত বার্তা তৈরি এবং পাঠাতে হয়।

একটি ব্যক্তিগত বার্তা হল একটি চ্যাট অ্যাপ বার্তা যা শুধুমাত্র একটি নির্দিষ্ট চ্যাট ব্যবহারকারীর কাছে দৃশ্যমান। আপনি একাধিক ব্যক্তির সাথে স্পেসগুলিতে ব্যক্তিগত বার্তাগুলি ব্যবহার করতে পারেন যাতে তারা চ্যাট অ্যাপগুলির সাথে ব্যক্তিগতভাবে যোগাযোগ করতে পারে৷ উদাহরণ স্বরূপ, আপনার চ্যাট অ্যাপ ব্যক্তিগতভাবে নিম্নলিখিত যে কোনো একটি করতে বার্তা পাঠাতে পারে:

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

যখন একটি চ্যাট অ্যাপ একটি ব্যক্তিগত বার্তা পাঠায়, তখন বার্তাটি একটি লেবেল দেখায় যা ব্যবহারকারীকে জানায় যে বার্তাটি শুধুমাত্র তাদের কাছে দৃশ্যমান:

চিত্র 1 : যখন একটি চ্যাট অ্যাপ একটি ব্যক্তিগত বার্তা পাঠায়, ব্যবহারকারী একটি লেবেল সহ একটি বার্তা দেখতে পান যাতে লেখা হয় Only visible to you ৷

পূর্বশর্ত

Node.js

• Google Chat API সক্ষম এবং কনফিগার করা একটি Google ক্লাউড প্রকল্প। ধাপগুলির জন্য, একটি Google Chat অ্যাপ তৈরি করুন দেখুন।
• স্ল্যাশ কমান্ডে ব্যক্তিগতভাবে প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপের জন্য একটি স্ল্যাশ কমান্ড কনফিগার করা হয়েছে। একটি তৈরি করতে, স্ল্যাশ কমান্ডের প্রতিক্রিয়া দেখুন।
• messages.create() পদ্ধতি ব্যবহার করে একটি ব্যক্তিগত বার্তা পাঠাতে, আপনাকে অবশ্যই অ্যাপ প্রমাণীকরণ ব্যবহার করতে হবে।

দ্রষ্টব্য: এই নির্দেশিকায় Node.js কোডের নমুনাগুলি একটি Google ক্লাউড ফাংশন হিসাবে চালানোর জন্য লেখা হয়েছে৷

পাইথন

• Google Chat API সক্ষম এবং কনফিগার করা একটি Google ক্লাউড প্রকল্প। ধাপগুলির জন্য, একটি Google Chat অ্যাপ তৈরি করুন দেখুন।
• স্ল্যাশ কমান্ডে ব্যক্তিগতভাবে প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপের জন্য একটি স্ল্যাশ কমান্ড কনফিগার করা হয়েছে। একটি তৈরি করতে, স্ল্যাশ কমান্ডের প্রতিক্রিয়া দেখুন।
• messages.create() পদ্ধতি ব্যবহার করে একটি ব্যক্তিগত বার্তা পাঠাতে, আপনাকে অবশ্যই অ্যাপ প্রমাণীকরণ ব্যবহার করতে হবে।

দ্রষ্টব্য: এই নির্দেশিকায় পাইথন কোডের নমুনাগুলি Python 3.10 ব্যবহার করে Google ক্লাউড ফাংশন হিসাবে চালানোর জন্য লেখা হয়েছে।

অ্যাপস স্ক্রিপ্ট

• একটি চ্যাট অ্যাপ। একটি চ্যাট অ্যাপ তৈরি করতে, এই কুইকস্টার্টটি অনুসরণ করুন।
• স্ল্যাশ কমান্ডে ব্যক্তিগতভাবে প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপের জন্য একটি স্ল্যাশ কমান্ড কনফিগার করা হয়েছে। একটি তৈরি করতে, স্ল্যাশ কমান্ডের প্রতিক্রিয়া দেখুন।
• messages.create() পদ্ধতি ব্যবহার করে একটি ব্যক্তিগত বার্তা পাঠাতে, আপনাকে অবশ্যই অ্যাপ প্রমাণীকরণ ব্যবহার করতে হবে।

একটি ব্যক্তিগত বার্তা পাঠান

একটি চ্যাট অ্যাপ হিসাবে ব্যক্তিগতভাবে একটি বার্তা পাঠাতে, আপনি এটি তৈরি করার সময় বার্তাটিতে privateMessageViewer ক্ষেত্রটি নির্দিষ্ট করুন৷ আপনি ব্যক্তিগত বার্তাগুলি তৈরি করেন ঠিক যেমন আপনি কোনও বার্তা তৈরি করেন: হয় কোনও ব্যবহারকারীর ইন্টারঅ্যাকশনের প্রতিক্রিয়া জানিয়ে বা Message সংস্থানে Google Chat API-এর create() পদ্ধতিতে অ্যাসিঙ্ক্রোনাসভাবে কল করে। পাঠ্য বা কার্ড বার্তা পাঠানোর পদক্ষেপের জন্য, একটি বার্তা পাঠান দেখুন।

নিম্নলিখিত উদাহরণটি একটি ব্যক্তিগত পাঠ্য বার্তার জন্য JSON দেখায় যা বলে Hello private world! :

{
    "text": "Hello private world!",
    "privateMessageViewer": "USER"
}

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

অন্যথায়, একটি ব্যক্তিগত বার্তার জন্য দর্শককে নির্দিষ্ট করতে, আপনি User সম্পদের name ক্ষেত্রটি ব্যবহার করতে পারেন:

{
    "text": "Hello private world!",
    "privateMessageViewer": {
      "name": "users/USER_ID"
    }
}

এই উদাহরণে, আপনি Google Chat-এ দর্শকের User সম্পদের নাম নির্দিষ্ট করতে name ক্ষেত্রটি ব্যবহার করেন। ব্যবহারকারীর জন্য একটি অনন্য ID দিয়ে USER_ID প্রতিস্থাপন করুন, যেমন 12345678987654321 বা [e-mail] ।

ব্যবহারকারীদের নির্দিষ্ট করার বিষয়ে আরও তথ্যের জন্য, Google Chat ব্যবহারকারীদের সনাক্ত করুন এবং নির্দিষ্ট করুন দেখুন।

একটি স্ল্যাশ কমান্ডে ব্যক্তিগতভাবে সাড়া দিন

নিম্নলিখিত কোডটি একটি চ্যাট অ্যাপের একটি উদাহরণ দেখায় যা একটি ব্যক্তিগত বার্তা সহ একটি স্ল্যাশ কমান্ডের প্রতিক্রিয়া জানায়৷

চ্যাট অ্যাপটি একটি MESSAGE ইন্টারঅ্যাকশন ইভেন্ট প্রক্রিয়া করে এবং একটি ব্যক্তিগত টেক্সট বার্তা সহ /help স্ল্যাশ কমান্ডের উত্তর দেয় যা এটি কীভাবে ব্যবহার করতে হয় তা ব্যাখ্যা করে:

Node.js

/**
* Responds to a MESSAGE event in Google Chat.
*
* @param {!Object} req Request sent from Google Chat app
* @param {!Object} res Response to send back
*
* @return {!Object} respond to slash command
*/
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    return res.send('Hello! This function is meant to be used in Google Chat app.');
  }

  const event = req.body;

  // Checks for the presence of event.message.slashCommand.
  // If the slash command is "/help", responds with a private text message.
  if (event.message.slashCommand) {
    switch (event.message.slashCommand.commandId) {
      case '1':  // /help
        return res.json({
          privateMessageViewer: event.user,
          text: 'This Chat app was created by Cymbal Labs. To get help with this app, <https://cymbalgroup.com/docs|see our documentation> or <https://cymbalgroup.com/support|contact our support team>.'
        });
    }
  }

  // If the Chat app doesn't detect a slash command, it responds
  // with a private text message
  return res.json({
    privateMessageViewer: event.user,
    text: 'Try a slash command.'
  });
};

অ্যাপস স্ক্রিপ্ট

/**
* Responds to a MESSAGE event in Google Chat.
*
* @param {Object} event the event object from Google Chat
*/
function onMessage(event) {
  if (event.message.slashCommand) {
    switch (event.message.slashCommand.commandId) {
      case 1: // Responds to /help
        return {
          "privateMessageViewer": event.user,
          "text": "This Chat app was created by Cymbal Labs. To get help with this app, <https://cymbalgroup.com/docs|see our documentation> or <https://cymbalgroup.com/support|contact our support team>."
        };
    }
  }
  else {
    return { "text": "Try a slash command.", "privateMessageViewer": event.user };
  }
}

পাইথন

from typing import Any, Mapping

import flask
import functions_framework

@functions_framework.http
def main(req: flask.Request) -> Mapping[str, Any]:
  """Responds to a MESSAGE event in Google Chat.

  Args:
      req (flask.Request): the event object from Chat API.

  Returns:
      Mapping[str, Any]: open a Dialog in response to a card's button click.
  """
  if req.method == 'GET':
    return 'Hello! This function must be called from Google Chat.'

  request = req.get_json(silent=True)

  # Checks for the presence of event.message.slashCommand.
  # If the slash command is "/help", responds with a private text message.
  if request.get('message', {}).get('slashCommand'):
    command_id = request.get('message', {}).get('slashCommand').get('commandId')
    if command_id == '1':  # /help
      return {
          'privateMessageViewer': request.get('user'),
          'text': (
              'This Chat app was created by Cymbal Labs. To get help with this'
              ' app, <https://cymbalgroup.com/docs|see our documentation> or'
              ' <https://cymbalgroup.com/support|contact our support team>.'
          ),
      }

  return {
      'privateMessageViewer': request.get('user'),
      'text': 'Try a slash command.',
  }

সীমাবদ্ধতা

একটি ব্যক্তিগত বার্তা পাঠাতে, বার্তাটিতে নিম্নলিখিতগুলি থাকতে বা ব্যবহার করা যাবে না:

• সংযুক্তি
• আনুষঙ্গিক কর্ম .
• আংশিক-ব্যক্তিগত বার্তা। উদাহরণস্বরূপ, একটি চ্যাট অ্যাপ পাঠ্য এবং একটি কার্ড সহ একটি বার্তা পাঠাতে পারে না যেখানে পাঠ্যটি শুধুমাত্র একজন ব্যবহারকারীর কাছে দৃশ্যমান কিন্তু কার্ডটি স্থানের প্রত্যেকের কাছে দৃশ্যমান।
• ব্যবহারকারী প্রমাণীকরণ . শুধুমাত্র চ্যাট অ্যাপই ব্যক্তিগত বার্তা পাঠাতে পারে, তাই আপনার চ্যাট অ্যাপ ব্যক্তিগতভাবে মেসেজ পাঠানোর জন্য ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে পারে না।

ব্যক্তিগত বার্তাগুলি আপডেট করুন বা মুছুন৷

Google চ্যাট বার্তাগুলি আপডেট করতে বা মুছে ফেলতে, আপনাকে চ্যাট API কল করতে হবে৷ আপনি ব্যক্তিগত বার্তার দর্শক পরিবর্তন করতে বা বার্তাটিকে সর্বজনীন করতে পারবেন না৷ অতএব, যখন আপনি ব্যক্তিগত বার্তা আপডেট করেন, আপনাকে অবশ্যই API কলে privateMessageViewer ক্ষেত্রটি বাদ দিতে হবে (ক্ষেত্রটি শুধুমাত্র আউটপুট)।

একটি ব্যক্তিগত বার্তা আপডেট করতে, একটি বার্তা আপডেট করুন দেখুন। একটি ব্যক্তিগত বার্তা মুছে ফেলতে, একটি বার্তা মুছুন দেখুন।

সম্পর্কিত বিষয়

• একটি বার্তা পাঠান
• Google চ্যাট ব্যবহারকারীদের চিহ্নিত করুন এবং নির্দিষ্ট করুন
• স্ল্যাশ কমান্ডে সাড়া দিন
• একটি বার্তা আপডেট করুন
• একটি বার্তা মুছুন