এজেন্ট থেকে ব্যবহারকারীর কাছে একটি ইভেন্ট পাঠায়।
এজেন্ট ইভেন্ট ব্যবহার করে বোঝা যায় যে এজেন্ট ব্যবহারকারীর কাছ থেকে কোনও বার্তা পড়েছে অথবা এজেন্ট টাইপ করার প্রক্রিয়াধীন (যা RCS for Business অভিজ্ঞতায় একটি মানবিক উপাদান যোগ করে)। যদি ব্যবহারকারীর RCS সক্ষম না থাকে, তাহলে RCS for Business প্ল্যাটফর্ম একটি NOT_FOUND (HTTP 404) ত্রুটি ফেরত পাঠায়। যদি ব্যবহারকারীর RCS সক্ষম থাকে কিন্তু এই মুহূর্তে তার সাথে যোগাযোগ করা না যায়, তাহলে প্ল্যাটফর্মটি 200 OK প্রতিক্রিয়া ফেরত পাঠায় এবং ইভেন্টের ধরণের উপর ভিত্তি করে ডেলিভারি পরিচালনা করে। এজেন্ট ইভেন্টগুলি 30 দিন পর্যন্ত স্টোর-এন্ড-ফরওয়ার্ড কিউতে সারিবদ্ধ থাকে এবং ব্যবহারকারী অনলাইনে ফিরে আসার পরে ডেলিভারি করা হয়। শুধুমাত্র IS_TYPING ইভেন্টগুলি ক্ষণস্থায়ী এবং সারিবদ্ধ নয়।
এজেন্ট বার্তার বিপরীতে, এজেন্ট ইভেন্টগুলি পাঠানোর পরে প্রত্যাহার করা যাবে না।
HTTP অনুরোধ
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents
URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পথের পরামিতি
| পরামিতি | |
|---|---|
parent | "phones/{E.164}", যেখানে {E.164} হল E.164 ফর্ম্যাটে ব্যবহারকারীর ফোন নম্বর। উদাহরণস্বরূপ, মার্কিন ফোন নম্বর +1-222-333-4444 সহ ব্যবহারকারীর জন্য, মান হবে phones/+12223334444, এবং এর ফলে শেষ বিন্দু হবে https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents । |
কোয়েরি প্যারামিটার
| পরামিতি | |
|---|---|
eventId | ইভেন্টের আইডি, এজেন্ট কর্তৃক নির্ধারিত। এটি অবশ্যই একটি UUID হতে হবে, যেমন https://tools.ietf.org/html/rfc4122 এ সংজ্ঞায়িত করা হয়েছে। RCS for Business প্ল্যাটফর্মটি এমন কোনও এজেন্ট বার্তা উপেক্ষা করে যা একই এজেন্ট থেকে প্রেরিত পূর্ববর্তী বার্তা বা ইভেন্ট দ্বারা ব্যবহৃত আইডি সহ পাঠানো হয়। |
agentId | প্রয়োজনীয়। এজেন্টের অনন্য শনাক্তকারী। |
অনুরোধের মূল অংশ
অনুরোধের বডিতে AgentEvent এর একটি উদাহরণ রয়েছে।
প্রতিক্রিয়া মূল অংশ
যদি সফল হয়, তাহলে রেসপন্স বডিতে AgentEvent এর একটি নতুন তৈরি উদাহরণ থাকবে।
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth স্কোপ প্রয়োজন:
-
https://www.googleapis.com/auth/rcsbusinessmessaging
আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .