A script to update the notify templates in the user guide

README.md

@@ -14,6 +14,27 @@ The canonical source of content for the user guide is a Google Doc. This documen
 
 The canonical source of content for the XLSX file download templates is Microsoft SharePoint. These documents should be edited first before downloading and updating the files in this repository.
 
+### Updating the GOV.UK Notify templates
+
+Set up Python in the `update_notify_templates` directory:
+
+```bash
+cd update_notify_templates
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+Put a copy of the Notify API key in `update_notify_templates/.env`, by making a copy of
+`update_notify_templates/.env.example` and replacing the placeholder with the actual key.
+This key only needs to be of the type `Test - pretends to send messages`, because only template access is required.
+
+To update the Notify templates, run the following command from the `update_notify_templates` directory:
+
+```bash
+python update_notify_templates.py
+```
+
 ## Running locally
 
 First install [Node.js](https://nodejs.org/en).

app/email-templates/consent-reminder-doubles.md

@@ -1,55 +0,0 @@
----
-title: MenACWY and Td/IPV consent reminder
-theme: MenACWY and Td/IPV
-subject: Please respond to our request for consent by ==consent deadline==
-order: 6
----
-
-We wrote to you recently to let you know we're coming to ==location name== on ==next session dates== to offer your child their ==vaccination==.
-
-If you want your child to be vaccinated, you need to give consent by ==consent deadline==.
-
-If you’ve already responded to the consent request, you can ignore this message.
-
-### About the MenACWY vaccine
-
-The MenACWY vaccine helps protect against life-threatening illnesses including meningitis, sepsis and septicaemia (blood poisoning).
-
-It is recommended for all teenagers. Most people only need 1 dose of the vaccine.
-
-[Find out more about the MenACWY vaccine on NHS.UK](https://www.nhs.uk/vaccinations/menacwy-vaccine/)
-[Read the patient information leaflet for the MenACWY vaccine](https://www.medicines.org.uk/emc/files/pil.12818.pdf)
-
-### About the Td/IPV vaccine
-
-The Td/IPV vaccine helps protect against tetanus, diphtheria and polio.
-
-It’s offered at around 13 or 14 years old (school year 9 or 10). It boosts the protection provided by the [6-in-1 vaccine](https://www.nhs.uk/vaccinations/6-in-1-vaccine/) and [4-in-1 pre-school booster](https://www.nhs.uk/vaccinations/4-in-1-preschool-booster-vaccine/) vaccine.
-
-[Find out more about the Td/IPV vaccine on NHS.UK](https://www.nhs.uk/vaccinations/td-ipv-vaccine-3-in-1-teenage-booster/)
-[Read the patient information leaflet for the Td/IPV vaccine](https://www.medicines.org.uk/emc/files/pil.5581.pdf)
-
-### How to respond
-
-> [!NOTE]
-> It’s important to let us know whether you do or do not want your child to have these vaccinations. It will take less than 5 minutes to respond using the link below.
-
-==consent URL==
-
-### Talk to your child about what they want
-
-We suggest you talk to your child about the vaccinations before you respond to us.
-
-Young people have the right to refuse vaccinations. Those who show [‘Gillick competence'](https://www.nhs.uk/conditions/consent-to-treatment/children/) have the right to consent to vaccinations themselves. Our team may assess Gillick competence during vaccination sessions.
-
-### If you cannot use the online form
-
-If you cannot use the online form, you can respond over the phone using the contact details below.
-
-### Your data
-
-By responding, you’re agreeing to your data being processed as set out in our ==privacy notice URL==.
-
-### Get in touch with us
-
-Speak to a member of our team by calling ==team phone number==, or email ==team email address==.

app/email-templates/consent-reminder-hpv.md

@@ -1,44 +0,0 @@
----
-title: HPV consent reminder
-theme: HPV
-subject: Please respond to our request for consent by ==consent deadline==
-order: 4
----
-
-We wrote to you recently about a visit by a local health team to ==location name== on ==next session dates==.
-
-If you want your child to get the HPV vaccination, you need to give consent by ==consent deadline==.
-
-If you’ve already responded to the consent request, you can ignore this message.
-
-### What the vaccine is for
-
-The HPV vaccine helps protect against cancers caused by HPV, including:
-
-- cervical cancer
-- some mouth and throat (head and neck) cancers
-- some cancers of the anal and genital areas
-
-It also helps protect against genital warts.
-
-The HPV vaccine works best if it’s given before young people become sexually active.
-
-[Find out more about the HPV vaccine on NHS.UK](https://www.nhs.uk/conditions/vaccinations/hpv-human-papillomavirus-vaccine/)
-
-### Please give or refuse consent
-
-==consent URL==
-
-Responding will take less than 5 minutes. If you do not give consent, it’s still important for you to respond.
-
-### Talk to your child about what they want
-
-We suggest you talk to your child about the vaccine before you respond to us.
-
-### If you have trouble using the online form
-
-If you have any trouble using the online form, you can respond over the phone using the contact details below.
-
-### Contact the local health team
-
-Speak to a member of the local health team by calling ==team phone number==, or email ==team email address==.

app/guide/first-consent-reminder-for-hpv-email.md

@@ -0,0 +1,45 @@
+---
+layout: email
+title: First consent reminder for HPV
+group: Email templates
+subject: Please respond to our request for consent by ==consent_deadline==
+order: 41
+---
+
+We wrote to you recently about a visit by a local health team to ==location_name== on ==next_session_dates==.
+
+If you want your child to get the HPV vaccination, you need to give consent by ==consent_deadline==. 
+
+If you've already responded to the consent request, you can ignore this message.
+
+## What the vaccine is for 
+
+The HPV vaccine helps protect against cancers caused by HPV, including:
+
+* cervical cancer
+* some mouth and throat (head and neck) cancers
+* some cancers of the anal and genital areas
+
+It also helps protect against genital warts.
+
+The HPV vaccine works best if it’s given before young people become sexually active.
+
+[Find out more about the HPV vaccine on NHS.UK](https://www.nhs.uk/conditions/vaccinations/hpv-human-papillomavirus-vaccine/)
+
+## Please give or refuse consent
+
+==consent_link==
+
+Responding will take less than 5 minutes. If you do not give consent, it’s still important for you to respond.
+
+## Talk to your child about what they want
+
+We suggest you talk to your child about the vaccine before you respond to us. 
+
+## If you have trouble using the online form
+
+If you have any trouble using the online form, you can respond over the phone using the contact details below.
+
+## Contact the local health team
+
+Speak to a member of our team by calling ==team_phone==, or contact ==team_email==.

app/guide/initial-consent-request-for-hpv-email.md

@@ -0,0 +1,53 @@
+---
+layout: email
+title: Initial consent request for HPV
+group: Email templates
+subject: HPV vaccination for ==short_patient_name==
+order: 40
+---
+
+We’re coming to ==location_name== on ==next_session_dates== to give the human papillomavirus (HPV) vaccine ==not_catch_up?? to pupils in Year 8==.
+
+==catch_up??Our records show your child has not had their HPV vaccination. Pupils usually have this when they’re in Year 8.==
+
+We would like your consent to vaccinate ==short_patient_name==. You can give this by filling in our online form (the link is below).  
+
+## What the vaccine is for
+
+The HPV vaccine helps protect boys and girls against cancers caused by HPV, including:
+
+* cervical cancer
+* some mouth and throat (head and neck) cancers
+* some cancers of the anal and genital areas
+
+It also helps protect against genital warts.
+
+The HPV vaccine works best if it’s given before young people become sexually active. Young people usually only need 1 dose.
+
+[Find out more about the HPV vaccine on NHS.UK](https://www.nhs.uk/conditions/vaccinations/hpv-human-papillomavirus-vaccine/)
+
+[Read the patient information leaflet (PDF)](https://www.medicines.org.uk/emc/files/pil.7330.pdf)
+
+## How to respond
+
+> It’s important to let us know whether you do or do not want your child to have the vaccination. It will take less than 5 minutes to respond using the link below. You need to respond by ==consent_deadline==.
+
+[Respond to the consent request](==consent_link==)
+
+## Talk to your child about what they want
+
+We suggest you talk to ==short_patient_name== about the vaccination before you respond to us. 
+
+Young people have the right to refuse vaccinations. Those who show [‘Gillick competence’](https://www.nhs.uk/conditions/consent-to-treatment/children/#:~:text=Children%20under%20the%20age%20of,responsibility%20can%20consent%20for%20them) have the right to consent to vaccinations themselves. Our team may assess Gillick competence during vaccination sessions.
+
+## If you cannot use the online form
+
+If you cannot use the online form, you can respond over the phone using the contact details below.
+
+## Your data
+
+By responding, you're agreeing to your data being processed as set out in our [privacy notice](==organisation_privacy_notice_url==).
+
+## Contact our team
+
+Speak to a member of our team by calling ==team_phone==, or email ==team_email==.

app/guide/second-and-beyond-reminder-for-hpv-email.md

@@ -0,0 +1,41 @@
+---
+layout: email
+title: Second and beyond reminder for HPV
+group: Email templates
+subject: There's still time for your child to be vaccinated against HPV
+order: 42
+---
+
+Our team are coming back to ==location_name== on ==next_session_dates== to give the HPV vaccine.
+
+If you want your child to be vaccinated, you need to give your consent.
+
+## What the vaccine is for
+
+The HPV vaccine helps protect against cancers caused by HPV, including:
+
+* cervical cancer
+* some mouth and throat (head and neck) cancers
+* some cancers of the anal and genital areas
+
+The HPV vaccine works best if it’s given before young people become sexually active.
+
+[Find out more about the HPV vaccine on NHS.UK](https://www.nhs.uk/conditions/vaccinations/hpv-human-papillomavirus-vaccine/)
+
+## Please give or refuse consent
+
+==consent_link==
+
+Responding will take less than 5 minutes. 
+
+## Talk to your child about what they want
+
+We suggest you talk to your child about the vaccine before you respond to us.
+
+## If you have trouble using the online form
+
+If you have any trouble using the online form, you can respond over the phone using the contact details below.
+
+## Contact the local health team
+
+Speak to a member of the local health team by calling ==team_phone==, or ==team_email==.

update_notify_templates/.env.example

@@ -0,0 +1 @@
+NOTIFY_API_KEY=<PUT_YOUR_API_KEY_HERE---ONLY_A_TEST_KEY_IS_REQUIRED>

update_notify_templates/requirements.txt

@@ -0,0 +1,9 @@
+certifi==2025.1.31
+charset-normalizer==3.4.1
+docopt==0.6.2
+idna==3.10
+notifications-python-client==10.0.1
+PyJWT==2.10.1
+python-dotenv==1.0.1
+requests==2.32.3
+urllib3==2.3.0