এই নথিটি স্পষ্ট করে যে কীভাবে ব্যবসায়িক প্ল্যাটফর্মের জন্য RCS বার্তা প্রেরণ এবং অন্যান্য API ইন্টারঅ্যাকশন পরিচালনা করে, সিঙ্ক্রোনাস এবং অ্যাসিঙ্ক্রোনাস অপারেশনগুলির মধ্যে পার্থক্য করে৷
RBM API ইন্টারঅ্যাকশনগুলি সাধারণত HTTP স্তরে একটি সিঙ্ক্রোনাস অনুরোধ-প্রতিক্রিয়া প্যাটার্ন অনুসরণ করে। যাইহোক, অনেক API কলের ফলাফল, বিশেষ করে বার্তা বিতরণ, ওয়েবহুকের মাধ্যমে অ্যাসিঙ্ক্রোনাসভাবে পরিচালনা করা হয়। বিস্তারিত জানার জন্য নিম্নলিখিত বিভাগগুলি পড়ুন।
বার্তা পাঠানো: সিঙ্ক্রোনাস অনুরোধ, অ্যাসিঙ্ক্রোনাস ডেলিভারি
phones.agentMessages.create
API অনুরোধটি API দৃষ্টিকোণ থেকে সিঙ্ক্রোনাসভাবে প্রক্রিয়া করা হয়। আপনি যখন ব্যবসায়িক প্ল্যাটফর্মের জন্য RCS-এর কাছে একটি HTTP অনুরোধ করেন, তখন সার্ভারটি একটি স্ট্যান্ডার্ড HTTP স্ট্যাটাস কোড (যেমন 200 OK
বা একটি ত্রুটি) দিয়ে অনুরোধটি গৃহীত হয়েছে এবং বৈধ কিনা তা নির্দেশ করার জন্য প্রায় সঙ্গে সঙ্গেই সাড়া দেয়।
যাইহোক, শেষ ব্যবহারকারীর কাছে বার্তাটির প্রকৃত বিতরণ অ্যাসিঙ্ক্রোনাসভাবে প্রক্রিয়া করা হয়। নিম্নলিখিত কারণগুলি এই প্রক্রিয়াটিকে প্রভাবিত করতে পারে:
- প্রাপকের স্থিতি : ব্যবহারকারী অফলাইন থাকতে পারে, একটি খালি ব্যাটারি থাকতে পারে বা RCS সক্ষম নাও থাকতে পারে৷
- নেটওয়ার্ক শর্ত : ক্যারিয়ার নেটওয়ার্ক সমস্যা বার্তা বিতরণ বিলম্ব বা প্রতিরোধ করতে পারে।
ব্যবসায়িক প্ল্যাটফর্মের জন্য RCS ওয়েবহুকের মাধ্যমে অ্যাসিঙ্ক্রোনাসভাবে মেসেজ ডেলিভারির স্ট্যাটাস আপডেট (যেমন ডেলিভারি রসিদ এবং পড়ার রসিদ) প্রদান করে। অতএব, প্রাথমিক API অনুরোধটি সিঙ্ক্রোনাস হওয়ার সময়, আপনার বার্তা বিতরণ ট্র্যাক করতে অ্যাসিঙ্ক্রোনাস ওয়েবহুক ইভেন্টের উপর নির্ভর করা উচিত। phones.agentMessages.create
প্রতিক্রিয়া থেকে ডেলিভারি স্ট্যাটাসের অবিলম্বে নিশ্চিতকরণ আশা করবেন না।
অন্যান্য RBM API মিথস্ক্রিয়া
বেশিরভাগ অন্যান্য HTTP-ভিত্তিক RBM APIগুলিও একটি সিঙ্ক্রোনাস অনুরোধ-প্রতিক্রিয়া মডেলের সাথে কাজ করে। এই APIগুলি একটি অবিলম্বে HTTP প্রতিক্রিয়া প্রদান করে যা অনুরোধের অবস্থা (সফলতা বা ত্রুটি) নির্দেশ করে। যাইহোক, অনুরোধটি সিঙ্ক্রোনাস হওয়ার সময়, অনুরোধের ফলে সৃষ্ট ক্রিয়াগুলি অ্যাসিঙ্ক্রোনাস প্রক্রিয়াগুলিকে অন্তর্ভুক্ত করতে পারে। উদাহরণস্বরূপ, এজেন্ট তথ্য আপডেট করার জন্য একটি API কলের সফল প্রতিক্রিয়ার অর্থ এই নয় যে আপডেটটি তাৎক্ষণিকভাবে সর্বত্র প্রতিফলিত হয়; একটি সংক্ষিপ্ত প্রচার বিলম্ব হতে পারে.
ওয়েবহুক এন্ডপয়েন্ট: অ্যাসিঙ্ক্রোনাস ইভেন্ট
নিম্নলিখিত ইভেন্টগুলি আপনার ওয়েবহুক এন্ডপয়েন্টে অ্যাসিঙ্ক্রোনাসভাবে বিতরণ করা হয়:
- ইনকামিং ইউজার মেসেজ : RCS ফর বিজনেস প্ল্যাটফর্ম ইনকামিং ইউজার মেসেজকে আপনার ওয়েবহুক এন্ডপয়েন্টে ঠেলে দেয়। ইনকামিং বার্তা যাচাই করতে ভুলবেন না.
- ডেলিভারি এবং রিসিপ্ট : মেসেজ ডেলিভারি এবং রিড স্ট্যাটাসের নোটিফিকেশন ওয়েবহুকের মাধ্যমে পাঠানো হয়।
- কথোপকথনের ঘটনা : কিছু কথোপকথন-সম্পর্কিত ইভেন্ট, যেমন টাইপিং সূচক, ওয়েবহুকের মাধ্যমে পাঠানো হয়।
- বার্তার মেয়াদ শেষ হওয়া এবং প্রত্যাহার ইভেন্ট : ব্যবসার জন্য RCS প্ল্যাটফর্ম ইভেন্ট পাঠায় নিশ্চিত করার জন্য যে একটি মেয়াদ উত্তীর্ণ বার্তা সফলভাবে প্রত্যাহার করা হয়েছে কিনা।