Method: phones.agentEvents.create

এজেন্ট থেকে ব্যবহারকারীকে ইভেন্ট পাঠায়।

এজেন্ট ইভেন্ট ব্যবহার করে দেখানো যেতে পারে যে এজেন্ট ব্যবহারকারীর মেসেজ পড়েছেন বা এজেন্ট টাইপ করছেন (এর ফলে RCS for Business-এর অভিজ্ঞতা আরও বেশি মানবিক হয়ে ওঠে)। ব্যবহারকারীর RCS চালু করা না থাকলে, RCS for Business প্ল্যাটফর্ম NOT_FOUND (HTTP 404) সমস্যা দেখায়। ব্যবহারকারীর RCS চালু করা থাকলে কিন্তু এই মুহূর্তে তার সাথে যোগাযোগ করা না গেলে, প্ল্যাটফর্ম 200 OK উত্তর দেয় এবং ইভেন্টের ধরনের উপর ভিত্তি করে ডেলিভারি ম্যানেজ করে। এজেন্ট ইভেন্টগুলি ৩০ দিন পর্যন্ত স্টোর-অ্যান্ড-ফরওয়ার্ড সারিতে সারিবদ্ধ করা হয় এবং ব্যবহারকারী অনলাইনে ফিরে এলে তা ডেলিভার করা হয়। শুধুমাত্র IS_TYPING ইভেন্ট ক্ষণস্থায়ী এবং সারিবদ্ধ নয়।

এজেন্ট মেসেজের মতো, এজেন্ট ইভেন্ট পাঠানোর পরে তা প্রত্যাহার করা যায় না।

HTTP অনুরোধ

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents

URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।

পাথ প্যারামিটার

প্যারামিটারগুলি
parent

string

"phones/{E.164}", যেখানে {E.164} হল E.164 ফর্ম্যাটে ব্যবহারকারীর ফোন নম্বর। যেমন, মার্কিন যুক্তরাষ্ট্রের ফোন নম্বর +১-২২২-৩৩৩-৪৪৪৪ সহ কোনও ব্যবহারকারীর জন্য, ভ্যালু হবে phones/+১২২২৩৩৩৪৪৪৪ এবং এর ফলে এন্ডপয়েন্ট হবে https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents।

কোয়েরি প্যারামিটার

প্যারামিটারগুলি
eventId

string

এজেন্টের অ্যাসাইন করা ইভেন্টের আইডি। এটি অবশ্যই UUID হতে হবে, যেমন https://www.rfc-editor.org/info/rfc9562-এ সংজ্ঞায়িত করা হয়েছে। RCS for Business প্ল্যাটফর্ম এমন কোনও এজেন্টের মেসেজ উপেক্ষা করে যা এমন কোনও আইডি দিয়ে পাঠানো হয়েছে যা একই এজেন্টের পাঠানো আগের মেসেজ বা ইভেন্টে ব্যবহার করা হয়েছে।

agentId

string

প্রয়োজনীয়। এজেন্টের অনন্য শনাক্তকারী।

অনুরোধের বডি

অনুরোধের বডি ফর্ম্যাটে AgentEvent-এর একটি ইন্সট্যান্স থাকে।

প্রতিক্রিয়ার বডি

সফল হলে, রেসপন্স বডিতে AgentEvent-এর নতুন তৈরি করা ইনস্ট্যান্স থাকে।

অনুমোদনের স্কোপ

এটির জন্য নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

আরও তথ্যের জন্য, OAuth 2.0 Overview দেখুন।