Additional Integration methods
Additional integration methods for managing patient and service providers
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. This page is intended for those with technical knowledge and the methods described are not available directly inside the Video Call platform.
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