{"templateId":"markdown","versions":[{"version":"2.1-test","label":"2.1 (TEST)","link":"/products/liveidplus/2.1-test/enterprise/get-started/events","default":false,"active":false,"folderId":"ed500da1"},{"version":"2.1","label":"2.1 (latest)","link":"/products/liveidplus/enterprise/get-started/events","default":true,"active":true,"folderId":"ed500da1"},{"version":"2.0","label":"2.0","link":"/products/liveidplus/2.0/enterprise/get-started/events","default":false,"active":false,"folderId":"ed500da1"}],"sharedDataIds":{"sidebar":"sidebar-products/liveidplus/@2.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Events","description":"Integration and usage documentation.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"events","__idx":0},"children":["Events"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page covers two types of events emitted during an active LiveID+ session:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Compatibility Test - Status Checking"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["On Call - Status Change"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call closing events (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["close"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]},") are documented in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/liveidplus/enterprise/get-started/call-closing"},"children":["Call Closing"]}," section."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"compatibility-test---status-checking","__idx":1},"children":["Compatibility Test - Status Checking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before a call with an operator is started, a compatibility test is presented to the user to verify the device network and media requirements are met. The results of this test are reported with different events."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With each status change (e.g., error, success, or unanswered call), LiveID+ sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postMessage"]}," event to the parent page and, if specified, a redirect request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}," (using the method defined by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectMethod"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following events can be intercepted by the integrator:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Event"},"children":["Event"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Details"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEBRTCTEST_OK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The compatibility test was successful. The customer is either waiting for an operator or has already been answered."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEBRTCTEST_KO"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The compatibility test failed. The error details can be retrieved from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," parameter in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postMessage"]}," envelope. A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," parameter is also provided to classify the failure (see the next section)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEBRTCTEST_CALLNOTANSWERED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The compatibility test was successful, but no operator answered the call. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retry"]}," parameter in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postMessage"]}," envelope indicates if the customer attempted to call again (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},") or not (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEBRTCTEST_CALLANSWERED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The compatibility test was successful, and an operator has answered the call. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["idConf"]}," parameter in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postMessage"]}," envelope contains the conference ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEBRTCTEST_CALLCANCELLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The compatibility test was successful, but the customer canceled the call before an operator answered."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For additional reference: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage","target":"_blank"},"children":["MDN Web Docs on postMessage"]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"failure-types-webrtctest_ko","__idx":2},"children":["Failure Types (WEBRTCTEST_KO)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEBRTCTEST_KO"]}," event occurs, a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," code is included in the message to indicate the specific failure reason. The possible values are:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Details"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check system error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Audio stream error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Video stream error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Network speed error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["WebRTC error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["6"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Registered video encoding error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["7"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Registered video encoding error (duplicate)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User didn't confirm the recorded video"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["9"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Browser not supported"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AV_HE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Audio/video devices access error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Audio/video generic error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check operator error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Start call error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bad parameters error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["O"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generic error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Out of hours of service"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"on-call---status-change","__idx":3},"children":["On Call - Status Change"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When LiveID+ is embedded within an iframe, it provides real-time status updates for active calls."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postMessage"]}," event can be intercepted by the integrator to check the status of an active call:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Event"},"children":["Event"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Details"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status_call"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The message can include several properties. Example below."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status_call"]}," message:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"event\": \"status_call\",\n    \"message\": \"Customer landed on module 3 of 11\",\n    \"moduleIndex\": 3,\n    \"idConf\": \"Conference ID\",\n    \"idCall\": \"Video-call ID\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For additional reference: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage","target":"_blank"},"children":["MDN Web Docs on postMessage"]}]}]},"headings":[{"value":"Events","id":"events","depth":1},{"value":"Compatibility Test - Status Checking","id":"compatibility-test---status-checking","depth":2},{"value":"Failure Types (WEBRTCTEST_KO)","id":"failure-types-webrtctest_ko","depth":3},{"value":"On Call - Status Change","id":"on-call---status-change","depth":2}],"frontmatter":{"outline":"deep","title":"Events","scope":"vertical-solutions","product":"LiveID+","category":"get-started","version":"2.0","description":"LiveID+ events reference: compatibility test events (WEBRTCTEST_OK, WEBRTCTEST_KO), failure types, and call status change notifications.","keywords":["events","WebRTC test","WEBRTCTEST_OK","WEBRTCTEST_KO","status_call","compatibility test","LiveID+"],"seo":{"title":"Events"}},"lastModified":"2026-07-16T07:59:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/liveidplus/enterprise/get-started/events","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}