Voice Insights API

API phục vụ phân tích file ghi âm

Bước 1: Đăng ký webhook url để nhận kết quả ASR

POST https://public-v1-stg.omicrm.com/api/ai/register_webhook_ai

Headers

Name	Type	Description
apiKey*	String	Token xác thực để truy cập API

Request Body

Name	Type	Description
url*	String	Đường dẫn nhận dữ liệu

200: OK Thành công

Kết Quả Từ Hook

Name	Type	Description
analyst_results	Object	Tổng hợp các kết quả phân tích
criteria_classification_result	Object	Kết quả chấm điểm tự động theo bộ tiêu chí
customer_talk_time	Double	Thời gian nói của khách hàng
customer_word_alignments	String	Kết quả chi tiết từng từ của khách hàng từ ASR
keyword_count	Object	Danh sách từ khóa tìm được và số lần xuất hiện
nl_analyze_result	Object	Kết quả trả về từ mô hình ngôn ngữ lớn (LLM) như GPT
quality_evaluation_result	Object	Bảng điểm chất lượng tổng hợp cho STAFF và CUSTOMER
result_nlp_analytics	Object	Kết quả chi tiết từng phân đoạn hội thoại. Tổng hợp thông tin theo một câu nói
staff_talk_time	Double	Thời gian nói của nhân viên
staff_word_alignments	Object	Kết quả chi tiết từng từ của nhân viên từ ASR
tracking_id	String	ID truyền vào lúc gửi request phân tích qua để Mapping kết quả với request

Bước 2: Upload audio, kết quả ASR sẽ được trả về webhook url

POST https://public-v1-stg.omicrm.com/api/ai/call_analyze

Headers

Name	Type	Description
apiKey*	String	Token xác thực để truy cập API
Content-Type	String	multipart/form-data;

Request Body ( Form Data)

Name	Type	Description
file*	String	audio file (định dạng hỗ trợ .wav/ . mp3/.m4a ) muốn chuyển sang text
tracking_id*	String	String chứa ID để khi nhận Webhook client biết kết quả của request nào

200: OK