POST/api/global-chatbot/demo/voice-speak

متن کو بولی زبان میں تبدیل کرتا ہے (ڈیمو صفحے پر صوتی آؤٹ پٹ)، بشرطیکہ ڈیمو کی صوتی سہولت فعال ہو۔

`visitor_id` (UUID) اور پڑھے جانے والا متن `text` میں بھیجیں۔ جواب میں پلے بیک کے لیے آڈیو ڈیٹا شامل ہے؛ `<audio>` ایلیمنٹ کے لیے وہی راستہ GET کے ذریعے بھی دستیاب ہے۔ یہ اینڈ پوائنٹ `POST /api/public/widget/voice-speak` کے مطابق ہے، لیکن zentor-app.de کے ڈیمو سے منسلک ہے اور عمومی صوتی آؤٹ پٹ انٹرفیس کے طور پر نہیں بنایا گیا۔ خرابیاں: 400 `INVALID_VISITOR_ID` (غائب یا غلط UUID)، 403 `ORIGIN_DENIED` (zentor-app.de سے کال نہیں) اور 503 `VOICE_UNAVAILABLE` (صوتی سہولت فی الحال دستیاب نہیں)۔

جائزہ

کال: POST /api/global-chatbot/demo/voice-speak۔ یہ اینڈپوائنٹ Zentor App کی API کے گروپ “ڈیمو چیٹ بوٹ اور SSO” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent ہے: ایک جیسی معلومات کے ساتھ بار بار کال کرنے پر ایک ہی نتیجہ ملتا ہے۔ لازمی پیرامیٹرز: visitor_id (باڈی), text (باڈی)۔ دستاویزی ایرر کیسز: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE۔ نیچے دیا گیا نمونہ جواب JSON فارمیٹ میں کامیاب جواب کی ساخت دکھاتا ہے۔

تصدیقِ شناخت اور تحفظ

تصدیقِ شناخت ضروری نہیں

صرف https://zentor-app.de اور https://www.zentor-app.de سے کالز قبول کرتا ہے؛ ڈیمو کے لیے ایمبیڈ ٹوکن ضروری نہیں۔

Idempotent (دہرانے پر یکساں اثر): جی ہاں

پیرامیٹرز

visitor_id(body, string، ضروری)— وزیٹر آئی ڈی، درست UUID ہونا چاہیے
text(body, string، ضروری)— پڑھا جانے والا متن

مثالی Response

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"آواز کی سہولت فی الحال دستیاب نہیں۔"}}

خرابی کے کوڈز

400 INVALID_VISITOR_ID — `visitor_id` غائب ہے یا درست UUID نہیں ہے۔
403 ORIGIN_DENIED — کال zentor-app.de سے نہیں ہے۔
503 VOICE_UNAVAILABLE — صوتی سہولت فی الحال دستیاب نہیں۔

تصدیق شدہ طرزِ عمل

غلط `visitor_id` 400 `INVALID_VISITOR_ID` واپس کرتا ہے، اور دستیاب نہ ہونے والی صوتی سہولت 503 `VOICE_UNAVAILABLE` واپس کرتی ہے۔ کامیابی صرف zentor-app.de سے ممکن ہے۔

ڈیمو چیٹ بوٹ اور SSO

POST /api/global-chatbot/demozentor-app.de/demo پر عوامی ڈیمو چیٹ بوٹ کو پیغام بھیجتا ہے اور اس کا جواب واپس کرتا ہے۔ ڈیمو کو بغیر رجسٹریشن کے براؤزر میں آزمایا جا سکتا ہے۔GET /api/global-chatbot/demo/historyایک ڈیمو گفتگو کی سابقہ پیغامات کی تاریخ لوڈ کرتا ہے، تاکہ ڈیمو دوبارہ کھولنے پر یہ محفوظ رہے۔POST /api/global-chatbot/demo/pollایک ڈیمو گفتگو کے نئے پیغامات حاصل کرتا ہے، مثلاً جب Zentor کا کوئی رکن گفتگو سنبھال لے۔ ڈیمو صفحہ اس اینڈ پوائنٹ کو وقفوں سے کال کرتا ہے۔POST /api/global-chatbot/demo/ratingایک ڈیمو گفتگو کی درجہ بندی (مفید یا غیر مفید) اختیاری تبصرے کے ساتھ محفوظ کرتا ہے۔POST /api/global-chatbot/demo/trackZentor کے وزیٹر اعداد و شمار کے لیے ڈیمو صفحے کے گمنام استعمال کے واقعات ریکارڈ کرتا ہے۔POST /api/global-chatbot/demo/voice-transcribeڈیمو صفحے پر صوتی ریکارڈنگ کو متن میں تبدیل کرتا ہے (صوتی ان پٹ)، بشرطیکہ ڈیمو کی صوتی سہولت فعال ہو۔GET /api/sso/:tenantSlug/statusچیک کرتا ہے کہ کیا کسی اکاؤنٹ کے لیے سنگل سائن آن (SAML یا OIDC) سیٹ کیا گیا ہے۔ لاگ ان صفحہ نتیجہ استعمال کر کے SSO لاگ ان پیش کرتا ہے۔GET /api/sso/:tenantSlug/oidc/startOpenID Connect کے ذریعے لاگ ان شروع کرتا ہے اور براؤزر کو ترتیب شدہ شناختی فراہم کنندہ کی طرف بھیجتا ہے۔GET /api/sso/:tenantSlug/oidc/callbackOIDC لاگ ان کے بعد شناختی فراہم کنندہ کی ری ڈائریکٹ وصول کرتا ہے اور براؤزر کو Zentor App کی طرف واپس بھیجتا ہے۔GET /api/sso/:tenantSlug/saml/startSAML کے ذریعے لاگ ان شروع کرتا ہے اور براؤزر کو ترتیب شدہ شناختی فراہم کنندہ کی طرف بھیجتا ہے۔POST /api/sso/:tenantSlug/saml/acsاسرشن کنزیومر سروس (ACS): شناختی فراہم کنندہ کا دستخط شدہ SAML جواب فارم POST کے ذریعے وصول کرتا ہے۔GET /api/sso/:tenantSlug/saml/metadataآپ کے شناختی فراہم کنندہ میں درآمد کرنے کے لیے Zentor App کا SAML میٹا ڈیٹا (XML) فراہم کرتا ہے۔

متعلقہ مضامین

← ڈیمو چیٹ بوٹ اور SSO