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