How to deliver eduMe content notifications in your own app

eduMe can now deliver learner notifications to your own system via webhook, in addition to email, SMS, WhatsApp and the eduMe web app. This means notifications that eduMe automatically triggers — such as new content, mandatory training and reminders — can be surfaced as native notifications inside your own app, giving your users a seamless, in-app experience.

How it works

You build and host a webhook receiver endpoint. Whenever eduMe's notification system triggers a message for one of your users, eduMe sends ("relays") that notification to your endpoint as an HTTPS POST. Your app receives the details and uses them to create the notification in your own environment. eduMe continues to handle all the triggering logic — you simply receive and deliver.

Each notification payload includes:

• user — the user's eduMe ID, your external ID, and any identifiers, so you can match it to the right person in your system
• message — ready-to-use notification text (the same copy used for SMS)
• data — supporting details including the content name, a direct link and short link to the content, and your organisation name — so you can either use our message as-is or construct your own

Example:

json

{   
"version": 1,   
"user": {     "userId": 132731,     
"eId": "my-id-123",     
"identifiers": 
[ { "id": 350367, "key": "msTeams.employeeId", "value": "3c240f6b-…" } ]   },   
"message": "Acme has sent you a new course - Food Safety Basics. Complete it now: https://…/to/be4813",   
"data": {     "contentName": "Food Safety Basics",     "link": "https://…/e/g/68?u=132731&sig=…",     
"shortLink": "https://…/to/be4813",     
"customerName": "Acme"   } 
}

The content links are seamless — a user following the link is taken straight into the content without a separate login step.

How to set it up

1. Build your receiver endpoint — a secure (HTTPS) URL that accepts POST requests and processes the payload above.
2. Request webhook delivery to be enabled for your account through your eduMe contact, and share your endpoint URL.
3. eduMe configures the webhook at the account level and enables it as a delivery method.
4. Receive and deliver — from then on, triggered notifications are sent to your endpoint, and your app creates the notification for the user.

Note: in the current release, webhooks are configured at the account (customer) level. If you'd like to discuss your use case, your eduMe contact can help.