alert.inactive
When Signals sends alert.inactive, its payload and how to handle it in Node.js, Python and Java.
A patient sends no reading for the days set in alertInactiveDays. patient.inactive is sent beside it.
Payload
Every delivery is the envelope type, timestamp, sequence and data; the delivery's id is the webhook-id header. See Verify webhooks.
{
"type": "alert.inactive",
"timestamp": "2026-10-25T08:00:02.000Z",
"sequence": 1048,
"data": {
"id": "0b9d7e52-1f3a-4e8c-b6a2-7c4d9e1f2a35",
"patient": "6f1c2a8e-3b7d-4c55-9a0e-2d4b8f6e1a90",
"component": {
"code": {
"coding": [
{
"system": "http://loinc.org"
}
]
}
},
"message": "No recent observations",
"reason": "inactive",
"createdAt": "2026-10-25T08:00:02.000Z",
"updatedAt": "2026-10-25T08:00:02.000Z",
"observationRefId": null,
"derivedObservation": null,
"patientRefId": "resident-001",
"episodeId": null,
"acknowledgedAt": null,
"acknowledgedBy": null,
"version": 1
}
}The data fields are those of alert.triggered. reason is inactive. No reading is behind it, so observation is absent and observationRefId is null.
Handle the event
Verify the delivery first (Verify webhooks), then act on the verified event as in Handle an event.
export async function handle(webhookId, event) {
if (!(await firstTime(webhookId))) return;
const { data } = event;
switch (event.type) {
case 'alert.inactive':
await notifyCareTeam(data.patientRefId, data.message);
break;
default:
break;
}
}Related
Last updated on