In cases where the medical facility would want to notify the patients upon scheduling/updating any type of appointment, then it should trigger an SMS with appointment details like time, date, location of the appointment, etc to the phone number added to the patient.
Currently Bahmni supports sending an SMS notification upon appointment scheduling/updation of any patient based on configurations.
Note : If the patient is not registered with phone number, then one can't send SMS notification for appointments.
| |
---|---|
One needs to bring up the |
One can enable sending SMS option upon appointment scheduling/updation of any patient in the medical facility. For this we have to update the global property values.
Go to OpenMRS → Admin → Advance Settings and set sms.endpoint
global property value as /sms-service/notification/sms
. If the property is not available in the Advance Settings, create one and set the value.
Go to OpenMRS → Admin → Advance Settings and set sms.enableAppointmentBookingSMSAlert
global property value as true
. By default, the value will be false
and the SMS won't get triggered upon scheduling any appointments to a patient. If the property is not available in the Advance Settings, create one and set the value. Once this is enabled, the SMS will get triggered automatically.
One needs to have the privilege Send SMS
for sending any SMS. For this we have to assign the privilege to user’s role.
Go to OpenMRS → Manage Roles → Select Role which needs to have the privilege for sending SMS → assign the privilege Send SMS
→ save the role. The SMS won’t be sent if the user who are triggering the SMS doesn’t have this privilege.
One needs to configure the attribute name where the phone number of the patients are getting stored in the database since attributes may vary in different environments. To configure the same, please add the following configurations under config section in the appointments/app.json file.
"smsAttribute": "phoneNumber" |
Here "phoneNumber"
is a person_attribute_type
whose value will have the contact number of the patient. In some other cases, it may be stored as "primaryContact"
in the table person_attribute_type
To configure the message content for appointments SMS alerts, please add the following configurations under config section in the appointments/app.json file.
|
Here
"APPOINTMENT_BOOKING_MESSAGE"
- is a translation key for scheduled
appointment type's message
"RECURRING_APPOINTMENT_BOOKING_MESSAGE"
- is a translation key for recurring
appointment type's message
"TELECONSULTATION_APPOINTMENT_BOOKING_MESSAGE"
- is a translation key for teleconsultation
appointment type's message
Below are key value pairs that needs to be updated in configuration folder bahmni-config/openmrs/i18n/appointment/locale_en.json. To know more about what and how to configure translations, please refer internationalization support.
|
Note : The words start with '#' will be replaced with respective medical facility, patient details and appointment details dynamically and #helpDeskNumber needs to be configured.
One can configure helpdesk contact info of the medical facility to be sent along with the message. For this we have to update the global property value.
Go to OpenMRS → Admin → Advance Settings and set clinic.helpDeskNumber
global property value to the medical facility's contact info (phone number/email). By default, the value will be"+919999999999". If the property is not available in the Advance Settings, create one and set the value.