From 3126bbfb9b135f64a5fe6fd3fac44531d2c15165 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 20 Jan 2025 12:04:08 +0100 Subject: [PATCH 1/7] fix(tem): blocklist draft --- faq/transactional-email.mdx | 11 ++++- .../how-to/create-webhooks.mdx | 2 + .../how-to/manage-blocklists.mdx | 47 +++++++++++++++++++ 3 files changed, 59 insertions(+), 1 deletion(-) create mode 100644 managed-services/transactional-email/how-to/manage-blocklists.mdx diff --git a/faq/transactional-email.mdx b/faq/transactional-email.mdx index e672634aec..56054aeb05 100644 --- a/faq/transactional-email.mdx +++ b/faq/transactional-email.mdx @@ -51,4 +51,13 @@ Find out about [limits and quotas](/managed-services/transactional-email/referen At the end of the month, you are billed for the number of emails you sent. If the number of emails you have sent exceeds the number of emails included in your offer, you will be billed for the excess emails. For example, if you use the free tier of 300 emails per month, and you end up sending 305 emails, you will only be billed for five emails out of the 305 you have sent. -Check out our [dedicated page](https://www.scaleway.com/en/pricing/?tags=managedservices-transactionalemail-transactionalemail) for more information about Transactional Email's pricing. \ No newline at end of file +Check out our [dedicated page](https://www.scaleway.com/en/pricing/?tags=managedservices-transactionalemail-transactionalemail) for more information about Transactional Email's pricing. + +## Can I unblock an address that was automatically added to a TEM blocklist before the 48-hour period ends? +Yes, you can manually unblock any address, even if it is still under the temporary block period. + +## What happens if an address on a TEM blocklist becomes valid again? +You can manually unblock the address. Make sure you confirm that the initial cause of the bounce was resolved before doing so to avoid further issues. + +## Can I remove addresses from the blocklist? +Yes, all blocked addresses can be unblocked via the Scaleway console. For addresses you added manually, you have full control over when and if they are removed from the blocklist. \ No newline at end of file diff --git a/managed-services/transactional-email/how-to/create-webhooks.mdx b/managed-services/transactional-email/how-to/create-webhooks.mdx index 95a262657c..369d000b9c 100644 --- a/managed-services/transactional-email/how-to/create-webhooks.mdx +++ b/managed-services/transactional-email/how-to/create-webhooks.mdx @@ -23,6 +23,8 @@ You can set up webhooks for Scaleway Transactional Email and subscribe them to [ Currently, webhooks are integrated exclusively with the Scaleway Topics and Events. Billing for webhooks is based on the Scaleway [Topics and Events billing](https://www.scaleway.com/en/pricing/managed-databases/#messaging-and-queuing). + + - A Scaleway account logged into the [console](https://console.scaleway.com) - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization - [Configured your domain(s) with Transactional Email](/managed-services/transactional-email/how-to/configure-domain-with-transactional-email/) diff --git a/managed-services/transactional-email/how-to/manage-blocklists.mdx b/managed-services/transactional-email/how-to/manage-blocklists.mdx new file mode 100644 index 0000000000..7d83ad2220 --- /dev/null +++ b/managed-services/transactional-email/how-to/manage-blocklists.mdx @@ -0,0 +1,47 @@ +--- +meta: + title: How to manage Transactional Email blocklists + description: This page provides instructions how to improve the quality of your email deliveries and maintain your domain's reputation score with TEM blocklists. +content: + h1: How to manage Transactional Email blocklists + paragraph: This page provides instructions how to improve the quality of your email deliveries and maintain your domain's reputation score with TEM blocklists. +tags: blocklist reputation transactional +dates: + validation: 2025-01-20 + posted: 2025-01-20 +categories: + - managed-services +--- + +The Transactional Email blocklist feature allows your to manage email addresses that generate errors, or “bounces”. This helps you improve the quality of your email deliveries, maintain your domain's reputation score, and reduce the risk of having your domains blocked by ISPs. + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- [Configured your domain(s) with Transactional Email](/managed-services/transactional-email/how-to/configure-domain-with-transactional-email/) + +## How to add an email address to the blocklist + +Manually adding an email address to a domain's blocklist is only available for users who have a Scaleway domain. +When you add an email to the blocklist, it will remain block indefinitely unless you decide to [unblock it](#how-to-unblock-an-email-adress). + +Avoid sending emails to recipients who have unsubscribed from your list. + +Exclude addresses identified as inactive or irrelevant. + +Addresses added manually will remain blocked until you decide to remove them. + +1. Click **Transactional Email** in the **Managed Services** section of the [console](https://console.scaleway.com/) side menu. Your domains display. +2. Click the domain for which you want to manage the blocklist. An overview of your domain appears. +3. Click the **Blocklist** tab. +4. + + +## How to manage temporary blocklists + +If any of your emails were bounced, you will see a temporary blocklist, with a duration of 48h, with the details of the email that bounced and the reason. Some examples of bounce reasons are: `Mailbox not found`, when mailbox does not exist, and `Mailbox full`, when the mailbox is full. + +The temporary blocklist is created automatically to prevent repeated attempts to send e-mails, which could damage your reputation. + +## How to unblock an email adress \ No newline at end of file From 845e3e1509adce773fd3d6e6609198f50c66d24b Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 20 Jan 2025 14:10:34 +0100 Subject: [PATCH 2/7] fix(tem): blocklist draft 2 --- .../how-to/manage-blocklists.mdx | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/managed-services/transactional-email/how-to/manage-blocklists.mdx b/managed-services/transactional-email/how-to/manage-blocklists.mdx index 7d83ad2220..ee3e30d772 100644 --- a/managed-services/transactional-email/how-to/manage-blocklists.mdx +++ b/managed-services/transactional-email/how-to/manage-blocklists.mdx @@ -37,11 +37,20 @@ Addresses added manually will remain blocked until you decide to remove them. 3. Click the **Blocklist** tab. 4. - ## How to manage temporary blocklists -If any of your emails were bounced, you will see a temporary blocklist, with a duration of 48h, with the details of the email that bounced and the reason. Some examples of bounce reasons are: `Mailbox not found`, when mailbox does not exist, and `Mailbox full`, when the mailbox is full. +If any of your emails were bounced, you will see a temporary blocklist, with a duration of 48h, containing the details of the email that bounced and the reason, or flags. Some examples of bounce reasons are: + + - `Mailbox not found` - when mailbox does not exist + - `Mailbox full` - when the mailbox is full. The temporary blocklist is created automatically to prevent repeated attempts to send e-mails, which could damage your reputation. -## How to unblock an email adress \ No newline at end of file +A temporary error has been corrected (e.g. the recipient has freed up space in their mailbox). + +An address becomes valid again after an update. + +An address newly created by an administrator but not yet active can also be unblocked once activated. + + +## How to unblock an email address \ No newline at end of file From 98034d30b44f05f1228b79876968f895addaed19 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 20 Jan 2025 14:55:14 +0100 Subject: [PATCH 3/7] fix(tem): doc blocklist --- .../how-to/manage-blocklists.mdx | 43 +++++++++---------- 1 file changed, 21 insertions(+), 22 deletions(-) diff --git a/managed-services/transactional-email/how-to/manage-blocklists.mdx b/managed-services/transactional-email/how-to/manage-blocklists.mdx index ee3e30d772..5d0cdbde99 100644 --- a/managed-services/transactional-email/how-to/manage-blocklists.mdx +++ b/managed-services/transactional-email/how-to/manage-blocklists.mdx @@ -21,36 +21,35 @@ The Transactional Email blocklist feature allows your to manage email addresses - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization - [Configured your domain(s) with Transactional Email](/managed-services/transactional-email/how-to/configure-domain-with-transactional-email/) -## How to add an email address to the blocklist +## How to monitor temporary blocklists -Manually adding an email address to a domain's blocklist is only available for users who have a Scaleway domain. -When you add an email to the blocklist, it will remain block indefinitely unless you decide to [unblock it](#how-to-unblock-an-email-adress). +If any of your emails were bounced, you will see a temporary blocklist entry, with a duration of 48h, containing the details of the email that bounced and the reason, or flag. Some examples of bounce reasons are: -Avoid sending emails to recipients who have unsubscribed from your list. + - `Mailbox not found` - when mailbox does not exist + - `Mailbox full` - when the mailbox is full. -Exclude addresses identified as inactive or irrelevant. +The temporary blocklist entry is created automatically to prevent repeated attempts to send e-mails, which could damage your reputation. -Addresses added manually will remain blocked until you decide to remove them. +To see the blocklist: 1. Click **Transactional Email** in the **Managed Services** section of the [console](https://console.scaleway.com/) side menu. Your domains display. 2. Click the domain for which you want to manage the blocklist. An overview of your domain appears. -3. Click the **Blocklist** tab. -4. - -## How to manage temporary blocklists +3. Click the **Blocklist** tab. Your blocklist displays detailing the recipient email, the flags, the date the block began and when it ends. -If any of your emails were bounced, you will see a temporary blocklist, with a duration of 48h, containing the details of the email that bounced and the reason, or flags. Some examples of bounce reasons are: - - - `Mailbox not found` - when mailbox does not exist - - `Mailbox full` - when the mailbox is full. +## How to unblock an email address -The temporary blocklist is created automatically to prevent repeated attempts to send e-mails, which could damage your reputation. +You can unblock any address that was added to the blocklist. This is useful in cases where: -A temporary error has been corrected (e.g. the recipient has freed up space in their mailbox). +- A temporary error has been corrected. The recipient has freed up space in their mailbox, for example. +- An address becomes valid again after an update. -An address becomes valid again after an update. - -An address newly created by an administrator but not yet active can also be unblocked once activated. - - -## How to unblock an email address \ No newline at end of file +1. Click **Transactional Email** in the **Managed Services** section of the [console](https://console.scaleway.com/) side menu. Your domains display. +2. Click the domain for which you want to manage the blocklist. An overview of your domain appears. +3. Click the **Blocklist** tab. Your blocklist displays. +4. Click **Unblock** next to the email address you wish to unblock. A pop-up appears to warn you to: + + + Make sure the issue causing the email's rejection is resolved before unblocking it to protect your reputation score and ensure optimal email deliverability. + +5. Type **UNBLOCK** and click **Unblock** if you wish to continue. + The email address is removed from your blocklist. \ No newline at end of file From 28694e0b8e0db3b372a304845eb0e20587051397 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 20 Jan 2025 14:56:18 +0100 Subject: [PATCH 4/7] fix(tem): add to menu --- menu/navigation.json | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/menu/navigation.json b/menu/navigation.json index 6fc4b72960..d312770b85 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -2495,6 +2495,10 @@ "label": "Create and manage an email webhook", "slug": "create-webhooks" }, + { + "label": "Manage blocklists", + "slug": "manage-blocklists" + }, { "label": "Delete your domain", "slug": "delete-tem-domain" @@ -2961,7 +2965,6 @@ "slug": "getting-most-private-networks" }, { - "label": "VPC use case 1: basic infrastructure", "slug": "use-case-basic" }, From a12b07995ed41e3c5271323abaa68eac026c098b Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Wed, 22 Jan 2025 14:47:26 +0100 Subject: [PATCH 5/7] fix(tem): concept --- .../troubleshooting/database-unavailable.mdx | 37 +++++++++++++++++++ .../transactional-email/concepts.mdx | 4 ++ 2 files changed, 41 insertions(+) create mode 100644 managed-databases/postgresql-and-mysql/troubleshooting/database-unavailable.mdx diff --git a/managed-databases/postgresql-and-mysql/troubleshooting/database-unavailable.mdx b/managed-databases/postgresql-and-mysql/troubleshooting/database-unavailable.mdx new file mode 100644 index 0000000000..a4cfb2bfd0 --- /dev/null +++ b/managed-databases/postgresql-and-mysql/troubleshooting/database-unavailable.mdx @@ -0,0 +1,37 @@ +--- +meta: + title: My Database Instance is unavailable + description: Troubleshoot extension errors for PostgreSQL databases. +content: + h1: My Database Instance is unavailable + paragraph: Troubleshoot extension errors for PostgreSQL databases. +tags: disk-full databases +dates: + validation: 2025-01-20 + posted: 2025-01-20 +categories: + - managed-databases + - postgresql-and-mysql +--- + + +## Backup restoration error + +### Problem + +The following error appears when restoring a database from a logical backup: +``` + pg_restore: while PROCESSING TOC: pg_restore: ... pg_restore: error: could not execute query: ERROR: function unaccent(character varying) does not exist +``` + +### Cause + +The `unaccent` extension is installed in a public schema, the `search_path` is not set to public, and the namespace was not defined when running the function. + +### Solution + +For security reasons only the `pg_catalog` namespace is checked during backup restoration. Therefore you must check in which namespace the faulty function is defined. The function should be defined with an explicit namespace when it is used. + +Run the function again while defining the namespace. + +For more information and examples refer to the [PostgreSQL extensions reference](/managed-databases/postgresql-and-mysql/reference-content/postgresql-extensions) page. \ No newline at end of file diff --git a/managed-services/transactional-email/concepts.mdx b/managed-services/transactional-email/concepts.mdx index 4373b4704a..f12d170052 100644 --- a/managed-services/transactional-email/concepts.mdx +++ b/managed-services/transactional-email/concepts.mdx @@ -16,6 +16,10 @@ categories: An aggregate report (`rua`) is a periodic summary that provides data about a domain's email authentication activity. It includes information such as the volume of emails received, the percentage of emails that pass or fail DMARC checks, and the sources of failed authentication. +## Blocklist + +Blocklist allows your to manage email addresses that generate errors, or “bounces”. You can block them improve the quality of your email deliveries, maintain your domain's reputation score, and reduce the risk of having your domains blocked by ISPs. + ## Deliverability Deliverability is the ability for an email to arrive in a recipient’s email inbox. From a18b5e5b18482b6f9250765804e26465f7c23ffc Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Thu, 23 Jan 2025 15:38:50 +0100 Subject: [PATCH 6/7] fix(tem): remove question from faq --- faq/transactional-email.mdx | 3 --- 1 file changed, 3 deletions(-) diff --git a/faq/transactional-email.mdx b/faq/transactional-email.mdx index 56054aeb05..8e92120975 100644 --- a/faq/transactional-email.mdx +++ b/faq/transactional-email.mdx @@ -58,6 +58,3 @@ Yes, you can manually unblock any address, even if it is still under the tempora ## What happens if an address on a TEM blocklist becomes valid again? You can manually unblock the address. Make sure you confirm that the initial cause of the bounce was resolved before doing so to avoid further issues. - -## Can I remove addresses from the blocklist? -Yes, all blocked addresses can be unblocked via the Scaleway console. For addresses you added manually, you have full control over when and if they are removed from the blocklist. \ No newline at end of file From 18826768b63f2f97fc36c9e25ba1613653e0b057 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Sun, 26 Jan 2025 20:51:30 +0100 Subject: [PATCH 7/7] fix(tem): add webhooks and permission sets --- .../iam/reference-content/permission-sets.mdx | 2 ++ managed-services/transactional-email/concepts.mdx | 2 ++ .../transactional-email/how-to/manage-blocklists.mdx | 10 +++++++++- 3 files changed, 13 insertions(+), 1 deletion(-) diff --git a/identity-and-access-management/iam/reference-content/permission-sets.mdx b/identity-and-access-management/iam/reference-content/permission-sets.mdx index 892a052b6d..8b72ba6ad0 100644 --- a/identity-and-access-management/iam/reference-content/permission-sets.mdx +++ b/identity-and-access-management/iam/reference-content/permission-sets.mdx @@ -103,6 +103,8 @@ Below is a list of the permission sets available at Scaleway. | ObservabilityFullAccess | Full access to create, read, list, edit and delete Observability | | TransactionalEmailReadOnly | List and read access to Transactional Email | | TransactionalEmailFullAccess | Full access to create, read, list, edit and delete Transactional Email | +| TransactionalEmailBlocklistFullAccess | Full access to blocklists in transactional email. | +| TransactionalEmailBlocklistReadOnly | Read access to blocklists in transactional email. | | TransactionalEmailDomainReadOnly | Read access to domains in Transactional Email. Does not include permissions for e-mails | | TransactionalEmailDomainFullAccess | Full access to domains in Transactional Email. Does not include permissions for e-mails | | TransactionalEmailEmailReadOnly | Read access to e-mails in Transactional Email. Does not include permissions for domain configuration | diff --git a/managed-services/transactional-email/concepts.mdx b/managed-services/transactional-email/concepts.mdx index f12d170052..c54bb60d05 100644 --- a/managed-services/transactional-email/concepts.mdx +++ b/managed-services/transactional-email/concepts.mdx @@ -172,6 +172,8 @@ These are the different event types: - `email_delivered`: The email was successfully sent and accepted by the destination server. This event confirms that the email has reached the recipient's inbox. - `email_spam`: The email was identified as spam by Scaleway or the destination server. This event indicates that the email was classified as spam, either by an automated filter or by the recipient. - `email_mailbox_not_found`: The email was definitively rejected with a "mailbox not found" error. This indicates that the recipient's email address does not exist or is no longer active. +- `email_blocklisted` - An email was blocked by an active blocklist. +- `blocklist_created` - A blocklist is created for an email address. Any new emails sent by the address will be blocked. Refer to the [Transactional Email API documentation](https://www.scaleway.com/en/developers/api/transactional-email/) for more information about event types. diff --git a/managed-services/transactional-email/how-to/manage-blocklists.mdx b/managed-services/transactional-email/how-to/manage-blocklists.mdx index 5d0cdbde99..1369f31599 100644 --- a/managed-services/transactional-email/how-to/manage-blocklists.mdx +++ b/managed-services/transactional-email/how-to/manage-blocklists.mdx @@ -36,6 +36,14 @@ To see the blocklist: 2. Click the domain for which you want to manage the blocklist. An overview of your domain appears. 3. Click the **Blocklist** tab. Your blocklist displays detailing the recipient email, the flags, the date the block began and when it ends. + + You can [create webhooks](/managed-services/transactional-email/how-to/create-webhooks) for the following blocklist events: + - `email_blocklisted` - An email was blocked by an active blocklist. + - `blocklist_created` - A blocklist is created for an email address. Any new emails sent by the address will be blocked. + + By setting up a blocklist webhook, you can track changes to your blocklist in real time. + + ## How to unblock an email address You can unblock any address that was added to the blocklist. This is useful in cases where: @@ -52,4 +60,4 @@ You can unblock any address that was added to the blocklist. This is useful in c Make sure the issue causing the email's rejection is resolved before unblocking it to protect your reputation score and ensure optimal email deliverability. 5. Type **UNBLOCK** and click **Unblock** if you wish to continue. - The email address is removed from your blocklist. \ No newline at end of file + The email address is removed from your blocklist.