feat(tem): scale plan MTA-5622

faq/transactional-email.mdx

@@ -57,4 +57,34 @@ Check out our [dedicated page](https://www.scaleway.com/en/pricing/?tags=managed
 Yes, you can manually unblock any address, even if it is still under the temporary block period. You can unblock up to five addresses every 24 hours.
 
 ## 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.
+You can manually unblock the address. Before doing so, ensure that the initial cause of the bounce has been resolved to prevent further issues.
+
+## Can I remove addresses from the blocklist?
+Yes, all blocked addresses can be unblocked via the interface. If you manually added an address, you have full control over when and if it is removed from the blocklist.
+
+## What are the main benefits of the Scale plan?
+The Scale plan provides advanced control over email deliverability through a dedicated IP, detailed performance tracking, and advanced webhook management. It is ideal for businesses with high email-sending volume requirements.
+
+## What is the difference between a dedicated IP and a shared IP?
+A dedicated IP is used exclusively by a single user, allowing for better control over sending reputation. A shared IP is shared among multiple users, which can impact deliverability based on the practices of other senders.
+
+## What happens if my dedicated IP is blacklisted?
+TEM can assist in identifying the problem and recommending corrective actions, but the final resolution depends on your sending practices. Therefore, it is essential to follow [best practices for deliverability](/transactional-email/reference-content/understanding-tem-reputation-score/#best-practices-for-domain-reputation-and-deliverability) to avoid this type of situation.
+
+## Can I use both a dedicated IP and a shared IP on the same project?
+No, a project using a dedicated IP cannot send emails via a shared IP. If you want to use a shared IP, you must create a separate project.
+
+Refer to the [Understanding managed dedicated IPs](/transactional-email/reference-content/tem-dedicated-ip) documentation page for more information.
+
+## Does a dedicated IP include both IPv4 and IPv6?
+Yes, each dedicated IP provided with the Scale plan includes both an IPv4 and an IPv6 address. This ensures better compatibility with different email providers and optimizes the deliverability of sent emails.
+
+Refer to the [Understanding managed dedicated IPs](/transactional-email/reference-content/tem-dedicated-ip) documentation page for more information.
+
+## Can I add a new dedicated IP to my Organization?
+If you want to add a new dedicated IP to your Organization, you must create a new Scaleway Project with the Scale plan or contact support to review your request.
+
+Refer to the [Understanding managed dedicated IPs](/transactional-email/reference-content/tem-dedicated-ip) documentation page for more information.
+
+## Does Scaleway have an anti-spam policy?
+Yes. You can find Scaleway's official Transactional Email anti-spam policy in the [contracts](https://www.scaleway.com/en/contracts/) section of the Scaleway website.

macros/tem/dedicated-ip.mdx

@@ -0,0 +1,9 @@
+---
+macro: dedicated-ip
+---
+
+Transactional Email (TEM) dedicated IPs are IP addresses assigned to a single sender. This allows the sender complete control over their sending reputation without having to manage the technical complexity related to IP optimization and monitoring.
+
+Unlike shared IPs where multiple users share the same reputation, a dedicated IP offers total control over reputation and deliverability, less impact from other senders, and better deliverability on sensitive domains (Gmail, Outlook, Yahoo, etc.).
+
+TEM dedicated IPs are available with the [TEM Scale plan](/transactional-email/concepts#scale-plan) and are managed by Scaleway. This means that the TEM team takes care of optimizing and monitoring the dedicated IPs.

menu/navigation.json

@@ -2742,6 +2742,10 @@
                     "label": "Configure your domain with Transactional Email",
                     "slug": "configure-domain-with-transactional-email"
                   },
+                  {
+                    "label": "Manage Transactional Email plans",
+                    "slug": "manage-tem-plans"
+                  },
                   {
                     "label": "Autoconfigure a Scaleway domain with Transactional Email",
                     "slug": "autoconfigure-domain"
@@ -2766,6 +2770,10 @@
                     "label": "Manage your email activity",
                     "slug": "manage-email-activity"
                   },
+                  {
+                    "label": "Monitor Transactional Email with Cockpit",
+                    "slug": "monitor-transactional-email-cockpit"
+                  },
                   {
                     "label": "Generate API keys for API and SMTP sending with IAM",
                     "slug": "generate-api-keys-for-tem-with-iam"
@@ -2829,6 +2837,10 @@
                   {
                     "label": "Setting up SMTP",
                     "slug": "smtp-configuration"
+                  },
+                  {
+                    "label": "Understanding managed dedicated IPs",
+                    "slug": "tem-dedicated-ip"
                   }
                 ],
                 "label": "Additional Content",

pages/transactional-email/concepts.mdx

@@ -20,6 +20,12 @@ An aggregate report (`rua`) is a periodic summary that provides data about a dom
 
 Blocklist is a feature that allows you to manage email addresses that generate errors, or “bounces”. Emails are automatically blocked when a mailbox does not exist, or is full, to prevent sending emails to a recipient address that is not reachable.
 
+## Dedicated IPs
+
+<Macro id="dedicated-ip" />
+
+Refer to the [Understanding managed dedicated IPs](/transactional-email/reference-content/tem-dedicated-ip) documentation page for more information.
+
 ## Deliverability
 
 Deliverability is the ability for an email to arrive in a recipient’s email inbox.
@@ -41,6 +47,17 @@ DNS propagation is the time a DNS change takes to be updated across the internet
 
 An email webhook is a mechanism that allows an application to send real-time notifications to another application when a specific email-related event occurs. When certain predefined events happen, a notification (webhook) is sent to a URL specified by the user. This allows the receiving application to immediately react to events such as email delivery, a bounce, or being marked as spam.
 
+## Essential plan
+
+The Essential plan is a pay-as-you-go plan designed for occasional or low-volume email sending needs.
+
+The plan offers:
+
+  - Simplified management
+  - A single webhook per domain
+  - 300 free emails (with an additional cost of €0.25 for every 1000 additional emails)
+  - An automatic blocklist with the option to unblock, but not manually add, email addresses.
+
 ## Flags
 
 Scaleway uses flags to provide you with more information about your emails. Flags can let you know whether an email you have sent is considered a spam, for example.
@@ -65,13 +82,25 @@ Hard bounce occurs when an email is sent to an invalid email address or an addre
 
 In this case, most emailing solutions will blacklist these email addresses.
 
-## IP warming
+## IP warm-up
+
+IP warm-up is a gradual process that allows you to build a good reputation for a dedicated IP address by progressively increasing the volume of emails sent.
 
-IP warming is the process of gradually increasing the volume of emails sent through a new IP or an API that has not been used in a while.
+This helps prevent emails from being marked as spam by email providers.
 
-The process of warming up an IP address consists of gradually sending emails from it, starting with small volumes and increasing the volume over a period of days weeks or months, according to a set schedule.
+The process has two phases:
 
-Internet service providers are wary of emails sent from new IP addresses with no reputation, so warming up an IP allows for better email deliverability and thus, better reputation.
+- **Progressive volume increase** - During the first few weeks, the number of emails sent is limited and increases in a controlled manner.
+- **Monitoring and adjustments** - Deliverability performance is analyzed, and adjustments are made if necessary.
+
+The IP warm-up process can last between 3 and 6 weeks, depending on the sending volume, adopted practices, and email provider requirements.
+
+Some practices that can be adopted to warm-up an IP address are:
+- **Starting out with low volumes** and gradually increasing them according to the recommendations.
+- **Sending to engaged recipients** to achieve good click-through and opening rates.
+- **Avoid mass sending** from the start to avoid triggering anti-spam filters.
+- **Monitor bounce and complaint rates** to adjust your strategy if necessary.
+- **Ensure high-quality content** and good targeting to enforce deliverability.
 
 ## IP reputation
 
@@ -120,6 +149,16 @@ The **closer to 100** your reputation score is, the more receiving email servers
 A domain's reputation score is determined by email providers and Internet Service Providers (ISPs), which means you have a different domain reputation for each email service provider.
 </Message>
 
+## Scale plan
+
+The Scale plan is a solution for sending transactional emails, designed for businesses and developers with high volume and advanced needs. It includes:
+  - A [dedicated IP](/transactional-email/reference-content/tem-dedicated-ip) for better control over sending reputation
+  - 100K emails (with an additional cost of €0.20 for every 1000 additional emails.)
+  - Advanced webhook management
+  - Blocklist management,
+  - Detailed monitoring and reporting,
+  - A 99.9% SLA.
+
 ## Send API
 
 A send API is the main API that is used to send transactional emails to recipients.
@@ -160,6 +199,14 @@ An SPF record specifies the mail servers that are allowed to send email for your
 
 Transactional Email is a platform that allows you to send transactional emails. Unlike marketing emails (which are mass distributions of the same marketing message to multiple recipients), transactional emails are personalized emails sent to individuals in response to events they have triggered (e.g. password recovery, billing information, delivery updates, etc).
 
+## TEM plans
+
+Plans are the Transaction Email tiers of service. Each plan includes a set of features, pricing, and usage limits tailored to meet your use cases, ranging from low-volume occasional senders to high-volume enterprise users. Plans are scoped to Projects.
+
+Two plans are available:
+  - [Essential](#essential-plan)
+  - [Scale](#scale-plan)
+
 ## Webhook Event Type
 
 The Webhook event type defines the type of event that triggered the webhook.

pages/transactional-email/how-to/configure-domain-with-transactional-email.mdx

@@ -21,30 +21,47 @@ This page shows you how to configure your sending domain to start sending [trans
 - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
 - A domain name
 
-## Automatic configuration for a Scaleway domain
-
-When you use a domain name registered with [Scaleway Domains and DNS](/domains-and-dns/), you can benefit from DNS autoconfiguration. We can automatically configure SPF, DKIM, DMARC, MX on your behalf so
-your domain name can be validated automatically and you can focus on sending emails and observing the reputation status of your domain.
 
 1. Click **Transactional Email** in the **Managed Services** section of the [console](https://console.scaleway.com/) side menu. The **Transactional Email** overview page displays.
-2. Click **Add domain**. The domain creation wizard displays.
-3. Add your domain. Select **Use Scaleway domain** and choose your Scaleway domain from the drop down list.
-4. Optionally, tick the checkbox **Add a domain prefix** to configure a subdomain for use with the Transactional Email service.
-4. Tick the checkbox **Configure my Transactional Email DNS records automatically**.
-5. Tick the checkbox to confirm that you agree to Scaleway's antispam policy, then click **Validate domain name** to confirm.
+2. Click **Select a plan**. The Transactional Email creation wizard displays.
+3. Select a plan. Two plans are available:
+    - **Essential** - pay-as-you-go plan designed for occasional or low-volume email sending needs. This plan offers simplified management and a single webhook per domain.
+    - **Scale** - fixed-price plan tailored for high-volume email sending. Includes 100K emails. Additional emails are charged. This plan includes a [dedicated IP address](/transactional-email/reference-content/tem-dedicated-ip) and unlimited webhooks per domain. It also features advanced blocklist management, allowing for manual additions.
+    <Message type="important">
+      When you select the **Scale plan**, keep in mind that:
+        - A 30-day commitment is required to ensure a progressive and effective [warm-up of the IP address](/transactional-email/concepts#ip-warm-up).
+        - 100K emails are included in the offer, with an additional cost of €0.20 for every 1000 additional emails
+    </Message>
+4. Click **Choose a plan and add a domain**.
+5. Select whether to **Use a Scaleway domain** or **Add a domain external to Scaleway**. Follow the next steps according to your choice.
+<Tabs id="domain-type">
+  <TabsTab label="Scaleway domain">
+  <Message type="tip">
+    When you use a domain name registered with [Scaleway Domains and DNS](/domains-and-dns/), you can benefit from DNS autoconfiguration. We can automatically configure SPF, DKIM, DMARC, MX on your behalf so your domain name can be validated automatically and you can focus on sending emails and observing the reputation status of your domain.
+  </Message>
+  1. Choose your existing Scaleway domain from the drop down list.
 
-## Manual configuration for an external domain
+      <Message type="important">
+        If you do not have an active domain in your current Project, click **Register a domain** to [register a domain](/domains-and-dns/how-to/register-internal-domain/) with Scaleway Domains and DNS.
+      </Message>
 
-If your domain is registered with an external registrar, you can use it with the Transactional Email service by configuring the required DNS records manually.
-Validation time of domain ownership may be extended.
+  2. Optionally, tick the checkbox **Add a domain prefix** to configure a subdomain for use with the Transactional Email service.
+  3. Tick the checkbox **Configure my Transactional Email DNS records automatically**.
+  4. Review the estimated monthly cost.
+  5. Click **Validate domain name**.
+  </TabsTab>
+  <TabsTab label="External domain">
+  <Message type="important">
+    If your domain is registered with an external registrar, you can use it with the Transactional Email service by configuring the required DNS records manually. Validation time of domain ownership may be extended.
+  </Message>
 
-1. Click **Transactional Email** in the **Managed Services** section of the [console](https://console.scaleway.com/) side menu. The **Transactional Email** overview page displays.
-2. Click **Add domain**. The domain creation wizard displays.
-3. Enter the domain name you want to use with Transactional Email.
-4. Tick the checkbox to confirm that you agree to Scaleway's antispam policy, then click **Validate domain name** to confirm.
+  1. Enter the domain name you want to use with Transactional Email.
+  2. Click **Validate domain name**.
+      <Message type="important">
+      For external domains, you need to configure your [SPF](/transactional-email/concepts/#spf-record), [DKIM](/transactional-email/concepts/#dkim-record), [DMARC](/transactional-email/how-to/add-dmarc-record) and [MX](/transactional-email/concepts/#mx-record) records **manually** to verify your domain and to be able to send emails.
+      </Message>
 
-<Message type="important">
- For external domains, you need to configure your [SPF](/transactional-email/concepts/#spf-record), [DKIM](/transactional-email/concepts/#dkim-record), [DMARC](/transactional-email/how-to/add-dmarc-record) and [MX](/transactional-email/concepts/#mx-record) records **manually** to verify your domain and to be able to send emails.
-</Message>
+  </TabsTab>
+</Tabs>
 
 

pages/transactional-email/how-to/manage-blocklists.mdx

@@ -13,14 +13,36 @@ categories:
   - managed-services
 ---
 
-The Transactional Email blocklist feature allows your to manage email addresses that generate errors, or “bounces”. Emails are automatically blocked when a mailbox does not exist, or is full, to prevent sending emails to a recipient address that is not reachable.
+The Transactional Email (TEM) blocklist feature allows your to manage email addresses that generate errors, or “bounces”. Emails are automatically blocked when a mailbox does not exist, or is full, to prevent sending emails to a recipient address that is not reachable. You can also add emails to the blocklist manually if you subscribe to the [TEM Scale plan](/concepts#scale-plan) and have a Scaleway domain.
 
 <Macro id="requirements" />
 
 - A Scaleway account logged into the [console](https://console.scaleway.com)
 - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization. For blocklists your can apply the `TransactionalEmailBlocklistFullAccess` permission
 - [Configured your domain(s) with Transactional Email](/transactional-email/how-to/configure-domain-with-transactional-email/)
 
+## How to add an email address to the blocklist
+
+You can manually add addresses to your blocklist in the Scaleway console. When you add an email to the blocklist, it remains blocked indefinitely until you decide to [unblock it](#how-to-unblock-an-email-adress).
+
+<Message type="important">
+  Manually adding an email address to a domain's blocklist is only available for users who have a Scaleway domain and subscribe to the [TEM Scale plan](/concepts#scale-plan) for that domain's Project.
+</Message>
+
+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. Click **Add to blocklist**. A pop-up appears
+5. Enter the recepient emails you wish to prevent from receiving emails from your domain.
+    <Message type="important">
+      You can separate each email address by a comma to add multiple emails at once.
+    </Message>
+6. Optionally, add a reason for the block.
+7. Select a flag between:
+    - `Mailbox not found` - when mailbox does not exist
+    - `Mailbox full` - when the mailbox is full.
+8. Click **Add to blocklist**. The email is added to your blocklist.
+
 ## How to monitor temporary blocklists
 
 If any of your emails bounced, you will see a temporary blocklist entry, with a duration of 48 hours, containing the details of the email that bounced and the reason, or flag. Some examples of bounce reasons are: