Authorization

CALL TRANSCRIBE - Convert Call recording to text API

This API transcribes a call based on the provided Log ID and other parameters.

Scope : ZohoVoice.call.CREATE

Method : POST

URL : https://voice.zoho.com/rest/json/zv/transcribe

Params: 

Response:

78. {
79.  "code": "200",
80.  "message": "Call Recording transcription has been initiated, and it is expected to take approximately 44 seconds.",
81.  "status": "SUCCESS"
82. }
83. 
    

Note: Transcription time varies depending on the duration of the call recording.

GET TRANSCRIPTION DETAILS

This API retrieves the transcription details of a call when you provide the call Log ID and transcription type.

Scope : ZohoVoice.call.READ

Method : GET

URL: https://voice.zoho.com/rest/json/zv/transcribe

Params: 

Response:

75. {
76.  "code": "200",
77. "transcribeObj": "{\"transcriptionProvider\":\"Zoho\",\"callAnalytics\":[{\"result\":\"Neutral\",\"feature\":\"sentiment\"},{\"result\":\"Happy\",\"feature\":\"emotion\"},{\"result\":\"Query\",\"feature\":\"intent\"},{\"result\":\"The customer, a relationship manager, calls the agent from Zoho and expresses their desire to speak. The agent confirms the time and location of the call. The customer agrees to call back after two hours. The agent expresses their appreciation for the customer's understanding.\",\"feature\":\"summary\"},{\"result\":[{\"highlights\":\"brother I'm I'm driving now yes, just after two hours\",\"reasoning\":[{\"tag\":\"Date\",\"content\":\"now\"}]},{\"highlights\":\"good time\",\"reasoning\":[{\"tag\":\"key-phrase\",\"content\":\"good time\"}]},{\"highlights\":\"relationship manager\",\"reasoning\":[{\"tag\":\"key-phrase\",\"content\":\"relationship manager\"}]},{\"highlights\":\"call\",\"reasoning\":[{\"tag\":\"key-phrase\",\"content\":\"call\"}]}],\"feature\":\"call_highlights\"},{\"result\":[{\"satisfaction_score\":0.82,\"poliness_score\":0.99,\"agent_score\":0.89}],\"feature\":\"call_score\"}],\"transcriptJson\":[{\"start_time\":1.08,\"transcript\":\"Hello\",\"speaker\":1,\"end_time\":1.32},{\"start_time\":3.7092,\"transcript\":\"Yeah hi hello\",\"speaker\":2,\"end_time\":5.6834},{\"start_time\":7.14,\"transcript\":\"yes,\",\"speaker\":1,\"end_time\":7.32},{\"start_time\":9.0934,\"transcript\":\"calling you from Zoho,\",\"speaker\":2,\"end_time\":10.29},{\"start_time\":12.18,\"transcript\":\"yeah,\",\"speaker\":1,\"end_time\":12.36},{\"start_time\":13.7,\"transcript\":\"I'm your relationship manager for yourself. Is this a good time to talk?\",\"speaker\":2,\"end_time\":18.26},{\"start_time\":19.8,\"transcript\":\"no brother I'm I'm driving now\",\"speaker\":1,\"end_time\":21.42},{\"start_time\":22.64,\"transcript\":\"Okay where do you want me to call you back sir?\",\"speaker\":2,\"end_time\":24.74},{\"start_time\":26.64,\"transcript\":\"yes, just after two hours please,\",\"speaker\":1,\"end_time\":28.38},{\"start_time\":29.5336,\"transcript\":\"Yeah, sure then I can give you a call back. Thank you.\",\"speaker\":2,\"end_time\":32.1533},{\"start_time\":32.5668,\"transcript\":\"Okay, thank you, thank you.\",\"speaker\":1,\"end_time\":33.5815}]}",
78.  "status": "SUCCESS"
79. }

DOWNLOAD TRANSCRIPTION

This API allows you to download a call transcription file by providing the call Log ID and transcription type.

Scope : ZohoVoice.call.READ

Method : GET

URL: https://voice.zoho.com/rest/json/zv/transcribe/download

Params: 

Response:

86. <File will be downloaded automatically>
    
87. 
    

DELETE CALL TRANSCRIPTION

This API deletes the call transcription when you provide the call Log ID and transcription type.

Scope : ZohoVoice.call.DELETE

Method : DELETE

URL: https://voice.zoho.com/rest/json/zv/transcribe

Params: 

Response:

112. {
113.  "code": "200",
114.  "message": "SUCCESS",
115.  "status": "SUCCESS"
116. }