Setup Teleconsultation Feature

Teleconsultation in Bahmni is a remote way of connecting Patients and Doctors who cannot connect face to face. Bahmni teleconsultation is web-connected with the existing system which supports patients and doctors to join in a video call together. Read more about the feature here.

Bahmni leverages Jitsi as a platform to enable video consultations between patients and doctors. The default setup uses meet.jitsi.si which can be used for testing/demo purposes. For production use-cases we highly recommend self hosting the jitsi service. Read more about setting up Jitsi in the following pages.

Detailed guide - Self-Hosting Guide - Overview | Jitsi Meet

On Docker - Self-Hosting Guide - Docker | Jitsi Meet

Once you self-host Jitsi, update the URL pattern in OpenMRS → Administration → Settings → Bahmni → Appointment Tele Consultation Server Url Pattern property with your domain name.

Related Pages

Enabling Teleconsultation Appointments

Bahmni Appointment Scheduling module allows marking an appointment as Teleconsultation appointment upon which a teleconsultation link will be generated and the provider and the patient can join.

Enable Teleconsultation Appointments Feature

In your implementation specific configuration, add the allowVirtualConsultation property with value as true in the openmrs/apps/appointments/app.json file.

  "config": {
    "allowVirtualConsultation": true,

Now when scheduling an appointment, one can find the option to mark it as Teleconsultation as shown in the below screenshot.

Once the appointment is scheduled as teleconsultation, the meeting can be joined either from the appointments page and opening the appointment and clicking on the Join Teleconsultation button or from the appointments display control and clicking on the Join Teleconsultation button from there.

Appointments Details View Pop-Up

Enable Adhoc Teleconsultation

This feature is applicable starting Bahmni Lite v1.0.0 or Bahmni Standard v1.0.0

Bahmni provides the ability for a clinician to start an Adhoc Tele-consultation (on-demand) with a patient. To enable this, one needs to set allowAdhocTeleConsultation to true in /openmrs/apps/clincal/app.json in your implementation specific configuration. Note this config should be in clinical/app.json.

"config": {
        "allowAdhocTeleConsultation": true,

Enabling Email Notifications for Teleconsultation

Bahmni supports sending Email notification to the patient on booking a teleconsultation appointment with the teleconsultation meeting link or when an adhoc teleconsultation is started.

For emails to be sent the patient’s email needs to be captured while registration. Add a person attribute as email and capture it during registration.

To enable email sending, you need to configure SMTP server details in the .env file. Follow this page to setup SMTP information to OpenMRS service in docker compose.

There are few global properties which can be used to configure email subject and content templates. The configure the below properties, navigate to OpenMRS → Administration → Settings → Bahmni

Appointment Tele Consultation Server Url Pattern → The Jitsi Domain URL pattern with which teleconsultation will happen.
Appointment Tele Consultation Send Email → Defines whether or not the send email. Set this to true
Appointment Tele Consultation Patient Email Notification Subject → Subject Line for teleconsultation appointment booking confirmation
Appointment Tele Consultation Patient Email Notification Template → Content template for teleconsultation appointment booking information.
Appointment Adhoc Tele Consultation Patient Email Notification Subject → Subject Line for adhoc teleconsultation meeting started
Appointment Adhoc Tele Consultation Patient Email Notification Template → Content template for adhoc teleconsultation meeting.
Appointment Adhoc Tele Consultation Bcc Emails → Additional Emails to send notification when an adhoc consultation is started.