Custom integration speech provider
A custom integration speech provider lets Live Hub use a speech service you have built yourself. Live Hub connects to it as a client, so the service must implement the interface Live Hub expects. See Speech-to-text API and Text-to-speech API for the messages it must handle.
Any field your service needs beyond the ones the API defines can be set at either of two levels:
- Provider level: Enter the parameters in the 'Provider configuration' field. A parameter set on the provider applies to every bot connection that uses the provider.
- Bot connection level: Enter the parameters on the bot connection's Advanced tab. A parameter set on a bot connection applies to that connection only.
If the same parameter is set at both levels, the bot connection value takes precedence.
Add a custom integration speech provider
To add a custom integration speech provider:
-
In the 'Authentication Key' field, enter the shared token Live Hub should present. Your service uses it to identify Live Hub as the caller.
-
Under Advanced:
- In the 'Text-to-speech (TTS) URL' field, enter the address Live Hub should post synthesis requests to.
- In the 'Speech-to-text (STT) URL' field, enter the WebSocket address Live Hub
should open for recognition, in the form
ws://example.com/api/v1/speech:recognizeASR.
-
Optional: In the 'Provider configuration' field, enter the advanced configuration parameters that apply to every bot connection using this provider. If your service presents a self-signed certificate, set
ttsAllowSelfSignedCertandsttAllowSelfSignedCerttotruehere. See Configure advanced parameters at the provider level.Enabling a self-signed certificate makes the connection to your service less secure and open to manipulation. Use it only where the service cannot present a properly signed certificate.
-
Click Create.
Configure advanced parameters at the provider level
The JSON you enter in 'Provider configuration' is merged into every request Live Hub sends to your service, so it applies to every bot connection using this provider.
Configure advanced parameters at the bot connection level
Live Hub builds each request to your service from the bot connection: the conversation
ID, the language, the audio format, and the voice. If your service needs a field the API
does not define, add it under sttPassthruConfig and ttsPassthruConfig in the JSON
editor on the bot connection's Advanced tab. Live Hub merges what you enter into the
request it sends you, and passes on whatever you name. See
Manage bot connections.
{
"sttPassthruConfig": {
"myServiceProfile": "support-line"
},
"ttsPassthruConfig": {
"myServiceProfile": "support-line"
}
}