From ca10c86cbf870fcc508e7650add340dba61e2aa4 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Fri, 15 Feb 2019 16:49:45 +0000 Subject: [PATCH 1/5] Update message state descriptions Update message state descriptions to match the agreed versions in the API documentation. Added API states for letters too. --- app/templates/views/using-notify.html | 42 ++++++++++++++++++--------- 1 file changed, 28 insertions(+), 14 deletions(-) diff --git a/app/templates/views/using-notify.html b/app/templates/views/using-notify.html index ceefd2e16..eb3ac5a7e 100644 --- a/app/templates/views/using-notify.html +++ b/app/templates/views/using-notify.html @@ -43,27 +43,41 @@ temporary failures" style="width: 100%;" > +

Message states – emails and text messages

+

Created (API only)

+

GOV.UK Notify has placed the message in a queue, ready to be sent to the provider. It should only remain in this state for a few seconds.

Sending

-

This means that we’ve sent the message to our providers and are waiting for delivery information.

+

GOV.UK Notify has sent the message to the provider. The provider will try to deliver the message to the recipient. GOV.UK Notify is waiting for delivery information.

+

Pending (text messages only)

+

GOV.UK Notify is waiting for more delivery information.

+

Sent internationally (text messages only)

+

The message was sent to an international number. The mobile networks in some countries do not provide any more delivery information.

Delivered

-

You’ll see this when Notify has successfully delivered a message to user’s email inbox or phone.

-

Notify won’t tell you if a user has opened or read a message.

-

Sent internationally

-

You’ll see this when Notify sends a text message to an international number, but mobile networks in that country don’t provide delivery receipts.

+

The message was successfully delivered.

+

Notify will not tell you if a user has opened or read a message.

Phone number or email address does not exist

-

You’ll see this when Notify couldn’t deliver a message because the email address or phone number was wrong.

+

The provider could not deliver the message because the email address or phone number was wrong.

You should remove these email addresses or phone numbers from your database.

-

You’ll still be charged for text messages to numbers that don’t exist.

+

You’ll still be charged for text messages to numbers that do not exist.

Inbox/phone not accepting messages right now

-

You’ll see this if Notify can’t deliver an email or text message after trying for 72 hours.

-

This might happen for a number of reasons. For example, the user’s inbox might be full, or their phone might be turned off.

-

You can try sending the message again if you want.

-

You’ll still be charged for text messages to phones that aren’t accepting messages.

+

The provider could not deliver the message after trying for 72 hours.

+

This can happen when the recipient’s inbox is full or their phone is off.

+

You can try to send the message again.

+

ou’ll still be charged for text messages to phones that are not accepting messages.

Technical failure

-

A technical failure means there’s a problem between Notify and our delivery providers.

-

You’ll have to try sending your messages again.

-

You won’t be charged for text messages that are affected by a technical failure.

+

Your message was not sent because there was a problem between Notify and the provider.

+

You’ll have to try sending your messages again.

+

You will not be charged for text messages that are affected by a technical failure.

+

Message states – letters

+

Accepted (API only)

+

GOV.UK Notify has sent the letter to the provider to be printed.

+

Received (API only)

+

The provider has printed and dispatched the letter.

+

Failed (API only)

+

The only failure status that applies to letters is technical-failure.

+

GOV.UK Notify had an unexpected error while sending to our printing provider.

+

Receiving messages

Email replies

You can choose an email address you want replies to go to.

From c3be75e7f7b3febf830043ea2ad7a1e180c6a663 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Fri, 15 Feb 2019 16:54:15 +0000 Subject: [PATCH 2/5] Fix typo Fix typo --- app/templates/views/using-notify.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/templates/views/using-notify.html b/app/templates/views/using-notify.html index eb3ac5a7e..520bf01bb 100644 --- a/app/templates/views/using-notify.html +++ b/app/templates/views/using-notify.html @@ -63,7 +63,7 @@

