POST/api/global-chatbot/demo/voice-speak
تبدیل متن به گفتار (Text-to-Speech) برای خروجی صوتی در صفحه دمو، در صورت فعال بودن.
`POST /api/global-chatbot/demo/voice-speak` متن را به گفتار تبدیل میکند، مشروط بر اینکه ویژگی صدا برای نسخه آزمایشی فعال باشد. این نقطه پایانی توسط صفحه آزمایشی عمومی استفاده میشود و به عنوان یک API عمومی قابل استفاده برای تبدیل متن به گفتار در نظر گرفته نشده است. احراز هویت داشبورد مورد نیاز نیست، اما یک بررسی ثابت مبدا برای `https://zentor-app.de` و `https://www.zentor-app.de`. اعمال میشود. درخواست شامل متنی است که باید خوانده شود و همچنین گزینههای زبانی که در طرحبندی مستند شده مشخص شدهاند. کلاینت فقط باید متنی را ارسال کند که واقعاً قرار است در مکالمه آزمایشی خوانده شود. ورودیهای خالی، فرمتهای نامعتبر یا یک ویژگی صوتی غیرفعال باید به عنوان خطا تلقی شوند. تغییر مبدا به صورت محلی یا دسترسی از یک دامنه خارجی، بررسی سمت سرور را دور نمیزند. این عملیات، خروجی صوتی تولید میکند و بنابراین نباید به عنوان یک عملیات خواندن خالص و بدون عوارض در نظر گرفته شود. ارسال مکرر متن یکسان میتواند باعث ایجاد چندین عملیات پردازش شود. رابط کاربری آزمایشی باید دکمه پخش را در طول پردازش غیرفعال کند و پخشهای در حال انجام را به طور کامل متوقف کند قبل از اینکه یک پخش جدید شروع شود. یک سناریوی واقعی با یک پاسخ ربات در نسخه آزمایشی آغاز میشود. کاربر، خروجی صوتی را فعال میکند، صفحه، متن پاسخ را به `voice-speak` ارسال میکند، دادههای صوتی یا پاسخ صوتی مستند شده را دریافت میکند و آنها را در مرورگر پخش میکند. اگر درخواست به دلیل یک مبدا غیرمجاز با شکست مواجه شود، رابط کاربری نباید از هیچ سرویس جایگزین دیگری استفاده کند، بلکه باید ویژگی صوتی را به عنوان در دسترس نبودن نشان دهد. رمزهای عبور، توکنها یا محتوای حساس نباید در درخواست قرار گیرند. کانال آزمایشی عمومی است و برای دادههای محرمانه شرکت در نظر گرفته نشده است. همچنین، پاسخهای صوتی نباید به طور دائم در گزارشهای عمومی ذخیره شوند. این نقطه پایانی از نظر فنی از ربات صوتی SIP جدا شده است. تلفنگویی در نمونههای SIP مجزا برای هر مشتری اجرا میشود و فقط توسط مدیر اصلی فعال میشود؛ `voice-speak` هیچ شماره تلفنی را کنترل نمیکند و هیچ تماس تلفنی را آغاز نمیکند. برای دسترسیپذیری، نسخه آزمایشی باید علاوه بر خروجی صوتی، متن کامل را نیز نمایش دهد. خروجی صوتی نباید شامل اطلاعاتی باشد که به صورت بصری در دسترس نیست. مرورگرها ممکن است پخش را مسدود کنند تا زمانی که هیچ تعامل کاربری رخ ندهد؛ بنابراین، شروع پخش باید به طور آگاهانه از طریق یک کلیک آغاز شود. توقف و پخش مجدد باید به صورت کنترلشده امکانپذیر باشد.
Auth & Absicherung
Keine Authentifizierung erforderlich
بررسی Origin به صورت ثابت روی https://zentor-app.de / https://www.zentor-app.de (غیرقابل پیکربندی، جایگزین برای Widget-Token در مسیر دمو).
Idempotent: Ja
Parameter
visitor_id(body, string, erforderlich)— باید یک UUID معتبر باشدtext(body, string, erforderlich)— متن قابل تبدیل به زبانBeispiel-Response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"قابلیت صوتی در حال حاضر در دسترس نیست."}}Fehlercodes
400 INVALID_VISITOR_ID — visitor_id وجود ندارد یا یک UUID معتبر نیست.403 ORIGIN_DENIED — منشأ درخواست zentor-app.de نیست.503 VOICE_UNAVAILABLE — ویژگی زبانی در حال حاضر در دسترس نیست.Live-Test-Nachweis
موارد منفی (400 INVALID_VISITOR_ID، 503 VOICE_UNAVAILABLE، هر کدام با هدر Origin صحیح) بهصورت زنده تأیید شد. نوع GET از همان مسیر نیز وجود دارد (استریمینگ بومی <audio src>، رفتار یکسان). نسخهٔ نمایشی معادل widget.voice_speak.