WhatsApp Notification Integration Setup

WhatsApp Notification Integration Setup

Info
Introduction

The WhatsApp Notification feature in Ksatria eHospital enables hospitals and clinics to automatically send notifications to patients, such as:

  • Registration confirmation

  • Consultation reminders

  • Prescription ready for pickup

  • WhatsApp Credit purchase status updates

This feature is integrated with the Notification Microservice and can be configured based on operational needs.


Quote
Setup Steps

  1. Make sure that the WhatsApp_Notification settings in the eHospital System Configuration > Reference Data is set to 1 (active)
  2. If the WhatsApp_Notification associated key is not yet existed, please create the WhatsApp_Notification associated key and set the associated value to 1 (active)

Notes
1. WhatsApp Tenant Configuration

For sending the WhatsApp notification from eHospital, the tenant's WhatsApp configuration should be set up first in the Microservice. This is to ensure that the tenant would use the correct country code and currency when sending the notification.
  1. Log in to the Microservice using tenant administrator
  2. Go to the KMSNotif → Configuration → WhatsApp

  3. Add the specific details for the required fields:

    1. Tenant Name (Autofilled)
    2. Sender Number (from Ksatria's team)
    3. Token (from Ksatria's team)
    4. Country (choose the country where the tenant is located)
    5. Currency (choose the currency that the country use)
    6. Is Active (True)
  4. Click the Save button to apply the changes

Notes
2. WhatsApp Pricing Configuration

To support country-specific pricing, the system uses the table in Price Management in the KMSNotif Configuration.

  1. Log in to the Microservice using administrator privilege

  2. Go to KMSNotif → Configuration → WhatsApp Pricing.

  3. Add pricing configuration with the following details:

    • Country

    • Currency

    • Price per message (Marketing, Utility, Service, Authentication, etc.)

    • Effective Date

  4. Save the record. The system will automatically apply the latest valid pricing.


Notes
Notification Event Integration

The system automatically sends WhatsApp messages when specific events occur:

a. Registration Confirmation

  • Trigger: Patient is successfully registered

  • Message language: Indonesian, English, or French (based on the selected language).

  • Message includes: patient name, scheduled date/time, doctor name, clinic/service, and hospital contact.

b. Prescription Ready for Pickup

  • Trigger: Prescription dispensing status set to Allocated (or a new mechanism indicating medicine preparation is completed).

  • Message includes: patient name, prescription number, and payment/pickup instructions.

All events are recorded in Audit Logs.


Notes
WhatsApp Credit Purchase Flow

Hospitals must maintain WhatsApp Credit balance to send notifications. If the credit balance is insufficient, the system will not send the WhatsApp notification and user will be notified. To purchase/top-up the WhatsApp credis, you can follow this steps.


Idea
Logging & Audit

  • All credit transactions, pricing changes, and WhatsApp message deliveries are recorded in the Audit Log / Log WhatsApp.

  • Logs can only be accessed by authorized admins or support staff.

    • Related Articles

    • WhatsApp Credit Purchase Guide

      To send WhatsApp notifications, your hospital or clinic needs to maintain a sufficient WhatsApp Credit balance. This balance is used every time a notification is sent to a patient. This guide explains how to purchase WhatsApp Credits and what happens ...
    • How to Setup and Configure LIS Agent

      Overview Integration with medical laboratory equipment into an Electronic Medical Record (EMR) system is crucial for seamless data exchange, reducing manual input errors, and improving workflow efficiency in healthcare facilities. To address this ...
    • Changelog Ksatria eHospital v2507091 (09-07-2025)

      New Features: We have now implemented multi-language support for Medical Certificate We also implemented the multi-language support for sending the Medical Certificate to patient and/or company email We have now changes the diagnostic support group ...
    • Changelog Ksatria eHospital v2508261 (26-08-2025)

      Changelog Ksatria eHospital v2508261 (26-08-2025) New Features & Enhancements: Whatsapp notification feature to send notification to Patient's Phone Number for Patient Registration and Pharmacy using WhatsApp Business API (Configurable) Bug Fixes & ...
    • Changelog Ksatria eHospital v2507211 (21-07-2025)

      New Features: - Added a filter to the BPJS Report based on Registration Source - Enhanced notification feature to be reopened using the Notification Button Bug Fixes and Improvements: - Fixed issue related with the stock compound medicine changed ...