STT 결과 이벤트 (Agent → 콜브릿지 통화시스템)* Agent 또는 사용자의 발화를 음성 인식(STT)으로 텍스트로 변환한 결과를 전달하는 이벤트입니다
1. API 개요
STT 결과 전송 (Agent → 콜브릿지 통화시스템)
STT 결과 이벤트Agent와 사용자 간 음성 대화 내용을 문장 단위 텍스트로 전달하는 이벤트입니다.
Agent 또는 사용자의 음성이 STT(Speech-to-Text)를 통해 텍스트로 변환되면
해당 텍스트가 WebSocket 이벤트로 콜브릿지 통화시스템에 전달됩니다.
이 이벤트는 다음 용도로 활용될 수 있습니다.
•
대화 로그 저장
•
상담 화면 실시간 표시
•
상담 분석 및 QA
•
대화 기록 관리
Plaintext 설명
STT 결과 이벤트는 사용자 또는 Agent의 발화가 텍스트로 변환되었을 때 발생합니다.
음성 대화가 진행되는 동안 STT 처리 결과가 문장 단위로 전달되며
각 발화는 누가 말했는지(role) 정보와 함께 전달됩니다.
2. 사전 조건 / 권한
•
콜브릿지 계정 필수
•
WebSocket 음성 세션 연결 상태
3. API 정보
Method / Endpoint
wss {wss 또는 ws}://{상담콜내 연동정보 입력한 주소}
4. Request
Request Body
이름 | 타입 | 필수 | 기본값 | 설명 |
type | string | O | stt_result | 이벤트 타입 |
Request Body
stt_result
이름 | 타입 | 필수 | 기본값 | 설명 |
role | string | O | - | 발화 주체 (agent 또는 user) |
text | string | O | - | STT로 변환된 텍스트 |
Request Example
{
"type": "stt_result",
"stt_result": {
"role": "user",
"text": "상담원 연결 부탁드립니다."
}
}
JavaScript
복사
5. 이벤트 전송 타이밍
상황 | 이벤트 발생 |
사용자 발화 STT 변환 완료 | stt_result 이벤트 전송 |
Agent 발화 생성 | stt_result 이벤트 전송 |
이 이벤트는 각 발화 문장이 확정될 때마다 전송됩니다.