Skip to main content

Uniphore Help Center Portal

Update Deepgram ASR Configuration

This API allows you to add Deepgram ASR to the Uniphore Voice Connector and update the configuration. Currently supports US English (en-us).

Endpoint

Method: PUT

URL: https://<<hostname>>/cse/connector/uvc/interactDomain/virtualAgent/<<vrmId>>/language/<<langID>>/updateDeepgramAsrConfig?currentAsrProvider=DEEPGRAM-ASR' \

curl -X 'PUT' \
  'https://<<hostname>>/cse/connector/uvc/interactDomain/virtualAgent/2/language/4/updateDeepgramAsrConfig?currentAsrProvider=DEEPGRAM-ASR' \
      -H 'accept: application/json' \
      -H 'Tenant-Id: <<TenantName>>' \
      -H 'Environment-Name: dev' \
      -H 'Authorization: Bearer 1NiIsInR5cCI6IkpXVCIsImtpZCI6IkxYejBQYWVFRERuS3dfcjdkU2s2UyJ9.eyJpc3MiOiJodHRwczovL2Rldi1nMmo1bXUyei51cy5hdXRoMC5jb20vIiwic3ViIjoiMWd1UEFna3lPY2haUUl5Q1NEU3JCZ3hHanZiT3dhUk9AY2xpZW50cyIsImF1ZCI6ImFwaS51bmlwaG9yZS5jb20iLCJpYXQiOjE3NDg5NDc4MTYsImV4cCI6MTc0OTU1MjYxNiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIiwiYXpwIjoiMWd1UEFna3lPY2haUUl5Q1NEU3JCZ3hHanZiT3dhUk8iLCJwZXJtaXNzaW9ucyI6W119.Sb8HMHlFcuMRg_F6hcJ-24PyiLJjN-0fO_Fcqo4sJ9O4MKOa5n20bxG-47cPbpy5Cy-ZU7JNvEzIAFmvqqY9zmFkM55I00lu94mlXyHv9jcjM70-XHuYwtuXhcFEizfTy6Foz6iq5hIfNRaKFdJb5KulgCPyHPHWXUh2vqXlaQlSTQpn5CSss0rW5939pUQ-eA1M573tBaZoR1pBDQc24RVw-5rQUNa8D8toMoe5lQQuOuahOsE945dkVCEg1h4CGfKYH62LRvdUbnFmc948YKsu4nS5tbSFgCMx6x1lTj_5mSFKgP-A-rjCtr6AEmqLgp7MvMYz13WoIQYpxQp61A' \
      -H 'Content-Type: application/json' \
      -d '{
              "bufferSize": 320,
              "enableSpeechFinal": true,
              "endpointingInMilliSeconds": 300,
              "utteranceEndInMilliSeconds": 1000,
              "licenseKey": "aec2fabf8452c0bce659830246877d81c9d9095"
            }'
Header Parameter
Authorization - <Bearer

To learn more about Authorization, click here.

Path Parameter

Parameter Name

Data Type

Description

Required/ Optional

vrmId

String

ID of the Virtual Agent and Role combination

Required

langId

String

ID of the language

Required

Note

To obtain vrmId and langId, refer to the Fetch Virtual Agent Details API.

Query Parameter

Parameter Name

Data Type

Description

Required/ Optional

currentAsrProvider

String

Enter the name of the ASR provider. Currently, only Deepgram ASR is supported and it is therfore set as the default value.

Required

Request Parameter

Parameter Name

Data Type

Description

Required/ Optional

bufferSize

Number

The default value is set to 320, which represents the size of the packet sent to Deepgram ASR.

Always use the given default value. Do not modify the value unless required.

Required

enableSpeechFinal

Boolean

If set to True, ends the transcription immediately once it detects the end of speech. The value is set to True by default.

Always use the given default value. Do not modify the value unless required.

Required

endpointingInMilliSeconds

Number

Instructs Deepgram to treat 300 milliseconds of silence as the end of the user's speech. The value is set to 300 by default.

Always use the given default value. Do not modify the value unless required.

Required

utteranceEndInMilliSeconds

Number

Defines the duration of silence (in milliseconds) required to consider that the user has finished speaking. The value is set to 1000 by default.

If there is a 1000 millisecond pause in speech, Deepgram treats it as the end of the utterance.

Always use the given default value. Do not modify the value unless required.

Required

licenseKey

String

License key of the ASR.

Required

Sample Request
{
  "bufferSize": 320,
  "enableSpeechFinal": true,
  "endpointingInMilliSeconds": 300,
  "utteranceEndInMilliSeconds": 1000,
  "licenseKey": "aec2fabf8452c0bce659830246877d81c9d9095"
}
Response and Error Codes

Response Code

Condition

200

OK

400

Bad Request

401

Unauthorized

500

Internal Server Error