Cliniko Integration

ABOUT TELEHAB CLINIKO INTEGRATION

A Cliniko integration enables practitioners to directly access a profile in TeleHab from a client profile in Cliniko – a practice management system.
Once a Cliniko integration has been set up with TeleHab, client profiles in Cliniko can sync with TeleHab.
For example: 
  • When a client profile is created in Cliniko, the profile details can be synced to TeleHab by clicking the Open in TeleHab button in Cliniko. 
  • When a client profile is edited in Cliniko, the updated profile details can be synced to TeleHab by clicking the Open in TeleHab button in Cliniko.
A Cliniko integration also enables practitioners to import a client list from Cliniko into TeleHab.
Note: The Cliniko integration with TeleHab enables a one-way sync of profile data. Once a Cliniko Integration with TeleHab has been set up, client profile details should only be created and updated in Cliniko to avoid being overwritten.
The Cliniko integration process involves the following steps:
  1. Obtain an API Key from Ciniko
  2. Set up Cliniko Integration in TeleHab
  3. Set up access to TeleHab client profile from Cliniko patient profile
  4. [Optional] Import Cliniko client list into TeleHab 

SET UP A CLINIKO INTEGRATION

Step 1 - Obtain an API Key from Cliniko

  1. Log in to your Cliniko account
  2. Click My info on the bottom of the left-hand menu
  3. Scroll down to API key section
  4. Click Manage API keys
  5. Click Add an API key
  6. Input a name for the API key
  7. Click Create API Key
  8. Copy the API key

Step 2 - Set up Cliniko Integration in TeleHab

  1. Log in to your TeleHab practitioner account.
  2. Click the Settings button from the main menu.
  3. Click the Software integration tab
  4. Click Set up Cliniko integration.
  5. Paste the API Key from Cliniko and click Save.

Note:

  • You must have user permissions for TeleHab PMS/EMR link, to access the software integration page 
  • You will receive a message when your integration settings are saved successfully. If integration is not successful, wait a moment and try again. If you are not successful again, please contact support@vald.com.

Step 3 - Set up access to TeleHab client profile from Cliniko patient profile

  1. Open your Cliniko account.
  2. Click Settings on the left-hand menu
  3. Go to Our Clinic
  4. Click Integrations
  5. Scroll down to Connected patient apps section
  6. Input TeleHab into App name field
  7. Copy and paste https://app.telehab.io/app/patients/integration into the App URL field
  8. Click Save connected patient apps
Note:
  • Once setup, when you open a Patient profile in Cliniko you can access the patient's TeleHab profile by clicking the Open in tab on the top right menu.

Step 4 - [Optional] Import Cliniko client list into TeleHab

  1. Ensure you have Set up a Cliniko Integration in TeleHab.
  2. Go to Software integration in Settings.
  3. Click the Sync patients button.
  4. Note: 
    • Cliniko client profiles will be listed, and any profiles with errors will appear at the top of the page.
    • Profile errors will occur when a profile is missing one or more of the following required fields:
      • First Name
      • Last Name
      • Date of Birth
      • Gender (Sex)
      • Email
    • Profile fields should be updated in Cliniko, as profile data only syncs one way - from Cliniko to TeleHab.
    • Profile errors do not need to be updated immediately. TeleHab will save client profiles that fail to sync and these can be updated in Cliniko later.

  5. Click the Start sync button. 
  6. Note: 
    • This may take several minutes, depending on the number of clients being imported.
    • When the sync is completed. Sync results will be displayed.
    • Sync results will display the number of clients synced and the number of failed entries.

  7. Click the X icon on the Sync results.
  8. Click the Go back button to return to the software integration page. This page is where you can access the list of client profiles that failed to sync.

Note: 

  • You can update your TeleHab profile list from the Profiles page. When you click the Sync icon, any new or updated clients in Cliniko will sync with TeleHab.