Frequently Asked Questions
Here you can find a collection of questions commonly asked of our Customer Success team. If you have a deployed digital human and are running into any of the following issues, please check the suggestions below. You can also view our status page at any time to check for open incidents.
Things to check | Suggestion |
|---|---|
Does the user have internet connectivity? | UneeQ’s digital humans rely on video streaming and require a working network to function. |
Is the user using a supported browser? | Please see our list of , displayed at the bottom of the linked page. |
Was a valid obtained? | If you've built your own UI and no token is being returned, please check with your IT team to ensure their token server API is working. If no fault is found with your token server API, please check our for any incidents. |
Is there a SessionErrorMessage being returned within the browsers developer console? | If so, please check the message body for the error message. If these are intermittent please contact your Customer Success representative, or email for assistance. If these happen constantly, and on different networks, please check our status page for any incidents. |
Is there an AvatarUnavailableMessage in the browser’s developer console? | This can happen if you’ve reached your pre-defined user concurrency limit that would have been discussed with your Customer Success representative before going live. If this is happening often, please contact your Customer Success representative, or email for assistance. |
How much bandwidth does a digital human conversation require? | UneeQ uses the WebRTC protocol for streaming real-time audio and video. Current WebRTC implementations use Opus and VP8 codecs:
|
What network requirements are there for the web client? |
|
Things to check | Suggestion |
|---|---|
Is a SessionErrorMessage being returned when the user tries talking to the digital human? | If so, please check the message body for the error message. These are generally returned from the orchestration layer you have provided to UneeQ for the purpose of obtaining responses to the user questions. Please check with your IT team if they are seeing any errors with this API. |
Is there an AvatarAnswerMessage in the developer console of the browser? | If this message is being received, and contains a response to speak, please check our for any incidents. |
Things to check | Suggestion |
|---|---|
Is there an AvatarQuestionMessage in the developer console? | If there is an AvatarQuestionMessage shown in the developer console, but the “question” field (shown when expanded) is empty, this could be due to incorrect microphone setup on the user’s device. |
If you have implemented a way for the user to type a question, does the digital human respond using this method? | If there is an AvatarQuestionMessage shown in the developer console, but no AvatarAnswerMessage, and no SessionErrorMessage, OR the digital human is not speaking a response, please check our for any incidents. |
Things to check | Suggestion |
|---|---|
Checked the returned error codes from calling in to UneeQ’s /speak API? | Please view the section of our /speak API docs to see more information on the returned error codes. Please contact your Customer Success representative, or email [email protected] if this does not help resolve the issue. |
If the returned status code is 204 and the frontend does not receive an AvatarAnswerMessage in the browser's developer console? | Please check our for any incidents. |
Things to check | Suggestion |
|---|---|
My digital human's lips are not moving? | If your digital human is talking, but their lips are not moving, please check our for any incidents. |
My digital human's lip movement is not synchronized to the words spoken? | If your digital human's lips don’t appear to match the sounds they are making, or the sound and mouth movements are out of sync, please contact your Customer Success representative, or email . |
My digital human is frozen on screen and not responding? | UneeQ’s digital humans rely on video streaming and require a working network to function. Check for a SessionErrorMessage that contains media timeout information. This normally happens when the network isn’t stable. |
Things to check | Suggestion |
|---|---|
The display of on-screen content when building your own UI is the responsibility of the implementer of that UI, as it is not rendered by UneeQ’s platform. | Please contact your Customer Success representative, or email for assistance as to why content is not being displayed. |
UneeQ uses WebRTC as a streaming protocol, so the browser that your users connect on must be capable of rendering WebRTC for real time interactions.
As a guide: our SDK supports Chrome on both Windows 10 and MacOS (High Sierra or later) and Safari on MacOS. It also supports Chrome on Android (6.0 and above) and Safari on iOS (11 or higher) for mobile browsers.
The SDK's browser support is actively maintained for the most recent version of these browsers running on the most recent version of the given operating systems unless otherwise specified.
If your question hasn't been answered, you can let us know by contacting your Customer Success representative, or by emailing [email protected]. Alternatively if you're in Creator, you can let us know via the Contact page.