POST/api/global-chatbot/demo/voice-speak
המיר טקסט לדיבור (טקסט לדיבור) עבור קריאה קולית בדף הדגמה, אם מופעל.
`POST /api/global-chatbot/demo/voice-speak` ממיר טקסט לדיבור, בתנאי שפונקציית הדיבור מופעלת עבור הדמו. נקודת הקצה (Endpoint) זו משמשת את דף הדמו הציבורי ואינה מתוכננת כ-API כללי לטקסט-לדיבור לשימוש חופשי. אינה נדרשת אימות דרך לוח הבקרה (Dashboard), במקום זאת מופעלת בדיקת Origin קבועה עבור `https://zentor-app.de` ו-`https://www.zentor-app.de`. הבקשה כוללת את הטקסט שיש להשמיע ואת אפשרויות השפה כמתואר בסכמה התיעודית. הלקוח צריך לשלוח רק טקסט שנועד באמת להישמע בדיאלוג הדמו. קלטים ריקים, פורמטים לא חוקיים או פונקציית דיבור שלא הופעלה חייבים להיטפלו כשגיאה. שינוי מקומי של ה-Origin או קריאה מדומיין זר אינם עוקפים את הבדיקה בצד השרת. הפעולה מייצרת אודיו ולכן אינה נחשבת לפעולת קריאה טהורה ואידמפוטנטית. שליחה חוזרת של אותו טקסט עלולה להפעיל מספר תהליכי עיבוד. ממשק הדמו צריך להשבית את כפתור הפלט במהלך העיבוד ולסיים בצורה מסודרת השמעות פעילות לפני התחלת חדשה. תרחיש מציאותי מתחיל בתגובת בוט בדמו. המשתמש מפעיל את הפלט הקולי, העמוד שולח את טקסט התגובה ל-`voice-speak`, מקבל את נתוני האודיו או את תגובת האודיו המתועדת ומשמיע אותם בדפדפן. אם הבקשה נכשלת בשל Origin לא מורשה, הממשק לא צריך לקרוא לשירות חלופי כלשהו, אלא להציג את פונקציית הדיבור כלא זמינה. סיסמאות, טוקנים או תוכן רגיש אינם שייכים לבקשה. ערוץ הדמו הוא ציבורי ואינו מיועד לנתוני חברה סודיים. גם תגובות אודיו לא צריכות להישמר בלוגים ציבוריים לטווח ארוך. נקודת הקצה מופרדת טכנית מ-SIP Voicebot. הטלפוניה פועלת במוסדות SIP מבודדים לכל לקוח (Tenant) ומופעלת אך ורק על ידי מנהל ראשי (Master Admin); `voice-speak` אינו שולט במספר טלפון ואינו מתחיל שיחה טלפונית. למען נגישות, הדמו צריך להציג תמיד את הטקסט המלא בנוסף לפלט האודיו. הפלט הקולי לא יכול להכיל מידע שאינו זמין ויזואלית. דפדפנים עשויים לחסום השמעה כל עוד לא התרחשה אינטראקציה של המשתמש; לכן ההתחלה צריכה להיות מופעלת בכוונה תחילה באמצעות לחיצה. ביטול והשמעה חוזרת חייבים להיות אפשריים בשליטה.
Auth & Absicherung
Keine Authentifizierung erforderlich
בדיקת מקור קבועה ל-https://zentor-app.de / https://www.zentor-app.de (לא ניתן להגדרה, תחליף לטוקן וידג'ט בנתיב הדמו).
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.