Skip to main content

VALD Integration Setup and Use

Connect VALD Performance to Motics, and choose which VALD metrics to add to a session.

Written by Dr. Harvinder Power

The VALD Performance integration lets you add objective test data from VALD to a session. You choose the assessment and the metrics. Motics uses the metrics when it writes the summary.

Before you start

  • You need VALD API access for your organisation.

  • You need your VALD Client ID and Client Secret.

  • You need to know your VALD region.

Get VALD API access

If you do not have VALD API credentials, do these steps. The same steps show in Motics under Set up VALD API access.

  1. Find your organisation ID in VALD Hub.

  2. Send an email to [email protected]. Ask for access to the external APIs. Include your organisation ID.

  3. Sign the API License Agreement that VALD sends to you. Send it back to VALD.

  4. Open the welcome email from VALD. Copy the Client ID and the Client Secret.

Caution: The link in the VALD welcome email expires after seven days. Save the credentials immediately.

Connect VALD in Motics

  1. Go to Settings.

  2. Select Integrations.

  3. Find VALD Performance in Assessments & Measurement Devices.

  4. Select Connect.

  5. In Client ID, paste your client ID.

  6. In Client Secret, paste your client secret.

  7. In Region, select Australia East, United States East or Europe West.

  8. Select Verify and connect.

  9. If Motics asks you to choose a tenant, select it in Tenant. Then select Finish setup.

Motics shows the message VALD connected.

Add VALD metrics to a session

  1. Open the session.

  2. Select the Assessments tab.

  3. Open the VALD panel.

  4. Select Search by patient name…. Type at least 2 characters. Then select the VALD profile.

  5. In Device, select the VALD device.

  6. Select an assessment in the list. Motics opens a list of the metrics in that assessment.

  7. Select the metrics that you want. To select or clear all metrics, use Add to session.

  8. Select Add N metrics to session. N is the number of metrics that you selected.

The assessment shows the number of metrics in the session, for example "3 of 12 added to session".

Note: You can add up to 5 VALD assessments to one session. The VALD panel shows how many are attached, for example "2/5 attached".

Note: If you do not see an assessment, select Widen search to last to look further back.

Change the metrics

  1. Select the assessment again.

  2. Select or clear metrics.

  3. Select Update selected metrics.

Note: If you clear all metrics and close the window, Motics removes the assessment from the session.

Remove assessments

  • To remove one assessment, select the X on the assessment. The tooltip is Remove from session.

  • To remove all assessments, select the X next to the attached assessments. The tooltip is Detach all assessments. Then select Detach all.

You can add the assessments again at any time.

How Motics uses VALD data

  • Motics treats VALD metrics as objective measurement data.

  • Motics keeps the numbers exactly as VALD gives them.

  • Motics shows that the numbers come from VALD, not from the conversation.

  • Motics does not interpret the numbers, unless your template tells it to.

Disconnect VALD

  1. Go to Settings, then Integrations.

  2. Select Manage on the VALD Performance row.

  3. Select Disconnect.

  4. Select Yes, Disconnect.

If something goes wrong

  • You see "Unable to connect VALD". Check the client ID, the client secret and the region. Then try again.

  • You see "No VALD profiles matched." Check the spelling of the patient name in VALD.

  • You see "Limit reached". The session already has 5 assessments. Remove one first.

  • You see "No assessments found." Check the device. Then select Widen search to last.

If you still cannot connect, ask VALD support to confirm that your credentials can search profiles and list tests. Then contact us in the chat.

Did this answer your question?