feat(tem): blocklist - MTA-5412

faq/transactional-email.mdx

@@ -51,4 +51,10 @@ 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.
+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.

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               |

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.

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.
@@ -168,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.
 
 <Message type="note">
   Refer to the [Transactional Email API documentation](https://www.scaleway.com/en/developers/api/transactional-email/) for more information about event types.

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).
 </Message>
 
+<Macro id="requirements" />
+
 - 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/)

managed-services/transactional-email/how-to/manage-blocklists.mdx

@@ -0,0 +1,63 @@
+---
+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.
+
+<Macro id="requirements" />
+
+- 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 monitor temporary blocklists
+
+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:
+
+  - `Mailbox not found` - when mailbox does not exist
+  - `Mailbox full` - when the mailbox is full.
+
+The temporary blocklist entry is created automatically to prevent repeated attempts to send e-mails, which could damage your reputation.
+
+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. Your blocklist displays detailing the recipient email, the flags, the date the block began and when it ends.
+
+<Message type="tip">
+  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.
+</Message>
+
+## How to unblock an email address
+
+You can unblock any address that was added to the blocklist. This is useful in cases where:
+
+- 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.
+
+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:
+
+    <Message type="important">
+      Make sure the issue causing the email's rejection is resolved before unblocking it to protect your reputation score and ensure optimal email deliverability.
+    </Message>
+5. Type **UNBLOCK** and click **Unblock** if you wish to continue.
+    The email address is removed from your blocklist.

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"
                   },