feat(tem): add domain autoconfiguration (#3824)

Author: bene2k1

faq/transactional-email.mdx

@@ -35,6 +35,14 @@ After configuring your SPF and DKIM records, you must launch a verification of t
 
 Setting up an [MX record](/managed-services/transactional-email/concepts#mx-record) is highly recommended to ensure your email deliverability. Find out [how to add an MX record to your domain](/managed-services/transactional-email/how-to/add-mx-record-to-your-domain/#how-to-add-your-own-mx-record). You can also [use Scaleway's blackhole MX](/managed-services/transactional-email/how-to/add-mx-record-to-your-domain/#how-to-add-scaleway's-mx-record) if you do not have your own MX.
 
+## What happens to automatically configured DNS records when I delete a domain in the Transactional Email service?
+
+When a domain is removed from Scalway's Transactional Email platform, [autoconfigured DNS records](/managed-services/transactional-email/how-to/autoconfigure-domain/) are not automatically deleted in the Domains & DNS section. If you no longer use the domain for sending emails, you must manually delete or modify these records. It is recommended to verify the associated DNS records to ensure they are correctly configured or removed.
+
+## What is the impact on the Transactional Email service if a DNS zone is deleted in Scaleway Domains & DNS?
+
+If a DNS zone is deleted while [autoconfig is enabled]((/managed-services/transactional-email/how-to/autoconfigure-domain/)), the DNS records will be added to the parent zone. This ensures that the domain remains validated on the Transactional Email platform, allowing continued use of the service without interruption.
+
 ## What are the limitations and restrictions when using Transactional Email?
 
 Find out about [limits and quotas](/managed-services/transactional-email/reference-content/tem-capabilities-and-limits/) available for Transactional Email. If you want to increase your quota beyond the values shown on this page, [contact our support team](https://console.scaleway.com/support/create).

managed-services/transactional-email/how-to/autoconfigure-domain.mdx

@@ -0,0 +1,54 @@
+---
+meta:
+  title: How to autoconfigure a Scaleway domain with Transactional Email
+  description: This page provides instructions how to automatically configure the required DNS records on your domain with Transactional Email.
+content:
+  h1: How to autoconfigure a Scaleway domain with Transactional Email
+  paragraph: This page provides instructions how to automatically configure the required DNS records on your domain with Transactional Email.
+tags: autoconfiguration autoconfig domain dns spf spf-record dkim dkim-records transactional
+dates:
+  validation: 2024-10-11
+  posted: 2024-10-11
+categories:
+  - managed-services
+---
+
+With Scaleway domains, you can now benefit from automatic DNS record creation and updates (autoconfiguration) for domains already registered with the Transactional Email service.
+Automatic configuration of your DNS zone streamlines the setup of your domain for Transactional Email, allowing you to focus on sending emails and tracking traffic without manual configuration delays.
+
+You can enable autoconfiguration directly from the Scaleway console (see instructions below), through the [Transactional Email API](https://www.scaleway.com/en/developers/api/transactional-email/#path-domains-register-a-domain-in-a-project), or via [Terraform](https://github.com/scaleway/terraform-provider-scaleway/blob/master/docs/data-sources/tem_domain.md) using the `autoconfig` parameter (`bool`).
+
+<Message type="note">
+    This documentation covers the use of DNS autoconfiguration for domains already registerd with Transactional Email. If you want to add a new domain, refer to [How to configure your sending domain with Transactional Email](/managed-services/transactional-email/how-to/configure-domain-with-transactional-email/).
+</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
+- A domain name registered with [Scaleway Domains and DNS](/network/domains-and-dns/)
+
+## How to enable DNS autoconfiguration
+
+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 the domain you want to configure. The Transactional Email dashboard for the domain displays.
+3. Click the **DNS Verification** tab.
+4. Navigate to the **Autoconfiguration** section of the page, then click **Enable autoconfigration**. A pop-up displays.
+5. Confirm by clicking **Enable autoconfiguration** in the pop-up. The DNS zone of your domain will be updated with SPF, DKIM, DMARC and MX records.
+    <Message type="tip">
+      During the autoconfiguration process, a blue dot appears next to your domain to indicate the status. Once the configuration is complete, the dot will turn green.
+    </Message>
+
+## How to disable DNS autoconfiguration
+
+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 the domain you want to configure. The Transactional Email dashobard for the domain displays.
+3. Click the **DNS Verification** tab.
+4. Navigate to the **Autoconfiguration** section of the page, then click **Disable autoconfigration**. A pop-up displays.
+5. Type **DISABLE** and click **Disable autoconfiguation** to disable the automatic configuration of the DNS.
+
+<Message type="note">
+- If you disable autoconfig, you have to **manually manage** DNS records (SPF, DKIM, MX, DMARC).
+- **Existing DNS records are not deleted**. Disabling autoconfig does not remove the previously created DNS records. They will remain in place until manually modified or deleted. You can configure multiple mail servers or providers, which requires a single SPF and DMARC record for different domains. Therefore, the records are not automatically removed.
+</Message>
+

managed-services/transactional-email/how-to/configure-domain-with-transactional-email.mdx

@@ -7,7 +7,7 @@ content:
   paragraph: Guide to configuring your domain for Scaleway Transactional Email.
 tags: transactional sending-domain sending domain managed-services
 dates:
-  validation: 2024-06-26
+  validation: 2024-10-11
   posted: 2022-11-07
 categories:
   - managed-services
@@ -21,13 +21,30 @@ This page shows you how to configure your sending domain to start sending [trans
 - [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
 - A domain name
 
+## Automatic configuration for a Scaleway domain
+
+When you use a domain name registered with [Scaleway Domains and DNS](/network/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.
+
+## Manual configuration for an external domain
+
+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.
+
 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**.
+2. Click **Add domain**. The domain creation wizard displays.
 3. Enter the domain name you want to use with Transactional Email.
-4. Click **Validate domain name** to confirm.
+4. Tick the checkbox to confirm that you agree to Scaleway's antispam policy, then click **Validate domain name** to confirm.
 
 <Message type="important">
- You need to configure your [SPF](/managed-services/transactional-email/concepts/#spf-record), [DKIM](/managed-services/transactional-email/concepts/#dkim-record) and [MX](/managed-services/transactional-email/concepts/#mx-record) records to verify your domain and to be able to send emails.
+ For external domains, you need to configure your [SPF](/managed-services/transactional-email/concepts/#spf-record), [DKIM](/managed-services/transactional-email/concepts/#dkim-record) and [MX](/managed-services/transactional-email/concepts/#mx-record) records **manually** to verify your domain and to be able to send emails.
 </Message>
 
 

menu/navigation.json

@@ -2372,6 +2372,10 @@
                     "label": "Configure your domain with Transactional Email",
                     "slug": "configure-domain-with-transactional-email"
                   },
+                  {
+                    "label": "Autoconfigure a Scaleway domain with Transactional Email",
+                    "slug": "autoconfigure-domain"
+                  },
                   {
                     "label": "Add SPF and DKIM records to your domain",
                     "slug": "add-spf-dkim-records-to-your-domain"
@@ -2930,15 +2934,15 @@
                 "slug": "api-cli"
               },
               {
-              "items": [
-                {
-                  "label": "Public connectivity: best practices",
-                  "slug": "public-connectivity-best-practices"
-                }
-              ],
-              "label": "Additional Content",
-              "slug": "reference-content"
-            }
+                "items": [
+                  {
+                    "label": "Public connectivity: best practices",
+                    "slug": "public-connectivity-best-practices"
+                  }
+                ],
+                "label": "Additional Content",
+                "slug": "reference-content"
+              }
             ],
             "label": "IPAM",
             "slug": "ipam"