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.
Admins can also get an email when a new order arrives. That email is off by default. Each person turns it on for their own account from Settings → Users in the admin portal: open Notifications on the user row and switch on Email on new order. The email goes only to that user’s account address, and it covers every new order in the organisation. Switching it off stops the email. Organisation webhooks are unchanged.
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.
Patients receive an email when a doctor starts or resends a chat with them from the Doctor Portal; the email contains the link that opens the chat. If a phone number is configured, an SMS also tells the patient that the invitation is waiting in their email. The SMS carries no link: the link signs the patient in, so it goes only to the email address. This notification is only sent for organisations that have the secure chat feature enabled; contact your RxScale account manager if you would like it enabled for your organisation.
Why it matters: Doctors are promptly notified of new patient messages without any sensitive content being transmitted in the notification itself, and patients are alerted right away when their doctor wants to start a secure conversation with them.
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.
Review Request Notifications
Why it matters: Your shop learns at once what the doctor decided, and can send the patient the booking link or the invoice, or refund the fee. Storefront patients receive the booking link directly, because there is no shop system that could pass it on.
The booking-link email to storefront patients
When a doctor invites a patient of your RxScale storefront to a video appointment, RxScale emails the patient the booking link. The email:- has the subject
<storefront name>: Ihr Videotermin / Your video appointment, with your storefront’s display name, for example Menopause Clinic: Ihr Videotermin / Your video appointment; - contains German and English in one message;
- contains the booking link and the date until which it is valid, usually 14 days after the doctor created it;
- contains nothing clinical: no medicine, no reason, and not the doctor’s note to the patient, which is shown on the booking page after the patient opens the link;
- goes to the patient’s contact email address.
review_request_updated webhook and sends it itself.
How to Subscribe to Notifications
Most notifications are delivered via webhooks, but a few are sent by RxScale itself — the appointment update emails above, the secure chat notifications to doctors and patients, and the booking-link email to storefront patients. 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. A new-order email for an admin is another: it stays off until that user switches on Email on new order under Settings → Users → Notifications, and it is sent only to that user’s account address. Secure chat alerts to doctors and chat invitations to patients 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.