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>Last Name:</strong> Doe</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/>
<!-- keep the hidden field; no JavaScript will touch it -->
<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.