{"templateId":"markdown","versions":[{"version":"2.2","label":"2.2 (latest)","link":"/fr/products/liveidplus/enterprise/get-started/integration","default":true,"active":true,"folderId":"0c34c4e0"},{"version":"2.2-test","label":"2.2 (TEST)","link":"/fr/products/liveidplus/2.2-test/enterprise/get-started/integration","default":false,"active":false,"folderId":"0c34c4e0"},{"version":"2.1","label":"2.1","link":"/fr/products/liveidplus/2.1/enterprise/get-started/integration","default":false,"active":false,"folderId":"0c34c4e0"},{"version":"2.0","label":"2.0","link":"/fr/products/liveidplus/2.0/enterprise/get-started/integration","default":false,"active":false,"folderId":"0c34c4e0"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/fr/products/liveidplus/@2.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Integration","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integration","__idx":0},"children":["Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The LiveID+ service provides several integration features:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["inbound integration (start of video identification call) for synchronous calls;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["outbound integration (client-side video identification status callback and server-side fully customizable callback) for synchronous calls;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["asynchronous calls;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["other useful features."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is highly recommended to use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["asynchronous calls method"]}," as it provides better control of the call flow."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"inbound-integration","__idx":1},"children":["Inbound Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The inbound integration feature allows organizations to start a video identification call from their own web application. This feature is useful for organizations that want to integrate video identification into their existing workflows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All the details can be found in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/liveidplus/enterprise/developer-documentation/api-definition/app/servicestart"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app/service-start"]}]}," API description."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"integration-modes","__idx":2},"children":["Integration Modes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two modes in which the video identification call can be initiated:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standalone mode"]},": The call is launched in a new browser tab. Supports server-side callbacks and redirect URL for client-side callbacks."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Embedded mode"]},": The call is launched within an HTML iframe directly in the client page, allowing for real-time client-side callbacks via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["window.postMessage"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"embedded-mode-setup","__idx":3},"children":["Embedded Mode Setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you choose to use embedded mode, the iframe must have the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allow"]}," property set to include geolocation, camera, and microphone access:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<iframe src=\"...\" allow=\"geolocation; camera; microphone\"></iframe>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"starting-a-call","__idx":4},"children":["Starting a Call"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To start a video identification, submit a POST request to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/liveidplus/enterprise/developer-documentation/api-definition/app/servicestart"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app/service-start"]}]}," with the following required parameters:"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_organization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Organization code (provided by Namirial during setup)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_process"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Process identifier (provided by Namirial during setup)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object (Base64)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UTF-8 Base64 encoded JSON containing customer data and configuration"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}," parameter must be a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["UTF-8 Base64"]}," encoded JSON object following the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ServiceStartJson"]}," schema. It contains customer information, callback configuration, and custom data fields."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}," structure (before Base64 encoding):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"lang\": \"en\",\n  \"liveid_email\": \"john.doe@example.com\",\n  \"liveid_name\": \"John\",\n  \"liveid_surname\": \"Doe\",\n  \"liveid_servercallback\": {\n    \"url\": \"https://your-system.com/callback\",\n    \"otherParams\": {\n      \"custom_reference\": \"REF-12345\"\n    }\n  },\n  \"liveid_priorityQueueLevel\": 0,\n  \"data\": {\n    \"fiscal_code\": {\n      \"datatype\": \"text\",\n      \"label\": \"Fiscal Code\",\n      \"value\": \"RSSMRA85M01H501Z\",\n      \"order\": 1,\n      \"readonly\": true\n    },\n    \"birth_date\": {\n      \"datatype\": \"date\",\n      \"label\": \"Date of Birth\",\n      \"value\": \"1985-08-01\",\n      \"order\": 2\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The required fields are: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lang"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["liveid_email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["liveid_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["liveid_surname"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," object contains custom data fields where each field has the following properties:"]},{"$$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":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["datatype"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTML input type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["text"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkbox"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["month"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display label for the field"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Value of the field"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["display"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"none\""]}," to hide the field, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"operator\""]}," for operator-only visibility"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display order of the field"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["disabled"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["readonly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["required"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxlength"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["min"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pattern"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["placeholder"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["various"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Standard HTML input attributes for validation"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["liveid_servercallback"]}," object configures the server-side callback endpoint (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#outbound-integration"},"children":["Outbound Integration"]},"):"]},{"$$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":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (URI)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTPS endpoint to call at the end of the process (must be pre-approved by Namirial)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["otherParams"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional key-value pairs to include in the callback POST request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["headers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional HTTP headers to include in the callback request"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"optional-parameters","__idx":5},"children":["Optional Parameters"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom ID to identify the call in reports (max 100 characters)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (URI)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL where the browser redirects at end of process"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTP method for the redirect: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_operator2Call"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Route call to a specific operator by LiveID+ ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_operator2Call"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (email)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Route call to a specific operator by email"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extId_operator2Call"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Route call to a specific operator by external ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["direct"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (JWT)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique token for calling a specified operator"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opInfo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Information to show the operator before answering (max 100 chars)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skipAVrecTest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Skip audio/video recording check in compatibility test"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["disableRTCTest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Skip WebRTC check (only for processes without video registration)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_operator2Call"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_operator2Call"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extId_operator2Call"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["direct"]}," are mutually exclusive. When any of these is set, the call is terminated if the specified operator does not answer — it is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," reassigned to another operator."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"self--live-process-combination","__idx":6},"children":["Self + Live Process Combination"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Instead of specifying a single ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_process"]},", you can use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_process_live"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_process_self"]}," together to let LiveID+ automatically determine whether to start a live or self-identification process based on preconfigured criteria. These two parameters are mutually exclusive with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_process"]},"."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"outbound-integration","__idx":7},"children":["Outbound Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a video identification call is initiated, the LiveID+ service provides the ability to receive status updates about the call."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The application can receive the status updates in three ways:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["client-side callback"]},": served on client side using the HTML iframe postMessage API;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["redirect parameter"]},": when a redirect URL is provided, the LiveID+ client will redirect the user to the specified URL passing the result as a parameter (GET or POST, configurable via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectMethod"]},");"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["server-side callback"]},": in the form of POST requests to a specified HTTPS endpoint."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"client-side-callback","__idx":8},"children":["Client-Side Callback"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In case of an embedded integration (via HTML iframe), LiveID+ sends ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postMessage"]}," events to the main integrator's page to report the results of network and media tests, as well as the status of an active call.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"These messages originate from the LiveID+ client platform and can be received by the parent page hosting the iframe."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To handle these messages, a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," event listener must be registered on the client page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example (JavaScript):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"window.addEventListener(\"message\", function (event) {\n    switch(event.data.event) {\n        case 'close':\n            // Handle close event\n            break;\n        case 'error':\n            // Handle error event\n            break;\n        case 'WEBRTCTEST_OK':\n            // Compatibility test passed\n            break;\n        case 'WEBRTCTEST_KO':\n            // Compatibility test failed\n            break;\n        case 'WEBRTCTEST_CALLANSWERED':\n            // Operator answered, event.data.idConf contains conference ID\n            break;\n        case 'WEBRTCTEST_CALLNOTANSWERED':\n            // No operator answered, event.data.retry indicates retry attempt\n            break;\n        case 'WEBRTCTEST_CALLCANCELLED':\n            // Customer cancelled the call\n            break;\n        // ...\n        case 'status_call':\n            // Real-time call status update\n            break;\n        default:\n            // Handle other cases\n            break;\n    }\n});\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"redirect-parameter","__idx":9},"children":["Redirect Parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}," is provided in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app/service-start"]}," method, the LiveID+ client will redirect the user to the specified URL, passing the JSON result in a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LiveIDPlusResult"]}," parameter. The HTTP method used for the redirect can be configured via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectMethod"]}," parameter (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},", defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"server-side-callback","__idx":10},"children":["Server-Side Callback"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["liveid_servercallback"]}," parameter is specified in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}," object when starting a call, LiveID+ sends a POST request to the specified URL for call closing status events and errors."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["For security reasons, the server callback domain must be HTTPS and pre-approved by the LiveID+ team."]}," ","To ask for approval, please contact the LiveID+ support team at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:liveidplus.support@namirial.com"},"children":["liveidplus.support@namirial.com"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Server callback payload:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"closeStatus\": \"N\",\n  \"otherParams\": { },\n  \"idConference\": \"conference-uuid\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["closeStatus"]}," values are: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]}," (successfully completed), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S"]}," (suspended), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]}," (aborted), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["K"]}," (system error)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["It is possible to register an email address to receive notifications when server-side callbacks fail. This can be done by using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v2/registerAlertEmail"]}," API."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","More details on the events messages can be found in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/liveidplus/enterprise/get-started/events"},"children":["Events"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/liveidplus/enterprise/get-started/call-closing"},"children":["Call closing"]}," sections."]},{"$$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":"useful-service-apis","__idx":11},"children":["Useful Service APIs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["LiveID+ provides a set of utility APIs that can help integrators manage the call experience:"]},{"$$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":"API"},"children":["API"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/service/getAvailableOperators"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get the number of operators currently available for an organization"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/service/getQueue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get the number of people in queue for a specified process"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/service/availableLanguages"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get the languages spoken by an organization's operators"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/service/getDailyWaitingTimes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get average daily waiting times (last week and last 60 minutes)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All these APIs require the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orgCode"]}," (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_process"]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getQueue"]},") parameter."]},{"$$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":"third-party-integration","__idx":12},"children":["Third-party integration"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/assets/liveidcalendlyintegrationexample.d12227c384161eb3dabe323e2f385cee8dbc24760c218e7e40042d5280117245.fbb99879.pdf"},"children":["LiveID+ Calendly Integration (example)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/assets/liveidesignanywherethird-partyapiintegration.fc361a9f96780ded6fce2ee4eeb3bb5648fb9660661171075b6c8cb06b563eb5.fbb99879.pdf"},"children":["LiveID+ eSignAnyWhere third-party API integration"]}]}]}]},"headings":[{"value":"Integration","id":"integration","depth":1},{"value":"Inbound Integration","id":"inbound-integration","depth":2},{"value":"Integration Modes","id":"integration-modes","depth":3},{"value":"Embedded Mode Setup","id":"embedded-mode-setup","depth":4},{"value":"Starting a Call","id":"starting-a-call","depth":3},{"value":"Optional Parameters","id":"optional-parameters","depth":4},{"value":"Self + Live Process Combination","id":"self--live-process-combination","depth":4},{"value":"Outbound Integration","id":"outbound-integration","depth":2},{"value":"Client-Side Callback","id":"client-side-callback","depth":4},{"value":"Redirect Parameter","id":"redirect-parameter","depth":4},{"value":"Server-Side Callback","id":"server-side-callback","depth":4},{"value":"Useful Service APIs","id":"useful-service-apis","depth":2},{"value":"Third-party integration","id":"third-party-integration","depth":2}],"frontmatter":{"outline":"deep","title":"Integration","scope":"vertical-solutions","product":"LiveID+","category":"get-started","version":"2.0","description":"LiveID+ integration guide covering inbound and outbound patterns: standalone mode, iframe embedding, service-start API, and server callbacks.","keywords":["integration","inbound integration","outbound integration","iframe","service-start API","postMessage","LiveID+"],"seo":{"title":"Integration"}},"lastModified":"2026-11-02T09:40:19.000Z","isTranslationFallback":true,"pagePropGetterError":{"message":"","name":""}},"slug":"/fr/products/liveidplus/enterprise/get-started/integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}