Skip to content

Commit

Permalink
Added docs on the "Communication Lifecycle"
Browse files Browse the repository at this point in the history
  • Loading branch information
rahul1 committed Sep 22, 2023
1 parent a229348 commit a5eb5b2
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions packages/docs/docs/communications/organizing-communications.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,21 @@ The FHIR `Communication` resource is a representation of any message sent in a h
| `subject` | A reference to the patient or group that this `Communication` is about. | | Patient/homer-simpson |
| `encounter` | A reference to a medical encounter to which this `Communication` is tightly associated. | | Encounter/example-appointment |
| `sent`/`received` | The time that the message was either sent or received. | | 2023-04-10T10:00:00Z |
| `status` | The status of transmission | [Event Status Codes](http://hl7.org/fhir/R4/valueset-event-status.html) | in-progress |

:::tip The `Communication` lifecycle

Most messaging based workflows track messages through three stages: **sent**, **received**, and **read**.

While FHIR standard doesn't offer specific guidance on representing this lifecycle, Medplum recommends the following model:

| Stage | Representation |
| -------- | --------------------------------------- |
| sent | `Communication.sent` is populated |
| received | `Communication.received` is populated |
| read | `Communication.status` is `"completed"` |

:::

## Building and Structuring Threads

Expand Down

0 comments on commit a5eb5b2

Please sign in to comment.