From 60697d920caa94ad5175c9a1294864c194174240 Mon Sep 17 00:00:00 2001 From: Jake Cosgrove <101206358+jakecosgrove@users.noreply.github.com> Date: Thu, 22 May 2025 21:27:21 +0000 Subject: [PATCH 1/6] First iteration of the "out of the box" content for NHS Notify --- docs/_includes/components/expander.html | 10 + docs/_includes/components/summary-list.html | 35 ++ .../campaign-feature-list.html | 414 ++++++++++++++++ .../direct-message-feature-list.html | 448 ++++++++++++++++++ .../transactional-feature-list.html | 433 +++++++++++++++++ .../using-nhs-notify/(draft)accordion-test.md | 110 +++++ .../(test)transactional-messaging.md | 46 ++ docs/pages/using-nhs-notify/campaigns.md | 39 ++ .../using-nhs-notify/direct-messaging.md | 73 +++ .../using-nhs-notify/event-based-messaging.md | 39 ++ .../using-nhs-notify/using-nhs-notify.md | 8 + 11 files changed, 1655 insertions(+) create mode 100644 docs/_includes/components/expander.html create mode 100644 docs/_includes/components/summary-list.html create mode 100644 docs/_includes/custom-components/campaign-feature-list.html create mode 100644 docs/_includes/custom-components/direct-message-feature-list.html create mode 100644 docs/_includes/custom-components/transactional-feature-list.html create mode 100644 docs/pages/using-nhs-notify/(draft)accordion-test.md create mode 100644 docs/pages/using-nhs-notify/(test)transactional-messaging.md create mode 100644 docs/pages/using-nhs-notify/campaigns.md create mode 100644 docs/pages/using-nhs-notify/direct-messaging.md create mode 100644 docs/pages/using-nhs-notify/event-based-messaging.md diff --git a/docs/_includes/components/expander.html b/docs/_includes/components/expander.html new file mode 100644 index 0000000..1ce6d10 --- /dev/null +++ b/docs/_includes/components/expander.html @@ -0,0 +1,10 @@ + diff --git a/docs/_includes/components/summary-list.html b/docs/_includes/components/summary-list.html new file mode 100644 index 0000000..369fba4 --- /dev/null +++ b/docs/_includes/components/summary-list.html @@ -0,0 +1,35 @@ +
07700 900362
+karen.francis@example.com
+| Integration method | +Included | +
|---|---|
| NHS Notify API (recommended) | ++ + + + | +
| NHS Notify MESH | ++ + + + | +
| Message channel | +Included | +
|---|---|
| NHS App messages
+
+ Includes push notifications that are sent between 6am and 10pm to support sociable hours
+
+ |
+ + + + + | +
| Emails | ++ + + + | +
| Text messages (SMS) | ++ + + + | +
| Letters | ++ + + + | +
| Additional letter format | +Included | +
|---|---|
| Braille | ++ + + + | +
| Large print | ++ + + + | +
| Audio CD | ++ + + + | +
| Letters in other languages | ++ + + + | +
Learn more about accessible formats and letters in other + languages.
+ + +| Feature | +Included | +
|---|---|
| Templates
+
+ Send the same thing to lots of people without writing a new message each time
+
+ |
+ + + + + | +
| Free-text input
+
+ Use free-text inputs in your own software to write messages
+
+ |
+ + + + + | +
| Personalisation
+
+ Add details like your recipients name, appointment times or reference numbers to your messages
+
+ |
+ + + + + | +
| Sender name
+
+ Tell recipients who your messages are from
+
+ Find out how to tell recipients who your messages are from
+ |
+ + + + + | +
| Feature | +Included | +
|---|---|
| Rate limiting
+
+ Set how many messages are sent per second to control how often recipients access your service
+
+ |
+ Up to 5TPS | +
| Routing plans
+
+ Use routing plans to decide how and what order messages will be sent to your recipients
+
+ You can send campaign messages in the following ways: +
|
+ + + + + | +
| Fallback rules
+
+ The following fallback rules will apply to message channels used in your routing plans:
+
+ + All digital message channels will immediately fallback to the next channel if its rejected or an 'unnotified' + status is received. + +NHS App messages will fallback to the next channel when: +
Emails and text messages will fallback to the next channel if they are XYZ after 72 hours +Letters do not have any fallback rules as they’re always sent last in routing plans for transactional + messages. + |
+ + + + + | +
| Parallel send
+
+ Send two or more messages at the same time to a recipient
+
+ |
+ + + + + | +
| Recipients you cannot message
+
+ NHS Notify prevents you from sending messages to specific recipients to make your messaging more effective
+
+ You cannot send transactional messages to recipients with: +
|
+ + + + + | +
| Feature | +Included | +
|---|---|
| Power BI reporting
+
+ See how your messages are performing over time with our Power BI dashboards
+
+ |
+ + + + + | +
| Real time message status callbacks
+
+ Receive real time updates every time the status of a message changes
+
+ |
+ API only | +
| Quarterly billing
+
+ Pay for the messages you send every quarter with cross charging
+
+ Find out how to pay
+ |
+ + + + + | +
| Integration method | +Included | +
|---|---|
| NHS Notify API (recommended) | ++ + + + | +
| NHS Notify MESH | ++ + + + | +
| Message channel | +Included | +
|---|---|
| NHS App messages
+
+ Includes push notifications that are sent between 6am and 10pm to support sociable hours
+
+ |
+ + + + + | +
| Emails | ++ + + + | +
| Text messages (SMS) | ++ + + + | +
| Letters | ++ + + + | +
| Additional letter format | +Included | +
|---|---|
| Braille | ++ + + + | +
| Large print | ++ + + + | +
| Audio CD | ++ + + + | +
| Letters in other languages | ++ + + + | +
Learn more about accessible formats and letters in other + languages.
+ + +| Feature | +Included | +
|---|---|
| Templates
+
+ Send the same thing to lots of people without writing a new message each time
+
+ |
+ + + + + | +
| Free-text input
+
+ Use free-text inputs in your own software to write messages
+
+ |
+ + + + + | +
| Personalisation
+
+ Add details like your recipients name, appointment times or reference numbers to your messages
+
+ |
+ + + + + | +
| Sender name
+
+ Tell recipients who your messages are from
+
+ Find out how to tell recipients who your messages are from
+ |
+ + + + + | +
| Feature | +Included | +
|---|---|
| Rate limiting
+
+ Set how many messages are sent per second to control how often recipients access your service
+
+ |
+ Up to 5TPS | +
| Routing plans
+
+ Use routing plans to decide how and what order messages will be sent to your recipients.
+
+ |
+ + + + + | +
| Fallback rules
+
+ These are rules that trigger when a fallback is used for each message channel in a routing plan
+
+ + If you send direct messages with the NHS App you must create your own fallback functionality and adhere to the + following: + +1. Time sensitive NHS App messages should fallback when:+
2. Bulk NHS App messages should fallback when:+
3. Acute secondary care appointment NHS App messages should fallback when:+
|
+ + + + + | +
| Parallel send
+
+ Send two or more messages at the same time to a recipient
+
+ |
+ + + + + | +
| Recipients you cannot message
+
+ NHS Notify prevents you from sending messages to specific recipients to make your messaging more effective
+
+ You cannot send transactional messages to recipients with: +
|
+ + + + + | +
| Feature | +Included | +
|---|---|
| Power BI reporting
+
+ See how your messages are performing over time with our Power BI dashboards
+
+ |
+ + + + + | +
| Real time message status callbacks
+
+ Receive real time updates every time the status of a message changes
+
+ |
+ API only | +
| Quarterly billing
+
+ Pay for the messages you send every quarter with cross charging
+
+ Find out how to pay
+ |
+ + + + + | +
| Integration method | +Included | +
|---|---|
| NHS Notify API (recommended) | ++ + + + | +
| NHS Notify MESH | ++ + + + | +
| Message channel | +Included | +
|---|---|
| NHS App messages
+
+ Includes push notifications that are sent between 6am and 10pm to support sociable hours
+
+ |
+ + + + + | +
| Emails | ++ + + + | +
| Text messages (SMS) | ++ + + + | +
| Letters
+
+ Uses NHS Notify's standard letter specification
+
+ |
+ + + + + | +
| Additional letter format | +Included | +
|---|---|
| Braille | ++ + + + | +
| Large print | ++ + + + | +
| Audio CD | ++ + + + | +
| Letters in other languages | ++ + + + | +
Learn more about accessible formats and letters in other + languages.
+ + +| Feature | +Included | +
|---|---|
| Templates
+
+ Send the same thing to lots of people without writing a new message each time
+
+ |
+ + + + + | +
| Free-text input
+
+ Use free-text inputs in your own software to write messages
+
+ |
+ + + + + | +
| Personalisation
+
+ Add details like your recipients name, appointment times or reference numbers to your messages
+
+ |
+ + + + + | +
| Sender name
+
+ Tell recipients who your messages are from
+
+ Find out how to tell recipients who your messages are from
+ |
+ + + + + | +
| Feature | +Included for transactional messages | +
|---|---|
| Personalisation
+
+ Add details like your recipients name, appointment times or reference numbers to your messages
+
+ |
+ + + + + | +
| Rate limiting
+
+ Set how many messages are sent per second to control how often recipients access your service
+
+ |
+ Up to 5TPS | +
| Routing plans
+
+ Use routing plans to decide how messages will be sent to your recipients and in what orders.
+
+ You can send transactional messages in the following ways: +
|
+ + + + + | +
| Fallback rules
+
+ The following fallback rules will apply to message channels used in your routing plans:
+
+ + All digital message channels will immediately fallback to the next channel if its rejected or an 'unnotified' + status is received. + +The following fallback rules will apply to message channels used in your routing plans: +NHS App messages will fallback to the next channel when: +
Emails and text messages will fallback to the next channel if they are XYZ after 72 hours +Letters do not have any fallback rules as they’re always sent last in routing plans for transactional + messages. + |
+ + + + + | +
| Parallel send
+
+ Send two or more messages at the same time to a recipient
+
+ |
+ + + + + | +
| Recipients you cannot message
+
+ NHS Notify prevents you from sending messages to specific recipients to make your messaging more effective
+
+ You cannot send transactional messages to recipients with: +
|
+ + + + + | +
| Feature | +Included | +
|---|---|
| Power BI reporting
+
+ See how your messages are performing over time with our Power BI dashboards
+
+ |
+ + + + + | +
| Real time message status callbacks
+
+ Receive real time updates every time the status of a message changes
+
+ |
+ API only | +
| Quarterly billing
+
+ Pay for the messages you send every quarter with cross charging
+
+ Find out how to pay
+ |
+ + + + + | +
| Automatic contact look up (mandatory)
+
+ NHS Notify automatically finds and uses your recipients contact details from their NHS number
+
+ |
+ + + + + | +
| Rate limiting
- Set how many messages are sent per second to control how often recipients access your service
+ Set how many messages are sent per second to control how often recipients access your service, also known as
+ transactions per second (TPS)
|
Up to 5TPS | @@ -283,19 +299,21 @@
| Fallback rules
- The following fallback rules will apply to message channels used in your routing plans:
+ The rules that trigger when a fallback is used for each message channel in a routing plan
- + All digital message channels will immediately fallback to the next channel if its rejected or an 'unnotified' status is received. -NHS App messages will fallback to the next channel when: +NHS App messages will fallback to the next channel when:
Emails and text messages will fallback to the next channel if they are XYZ after 72 hours -Letters do not have any fallback rules as they’re always sent last in routing plans for transactional + Emails and text messages will fallback to the next channel if they are not delivered after + 72 hours +Letters do not have any fallback rules as they’re always sent last in routing plans for + transactional messages. |
@@ -332,10 +350,10 @@ Sending messages
NHS Notify prevents you from sending messages to specific recipients to make your messaging more effective
- You cannot send transactional messages to recipients with: +You cannot send campaign messages to recipients with:
Message channels |
| Automatic contact look up (mandatory)
+
+ NHS Notify automatically finds and uses your recipients contact details from their NHS number
+
+ |
+ + + + + | +
| Rate limiting
- Set how many messages are sent per second to control how often recipients access your service
+ Set how many messages are sent per second to control how often recipients access your service, also known as
+ transactions per second (TPS)
|
Up to 5TPS | @@ -307,7 +323,7 @@
| Fallback rules
- These are rules that trigger when a fallback is used for each message channel in a routing plan
+ The rules that trigger when a fallback is used for each message channel in a routing plan
If you send direct messages with the NHS App you must create your own fallback functionality and adhere to the @@ -366,10 +382,10 @@ 3. Acute secondary care appointment NHS App message
|
| Feature | -Included for transactional messages | +Included |
|---|---|---|
| Personalisation + | Automatic contact look up (mandatory)
- Add details like your recipients name, appointment times or reference numbers to your messages
+ NHS Notify automatically finds and uses your recipients contact details from their NHS number
|
@@ -268,7 +268,8 @@ Sending messages |
| Rate limiting
- Set how many messages are sent per second to control how often recipients access your service
+ Set how many messages are sent per second to control how often recipients access your service, also known as
+ transactions per second (TPS)
|
Up to 5TPS | @@ -278,7 +279,7 @@|
| Fallback rules
- The following fallback rules will apply to message channels used in your routing plans:
+ The rules that trigger when a fallback is used for each message channel in a routing plan
- + All digital message channels will immediately fallback to the next channel if its rejected or an 'unnotified' status is received. @@ -313,7 +314,7 @@Sending messagesEmails and text messages will fallback to the next channel if they are XYZ after 72 hours +Emails and text messages will fallback to the next channel if they are not delivered after 72 hours Letters do not have any fallback rules as they’re always sent last in routing plans for transactional messages. |
@@ -351,10 +352,10 @@