POST/api/public/widget/voice-transcribe

விட்ஜெட்டிற்கு குரல் அம்சம் இயக்கப்பட்டிருந்தால், பார்வையாளரின் குரல் பதிவை உரையாக மாற்றுகிறது (குரல் உள்ளீடு).

`widget_code` மற்றும் ஆடியோ தரவை `audio` புலத்தில் `multipart/form-data` ஆக அனுப்பவும். பதிலில் கண்டறியப்பட்ட உரை உள்ளது, அதை நீங்கள் பின்னர் `POST /api/public/widget/message` மூலம் அனுப்புகிறீர்கள். விட்ஜெட் உள்ளமைவில் `voice_enabled` குரல் அம்சம் செயலிலுள்ளதா எனக் காட்டுகிறது. `widget_code` இல்லையெனில் சர்வர் 400 `WIDGET_CODE_REQUIRED`, குரல் அம்சம் இயக்கப்படாவிட்டால் அல்லது தற்போது கிடைக்கவில்லை எனில் 503 `VOICE_UNAVAILABLE` எனப் பதிலளிக்கும். குரல் அம்சத்தை Zentor உங்கள் விட்ஜெட்டிற்காக அமைக்கிறது.

கண்ணோட்டம்

அழைப்பு: POST /api/public/widget/voice-transcribe. இந்த எண்ட்பாயிண்ட் Zentor App API-யின் “அரட்டை விட்ஜெட்” குழுவைச் சேர்ந்தது. இதற்குச் செல்லுபடியான விட்ஜெட் எம்பெட் டோக்கன் தேவை. இந்த அழைப்பு idempotent அல்ல: ஒவ்வொரு வெற்றிகரமான அழைப்பும் செயலை மீண்டும் தூண்டும். கட்டாய அளவுருக்கள்: widget_code (பாடி), audio (பாடி). ஆவணப்படுத்தப்பட்ட பிழை நிலைகள்: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. கீழே உள்ள மாதிரி பதில், JSON வடிவில் வெற்றிகரமான பதிலின் கட்டமைப்பைக் காட்டுகிறது.

அங்கீகாரம் & பாதுகாப்பு

Widget-Embed-Token (Header X-Widget-Token) + Origin அனுமதிப் பட்டியல்

Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): இல்லை

அளவுருக்கள்

widget_code(body, string, கட்டாயம்)— உங்கள் உட்பொதிப்புக் குறியீட்டிலிருந்து விட்ஜெட் குறியீடு
audio(body, binary, கட்டாயம்)— கோப்பாக ஆடியோ பதிவு (`multipart/form-data`)

எடுத்துக்காட்டுப் பதில்

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"குரல் வசதி தற்போது கிடைக்கவில்லை."}}

பிழைக் குறியீடுகள்

400 WIDGET_CODE_REQUIRED — `widget_code` புலம் இல்லை.
503 VOICE_UNAVAILABLE — குரல் அம்சம் இந்த விட்ஜெட்டிற்கு இயக்கப்படவில்லை அல்லது தற்போது கிடைக்கவில்லை.

சரிபார்க்கப்பட்ட நடத்தை

காணாமல்போன `widget_code` 400 `WIDGET_CODE_REQUIRED`-ஐத் திருப்பி அளிக்கிறது, குரல் அம்சம் இல்லாத விட்ஜெட் 503 `VOICE_UNAVAILABLE`-ஐத் திருப்பி அளிக்கிறது. வெற்றி நிலைக்கு குரல் அம்சம் இயக்கப்பட்ட விட்ஜெட் தேவை.

அரட்டை விட்ஜெட்

GET /api/public/widget/healthவிட்ஜெட் சேவையின் எளிய கிடைக்கும் தன்மைச் சோதனை.GET /api/public/widget/config/:widget_codeஉலாவியில் தொடக்கத்திற்காக ஒரு விட்ஜெட்டின் பொது உள்ளமைவை (காட்சிப் பெயர், வரவேற்புச் செய்தி, வடிவமைப்பு, மொழி, குரல் வசதி) தருகிறது.POST /api/public/widget/messageபார்வையாளரின் செய்தியை சாட்பாட்டிற்கு அனுப்பி அதன் பதிலைத் திருப்பி அளிக்கிறது – அரட்டை விட்ஜெட்டின் மைய முடிவுப்புள்ளி.GET /api/public/widget/historyபக்கம் மீண்டும் ஏற்றப்பட்ட பிறகு போன்ற நேரங்களில் விட்ஜெட் உரையாடலின் முந்தைய செய்தி வரலாற்றை ஏற்றுகிறது.POST /api/public/widget/pollஒரு குறிப்பிட்ட நேரத்திற்குப் பிறகு பெறப்பட்ட செய்திகளைப் பெறுகிறது – எடுத்துக்காட்டாக உரையாடலை எடுத்துக்கொண்ட ஊழியரின் பதில்.POST /api/public/widget/ratingஒரு உரையாடலுக்கான பார்வையாளரின் மதிப்பீட்டைச் சேமிக்கிறது (பயனுள்ளது அல்லது பயனுள்ளதாக இல்லை).POST /api/public/widget/trackடாஷ்போர்டு பகுப்பாய்வுகளுக்காக விட்ஜெட்டின் அநாமதேய பயன்பாட்டு நிகழ்வை (எடுத்துக்காட்டாக "விட்ஜெட் திறக்கப்பட்டது") பதிவு செய்கிறது.POST /api/public/widget/voice-speakகுரல் அம்சம் இயக்கப்பட்டிருந்தால், உரையை பேச்சாக மாற்றுகிறது (விட்ஜெட்டில் குரல் வெளியீடு).

சார்ந்த கட்டுரைகள்

உங்கள் இணையதளத்தில் சேட் விட்ஜெட்டை இணைத்தல்உங்கள் அரட்டை விட்ஜெட்டிற்கான உட்பொதிப்புக் குறியீட்டை எவ்வாறு பெறுவது, அதை உங்கள் இணையதளத்தில் எவ்வாறு சேர்ப்பது.உங்கள் Widget-ஐ எந்த டொமைன்கள் ஏற்றலாம்?டொமைன் அனுமதி உங்கள் அரட்டை விட்ஜெட்டை எவ்வாறு பாதுகாக்கிறது, டொமைன்களைச் சேர்க்கவோ மாற்றவோ எவ்வாறு கோருவது.
← அரட்டை விட்ஜெட்