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.

alert-inactive.js
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;
  }
}

Last updated on

On this page