چیٹ ویجیٹ

یہ گروپ ان تمام عوامی انڈ پوائنٹس کو اکٹھا کرتی ہے جو کسٹمر ویب سائٹس پر شامل چیٹ ویجٹ استعمال کرتی ہے: دستیابی چیک (`GET /api/public/widget/health`)، عوامی ویجٹ کی ترتیبات حاصل کرنا (`GET /api/public/widget/config/:widget_code`)، اور پیغام بھیجنا اور تاریخ (`POST /api/public/widget/message`, `GET /api/public/widget/history`)۔ ڈومین کی منظوری ویجٹ بنانے کے دوران Zentor کے ذریعے برقرار رکھی جاتی ہے؛ ٹیننٹ ڈیش بورڈ پر اس کے لیے کوئی ترتیب کا انٹرفیس موجود نہیں ہے۔ اگر Origin منظور شدہ نہ ہو تو غلطی کوڈ `WIDGET_ORIGIN_DENIED` ظاہر ہو سکتا ہے۔ ویجٹ بنانے کا کام ماسٹر ایڈمن کے لیے مخصوص ہے، جبکہ ٹیننٹ مکمل ایمبیڈنگ کوڈ حاصل کرتا ہے۔

کوئی عمومی ڈیولپر API-Key سسٹم موجود نہیں ہے۔ `health` اور `config` بغیر تصدیق کے دستیاب ہیں کیونکہ یہ براؤزر میں ویجٹ کی شروعات کے لیے مقرر کیے گئے ہیں۔ `message` اور `history` کے لیے `X-Widget-Token` ہیڈر کی ضرورت ہوتی ہے اور انہیں سرور سائیڈ Origin-Allowlist کے خلاف بھی چیک کیا جاتا ہے۔ ایمبیڈ ٹوکن ویجٹ بنانے کے دوران ایک بار صاف متن میں دکھایا جاتا ہے اور اسے عوامی ریپوزٹریز، سپورٹ اسکرین شاٹس یا براؤزر لاگز میں ظاہر نہیں کیا جا سکتا۔

اس گروپ کی ہر تفصیلی صفحہ مخصوص انڈ پوائنٹ کی طریقہ کار، راستہ، تصدیق، آئیڈمپوٹنسی اور دستاویز کردہ غلطی کوڈز کو الگ الگ بیان کرتا ہے۔ کسی انڈ پوائنٹ کا کامیاب کال خود بخود یہ نہیں ثابت کرتا کہ اس گروپ کا کوئی دوسرا انڈ پوائنٹ بھی کامیاب ہو گیا ہو — خاص طور پر یہ کہنا کہ `health` چیک سبز ہے نہ صرف ویجٹ کی درستگی، نہ ہی منظور شدہ Origin کی تصدیق کرتا ہے اور نہ ہی کسی AI فراہم کنندہ کی دستیابی۔

تصدیق شدہ پورے پلیٹ فارم کے API لیمٹ 15 منٹ کے اندر 2,000 درخواستوں تک ہے۔ کسی انفرادی ویجٹ انڈ پوائنٹ کے لیے اس لیمٹ سے ہٹ کر کوئی لیمٹ صرف اس صورت میں ذکر کیا جائے گا جب اس انڈ پوائنٹ کے لیے صراحتاً ثبوت موجود ہو۔ `message` آئیڈمپوٹنٹ نہیں ہے؛ کلینٹ کو غیر واضح طور پر ختم ہونے والے بھیجنے کے عمل کو خود بخود دہرانے سے گریز کرنا چاہیے، بغیر اس کے کہ پہلے یہ چیک کیا گیا ہو کہ پہلا پیغام پہلے سے پروسیس ہو چکا ہے۔

اس گروپ کی تکنیکی جانچ `app/frontend/src/content/api-reference/groups/widget.ts` کے تحت رجسٹری اور متعلقہ بیک اینڈ روٹس پر مبنی ہے۔ ہر تفصیلی صفحہ یہ ظاہر کرتا ہے کہ آیا کامیاب راستہ لائیو چیک کیا گیا، منفی راستہ، یا صرف کوڈ کی مشابہت — یہ تمیز پوری گروپ کے لیے لاگو ہوتی ہے اور اسے عمومی کامیابی کے بیانات سے نہیں بدلنا چاہیے۔