+ More

Additional Integration methods

Additional integration methods for managing patient entry and service providers views (For Admins)

This page is intended for health service Information Technology administrators and those with technical knowledge and not intended for patients. The methods described are not available directly inside the Video Call platform.

There are many additional integration methods that you may use on external systems to improve patient management and service providers access to their patients via external systems.

Patient entry via HTTPS Post method

If you have collected patient information from an external system such as online form or EMR, it is possible to prepopulate patient information via URL parameters. These parameters can be passed from an external system or website via a html POST form. Please note, this is not a POST API request. Below is an example code showing how to complete this process. They key to this process is to include the <input name="x-coviu-request" value="" type="hidden"> input field.

HTTPS Post method code example

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Join Acme Demo</title>
</head>
<body>
<form action="https://vcc.healthdirect.org.au/t/acmehealth1/join?skipSetup=1" method="post">
<span>This will start a call for the following patient. (Load patient information from DB)</span>

<div>
<span><strong>First Name:</strong> Jane</span>

<span><strong>Medicare Number:</strong> 1111 22222 3</span>

</div>

<input name="firstName" value="Jane" hidden/>
<input name="lastName" value="Doe" hidden/>
<input name="medicare number" value="1111 22222 3" hidden/>

<input name="x-coviu-request" value="" type="hidden" />
<button type="submit">Start Video Call</button>
</form>
</body>
</html

Video Call Consultations in an iframe

It is possible to complete a video call consultation on your external systems or websites via embedding the video call inside an iframe. When completing this, you must ensure that you have the following permission parameters set for your iframe element. See below for an example of the permissions required:
<iframe id="video-call-iframe" allow="camera; microphone; fullscreen; clipboard-read; clipboard-write" allowfullscreen="" frameborder="0" height="100%" width="100%"></iframe>

You can see an example of Video Call running in an iframe here.

Pre-call Test Embed SDK – Implementation Guide

In an external system it is possible to embed a pre-call test for your patient journey/workflow.

1. Load the SDK
Include the SDK script in your HTML <head> or before your script runs:
<script src="https://tools.coviu.com/precall-sdk/v1/coviu-precall.js"></script>

2. Create a Container for the Test
Add a <div> element in your HTML to hold the iframe:
<div id="precall-container" style="width:100%; height:80vh; border:1px solid #ccc;"></div>
The SDK will render the test iframe inside this container. You can adjust the width/height as needed.

3. Initialize the Pre‑call Test
Use the CoviuPrecallTest constructor:
var test = new CoviuPrecallTest({
containerId: 'precall-container', // container div ID
iframeUrl: 'https://vcc.healthdirect.org.au/precall', //Precall test URL

onComplete: function(result) {
  console.log('Pre-call test completed', result);
  // Display or handle result here
},
onError: function(error) {
  console.error('Pre-call test error', error);
}
});

4. See below for an example code:

Pre-call test Embed SDK - Example Code

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Pre‑call Test Embed SDK – Example</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<style>
body {
width: 100vw;
overflow-x: hidden;
}
</style>
</head>
<body>
<span style="display: flex; align-items: center; justify-content: center; font-size: x-large; ">Pre‑call Test Embed SDK</span>

<script src="https://tools.coviu.com/precall-sdk/v1/coviu-precall.js"></script>
<div id="precall-container" style="width:100%; height:80vh; border:1px solid #ccc;">
</div>
<div id="precall-test-result" style="display: none; padding: 2rem; color: purple; font-family: monospace">
</div>
<script>
function renderJSON(obj, container) {
const ul = document.createElement("ul");
for (let key in obj) {
const li = document.createElement("li");
if (typeof obj[key] === "object") {
li.textContent = key + ":";
renderJSON(obj[key], li);
} else {
li.textContent = `${key}: ${obj[key]}`;
}
ul.appendChild(li);
}
container.appendChild(ul);
}

var test = new CoviuPrecallTest({
containerId: 'precall-container',
iframeUrl: 'https://vcc.healthdirect.org.au/precall',
onComplete: function(result) {
const resultDiv = document.getElementById('precall-test-result');
console.log('Pre‑call test completed', result);
resultDiv.style.display = 'block';
renderJSON(result, resultDiv);
window.scrollTo({
top: document.body.scrollHeight,
left: 0,
behavior: ‘smooth’
});
},
onError: function(error) {
console.error('Pre‑call test error', error);
}
});

window.addEventListener("message", (event) => {
console.log("Message from iframe:", event.data);
});
test.start();
</script>
</body>
</html>

Table of Contents

Patient entry via HTTPS Post method HTTPS Post method code example Video Call Consultations in an iframe Pre-call Test Embed SDK – Implementation Guide Pre-call test Embed SDK - Example Code

Contact Us