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

Send users directly to a filtered view of the waiting area:

It is possible to send users directly to a filtered view of the Waiting Area via external systems such as booking tools. This is done by creating a special link that includes a “filter” query parameter. When someone opens that link they arrive with the Waiting Area already filtered to show only the specific filters applied. This could be used to filter to a specific patient ID or any other configured patient entry field.

The link format requires encoding as JSON. An example in JavaScript is shown below:

const filters = {
patientid: '1234'
};
const link =
'https://vcc.healthdirect.org.au/t/acmehealth1/team/waiting-area?filters='
+ encodeURIComponent(JSON.stringify(filters));
console.log(link);

This produces a URL like:
https://vcc.healthdirect.org.au/t/acmedemo/team/waiting-area?filters=%7B%22patientid%22%3A%221234%22%7D

When opened, the Waiting Area will automatically:
● Apply the filter defined in the filters object.
● Display only the patient (or entry) that matches the specified value (patientid: 1234 in this example).

The filters object can contain any valid field configured in your Waiting Area. This can be particularly useful with some kind of Patient ID field.
● This feature requires development work in the external system to enable pointing practitioners to the filtered view of their desired Waiting Area

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>

Contact Us

Topics

Additional Integration methods