Notifications
RxScale sends notifications to keep pharmacies, doctors, and admins informed about important events. This page explains what types of notifications are available, what triggers them, and who receives them.Notification Types
Pharmacy Order Notifications
These notifications are sent when something happens with a pharmacy order.
Why it matters: These notifications help pharmacies stay on top of incoming orders and status changes, so they can process orders promptly.
Stock Level Change Notifications
Why it matters: Keeping track of stock levels helps pharmacies avoid running out of medication and ensures orders can be fulfilled without delays.
Prescription Notifications
Why it matters: Doctors need to know when new prescriptions are waiting for their review, and admins need visibility into the prescription lifecycle.
Order Notifications
Why it matters: Admins can monitor the overall order flow and intervene quickly if an order gets stuck or needs attention.
Secure Chat Notifications
Doctors receive an email and, if a phone number is configured, an SMS alert when a patient sends them a new secure chat message. The alert contains no message content — only a reference to the conversation so the doctor can open it directly.
Why it matters: Doctors are promptly notified of new patient messages without any sensitive content being transmitted in the notification itself.
Appointment Update Notifications
These three are delivered by email rather than by webhook, and they are off by default. An admin enables them per recipient from Settings → Notifications in the admin portal: click Add subscription, switch Channel from the default Webhook to Email, pick the recipient, and tick Cancellation, Rescheduling, Confirmation, or any combination. Confirmation is not pre-selected. Rescheduling sends a single email about the new time, never a cancellation followed by a booking; confirmation is independent of that and fires whenever a fresh booking is confirmed, whether or not cancellation or rescheduling are also enabled. Subscribing admins sends the email to every user in the organisation, not a single recipient. Doctors can switch off their own copy from the Doctor Portal without affecting the emails patients and admins receive. No other appointment change sends email.
Why it matters: Patients, doctors, and your team hear about a change to an appointment straight away, without anyone having to write to them by hand.
How to Subscribe to Notifications
Most notifications are delivered via webhooks, but a few are sent by RxScale itself — the appointment update emails above, and the secure chat alerts to doctors. A webhook is a URL on your system that RxScale calls whenever an event occurs. To receive webhook notifications:- Set up a webhook endpoint. Create a URL on your system that can receive HTTP POST requests from RxScale.
- Register the webhook. Use the RxScale admin panel or API to register your webhook URL and select the events you want to receive.
- Start receiving notifications. Whenever a subscribed event occurs, RxScale will send a POST request to your webhook URL with the event details.
Webhook setup requires technical configuration. If you need help, work with your development team or contact RxScale support.
What a Notification Looks Like
When an event occurs, RxScale sends a JSON payload to your webhook URL. The payload includes:- Event type — What happened (for example,
pharmacy_order_created). - Timestamp — When the event occurred.
- Data — The relevant details about the order, prescription, or other object involved.
Tips for Managing Notifications
- Subscribe only to events you need. This keeps your system focused and avoids unnecessary processing.
- Monitor your webhook endpoint. Make sure your endpoint is available and responding. RxScale may retry failed deliveries, but persistent failures could cause you to miss notifications.
- Process notifications quickly. Acknowledge the webhook request promptly to avoid timeouts. Handle any heavy processing asynchronously.
Frequently Asked Questions
Can I receive notifications by email instead of webhooks?
Can I receive notifications by email instead of webhooks?
Most real-time notifications are delivered via webhooks, but some are sent by RxScale directly. Appointment cancellation, rescheduling, and confirmation emails are one of those: an admin sets them up from Settings → Notifications in the admin portal (Add subscription → Channel Email → tick the changes, including Confirmation if needed), and enabling them does not change what your webhooks receive. Secure chat alerts to doctors are another. For anything else, contact the support team.
What happens if my webhook endpoint is down?
What happens if my webhook endpoint is down?
RxScale will retry the delivery. If the endpoint remains unavailable, the notification may be lost. It is important to keep your webhook endpoint running and monitored.
Can I test notifications before going live?
Can I test notifications before going live?
Yes, you can use the development environment to test webhook notifications. See the API documentation for development base URLs.
Related Topics
- Webhooks Overview — Technical details on how webhooks work.
- Webhook Events — Full list of webhook event types and payload formats.
- Webhook Security — How to verify webhook signatures.