The provider could not deliver the message after trying for 72 hours.

This can happen when the recipient’s inbox is full or their phone is off.

You can try to send the message again.

-

ou’ll still be charged for text messages to phones that are not accepting messages.

+

You’ll still be charged for text messages to phones that are not accepting messages.

Technical failure

Your message was not sent because there was a problem between Notify and the provider.

You’ll have to try sending your messages again.

From f362cebd88e5adff5534c36edd8d85e8d9e86e30 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Fri, 15 Feb 2019 16:59:41 +0000 Subject: [PATCH 3/5] Correct headings --- app/templates/views/using-notify.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/app/templates/views/using-notify.html b/app/templates/views/using-notify.html index 520bf01bb..9d12ee89d 100644 --- a/app/templates/views/using-notify.html +++ b/app/templates/views/using-notify.html @@ -43,7 +43,7 @@ temporary failures" style="width: 100%;" > -

Message states – emails and text messages

+

Message statuses – emails and text messages

Created (API only)

GOV.UK Notify has placed the message in a queue, ready to be sent to the provider. It should only remain in this state for a few seconds.

Sending

@@ -69,7 +69,7 @@

You’ll have to try sending your messages again.

You will not be charged for text messages that are affected by a technical failure.

-

Message states – letters

+

Message statuses – letters

Accepted (API only)

GOV.UK Notify has sent the letter to the provider to be printed.

Received (API only)

From 9450787c956645f3b3ebf29313125284be709be9 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Fri, 15 Feb 2019 17:12:28 +0000 Subject: [PATCH 4/5] Removed API statuses Removed API statuses. Added a link to documentation. --- app/templates/views/using-notify.html | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/app/templates/views/using-notify.html b/app/templates/views/using-notify.html index 9d12ee89d..569a810bd 100644 --- a/app/templates/views/using-notify.html +++ b/app/templates/views/using-notify.html @@ -44,8 +44,6 @@ style="width: 100%;" >

Message statuses – emails and text messages

-

Created (API only)

-

GOV.UK Notify has placed the message in a queue, ready to be sent to the provider. It should only remain in this state for a few seconds.

Sending

GOV.UK Notify has sent the message to the provider. The provider will try to deliver the message to the recipient. GOV.UK Notify is waiting for delivery information.

Pending (text messages only)

@@ -70,14 +68,15 @@

You will not be charged for text messages that are affected by a technical failure.

Message statuses – letters

-

Accepted (API only)

+

Sent

GOV.UK Notify has sent the letter to the provider to be printed.

-

Received (API only)

-

The provider has printed and dispatched the letter.

-

Failed (API only)

-

The only failure status that applies to letters is technical-failure.

+

Cancelled

+

Sending cancelled. Your letter will not be printed or dispatched.

+

Technical failure

GOV.UK Notify had an unexpected error while sending to our printing provider.

+

Read our documentation for a detailed list of API statuses.

+

Receiving messages

Email replies

You can choose an email address you want replies to go to.

From d4516f3f4da3439bdcb357a2089a36a2b5877852 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Mon, 18 Feb 2019 13:57:01 +0000 Subject: [PATCH 5/5] Remove 'pending' status --- app/templates/views/using-notify.html | 2 -- 1 file changed, 2 deletions(-) diff --git a/app/templates/views/using-notify.html b/app/templates/views/using-notify.html index 569a810bd..e6753719d 100644 --- a/app/templates/views/using-notify.html +++ b/app/templates/views/using-notify.html @@ -46,8 +46,6 @@

Message statuses – emails and text messages

Sending

GOV.UK Notify has sent the message to the provider. The provider will try to deliver the message to the recipient. GOV.UK Notify is waiting for delivery information.

-

Pending (text messages only)

-

GOV.UK Notify is waiting for more delivery information.

Sent internationally (text messages only)

The message was sent to an international number. The mobile networks in some countries do not provide any more delivery information.

Delivered