চ্যাট-উইজেট

এই গ্রুপটি কাস্টমার ওয়েবসাইটে এমবেডেড চ্যাট উইজেট ব্যবহার করে এমন সমস্ত পাবলিক এন্ডপয়েন্টকে একত্রিত করে: উপলব্ধতা পরীক্ষা (`GET /api/public/widget/health`), পাবলিক উইজেট কনফিগারেশন পুনরুদ্ধার (`GET /api/public/widget/config/:widget_code`) এবং বার্তা প্রেরণ ও ইতিহাস (`POST /api/public/widget/message`, `GET /api/public/widget/history`)। ডোমেইন শেয়ারিং উইজেট তৈরি করার সময় Zentor দ্বারা রক্ষণাবেক্ষণ করা হয়; টেন্যান্ট ড্যাশবোর্ডে এর জন্য কোনো সেটিংস ইন্টারফেস নেই। একটি অ-শেয়ারকৃত অরিজিনের ক্ষেত্রে, `WIDGET_ORIGIN_DENIED` ত্রুটি কোড ঘটতে পারে। উইজেট তৈরি নিজেই মাস্টার অ্যাডমিনের জন্য সংরক্ষিত, যখন টেন্যান্ট সমাপ্ত এমবেডিং কোড পায়।

একটি সাধারণ ডেভেলপার API কী সিস্টেম বিদ্যমান নেই। `health` এবং `config` প্রমাণীকরণ ছাড়াই অ্যাক্সেসযোগ্য, কারণ এগুলো ব্রাউজারে উইজেটের প্রাথমিককরণের জন্য নির্ধারিত। অন্যদিকে `message` এবং `history`-এর জন্য `X-Widget-Token` হেডার প্রয়োজন এবং অতিরিক্তভাবে সার্ভার-সাইড অরিজিন অ্যালোলিস্টের বিরুদ্ধে পরীক্ষা করা হয়। এমবেড টোকেন উইজেট তৈরি করার সময় একবার প্লেইন টেক্সটে প্রদর্শিত হয় এবং এটি পাবলিক রিপোজিটরি, সাপোর্ট স্ক্রিনশট বা ব্রাউজার লগে উপস্থিত হওয়া উচিত নয়।

এই গ্রুপের প্রতিটি বিবরণ পৃষ্ঠা পদ্ধতি, পাথ, প্রমাণীকরণ, আইডেমপোটেন্সি এবং প্রতিটি এন্ডপয়েন্টের নথিভুক্ত ত্রুটি কোড পৃথকভাবে বর্ণনা করে। একটি এন্ডপয়েন্টের সফল কল স্বয়ংক্রিয়ভাবে প্রমাণ করে না যে একই গ্রুপের অন্য একটি এন্ডপয়েন্টও সফল হবে — বিশেষ করে, একটি সবুজ `health` চেক একটি বৈধ উইজেট, একটি শেয়ারকৃত অরিজিন বা একটি AI প্রদানকারীর অ্যাক্সেসযোগ্যতা নিশ্চিত করে না।

নিশ্চিত প্ল্যাটফর্ম-ব্যাপী API সীমা হল 15 মিনিটের মধ্যে 2,000 অনুরোধ। একটি একক উইজেট এন্ডপয়েন্টের জন্য একটি ভিন্ন সীমা শুধুমাত্র তখনই উল্লেখ করা হয় যদি এটি সেই এন্ডপয়েন্টের জন্য স্পষ্টভাবে নথিভুক্ত হয়। `message` আইডেমপোটেন্ট নয়; একটি ক্লায়েন্টকে প্রথমে পরীক্ষা না করে একটি অস্পষ্টভাবে বাতিল করা প্রেরণ অপারেশন স্বয়ংক্রিয়ভাবে পুনরাবৃত্তি করা উচিত নয় যে প্রথম বার্তাটি ইতিমধ্যে প্রক্রিয়া করা হয়েছে কিনা।

এই গ্রুপের প্রযুক্তিগত পরীক্ষা `app/frontend/src/content/api-reference/groups/widget.ts`-এর অধীনে রেজিস্ট্রি এবং সংশ্লিষ্ট ব্যাকএন্ড রুটের উপর নির্ভর করে। প্রতিটি বিবরণ পৃষ্ঠা চিহ্নিত করে যে একটি সাফল্যের পথ লাইভ, একটি নেতিবাচক পথ, বা শুধুমাত্র একটি কোড অ্যানালজি পরীক্ষা করা হয়েছে — এই পার্থক্যটি পুরো গ্রুপের জন্য প্রযোজ্য এবং সাধারণ সাফল্যের বিবৃতি দ্বারা প্রতিস্থাপিত করা উচিত নয়।