diff --git a/faq/transactional-email.mdx b/faq/transactional-email.mdx index 7ec56c14e5..16769de0b5 100644 --- a/faq/transactional-email.mdx +++ b/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. \ No newline at end of file diff --git a/macros/tem/dedicated-ip.mdx b/macros/tem/dedicated-ip.mdx new file mode 100644 index 0000000000..ee9657776f --- /dev/null +++ b/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. \ No newline at end of file diff --git a/menu/navigation.json b/menu/navigation.json index e2f10ffcc4..29d5332754 100644 --- a/menu/navigation.json +++ b/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", diff --git a/pages/transactional-email/concepts.mdx b/pages/transactional-email/concepts.mdx index f8f7f5e0bd..00c943f3c2 100644 --- a/pages/transactional-email/concepts.mdx +++ b/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 + + + +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,16 @@ 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 operates on a pay-as-you-go basis, making it ideal for users with 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 +81,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 effective practices for warming up an IP address include: +- **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 +148,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. +## 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 +198,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 service tiers for Transactional Email, each offering specific features, pricing, and usage limits to suit different needs—from occasional low-volume senders to high-volume enterprise users. Plans are scoped at the Project level. + +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. diff --git a/pages/transactional-email/how-to/assets/scaleway-tem-current-plan-tooltip.webp b/pages/transactional-email/how-to/assets/scaleway-tem-current-plan-tooltip.webp new file mode 100644 index 0000000000..50e6cb2382 Binary files /dev/null and b/pages/transactional-email/how-to/assets/scaleway-tem-current-plan-tooltip.webp differ diff --git a/pages/transactional-email/how-to/assets/scaleway-tem-current-plan.webp b/pages/transactional-email/how-to/assets/scaleway-tem-current-plan.webp new file mode 100644 index 0000000000..c39af897fd Binary files /dev/null and b/pages/transactional-email/how-to/assets/scaleway-tem-current-plan.webp differ diff --git a/pages/transactional-email/how-to/configure-domain-with-transactional-email.mdx b/pages/transactional-email/how-to/configure-domain-with-transactional-email.mdx index 76a0143aa9..3309b55ecb 100644 --- a/pages/transactional-email/how-to/configure-domain-with-transactional-email.mdx +++ b/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. + + 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 + +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. + + + + 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. Choose your existing Scaleway domain from the drop-down list. -## Manual configuration for an external domain + + 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. + -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**. + + + + 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**. 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**. + + 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. + - - 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. - + + diff --git a/pages/transactional-email/how-to/manage-blocklists.mdx b/pages/transactional-email/how-to/manage-blocklists.mdx index c5abe051cb..e380095ed1 100644 --- a/pages/transactional-email/how-to/manage-blocklists.mdx +++ b/pages/transactional-email/how-to/manage-blocklists.mdx @@ -13,7 +13,7 @@ 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 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. 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. @@ -21,6 +21,28 @@ The Transactional Email blocklist feature allows your to manage email addresses - [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. Once added, the email remains blocked indefinitely until you [unblock it](# how-to-unblock-an-email-address) manually. + + + 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. + + +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 recipient emails you wish to prevent from receiving emails from your domain. + + You can separate each email address by a comma to add multiple emails at once. + +6. (Optional) Provide a reason for blocking the address. +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: diff --git a/pages/transactional-email/how-to/manage-tem-plans.mdx b/pages/transactional-email/how-to/manage-tem-plans.mdx new file mode 100644 index 0000000000..ec573fb52c --- /dev/null +++ b/pages/transactional-email/how-to/manage-tem-plans.mdx @@ -0,0 +1,80 @@ +--- +meta: + title: How to manage TEM plans + description: Guide to managing your TEM plans with Scaleway, including upgrading, downgrading, and monitoring usage. +content: + h1: How to manage TEM plans + paragraph: Step-by-step guide to managing your TEM plans with Scaleway. +tags: tem plans management transactional email +dates: + validation: 2024-03-12 + posted: 2024-03-12 +categories: + - transactional-email +--- + +Plans are the service tiers for Transactional Email, each offering specific features, pricing, and usage limits to suit different needs—from occasional low-volume senders to high-volume enterprise users. Plans are scoped to Projects. + +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 and unlimited webhooks per domain. It also features advanced blocklist management, allowing for manual additions. + + + +- 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 + +## How to change TEM plans + +When you configure a domain with Transactional Email in a Project for the first time, you are prompted to select a TEM plan between [Essential](/transactional-email/concepts#essential-plan) and [Scale](/transactional-email/concepts#scale-plan). + +You can change your selected plan anytime in the Scaleway console. + +1. Click **Transactional Email** in the **Managed Services** section of the [console](https://console.scaleway.com/) side menu. Your domains display. +2. Click the **Plans** tab. +3. Scroll to the **Manage your plan** section. +4. Click **Select plan** to select the plan to which you want to change. A pop-up appears. + + - If you are upgrading to the **Scale plan** keep in mind that: + - You will be billed a fixed monthly amount, instead of pay-as-you-go. + - A 30-day commitment is required to ensure a progressive and effective [warm-up of the IP address](/transactional-email/concepts#ip-warm-up). If you decide to downgrade or cancel your account before the end of the commitment period, you will still be charged for the 30-day period. + - If you are downgrading to the **Essential plan**, consider that: + - You will lose access to your dedicated IP address and will be reverted to a shared IP. This may impact your sending speed and deliverability. + - This will reduce the number of available webhooks + - You will be reverted to an automatic blocklist. This means you will no longer be able to manually add emails to your blocklist. + +5. Type **UPGRADE** to confirm. + +## How to keep track of your resources + +Each TEM plan has a number of domains and webhooks included in the plan. To keep track of your usage and consumption, you can follow the steps below: + +1. Click **Transactional Email** in the **Managed Services** section of the [console](https://console.scaleway.com/) side menu. Your domains display. +2. Click the **Plans** tab. +3. Scroll to the **Current plan** section. This section shows you how many domains and webhooks are currently being used in your Project. + + If you reach or surpass the free capacity of your plan, the number of resources will be indicated in red. + + + + You can click the information tooltip next to the number to view details on how much each resource exceeded the included amount. + + + + + You can click **Upgrade plan** in the **Current plan** section to quickly upgrade from the Essential to the Scale plan if your included resources have been exceeded. + + +## How to manage dedicated IPs + + + +You can check your IPv4 and IPv6 addresses in the **Managed Dedicated IP** section of the **Plans** tab. + + + Refer to the [Understanding managed dedicated IPs](/transactional-email/reference-content/tem-dedicated-ip) documentation page for more information on: + - Which management actions the Scaleway TEM team is responsible for + - When it is recommended to use a dedicated IP + - Technical limitations of the feature + + diff --git a/pages/transactional-email/how-to/monitor-transactional-email-cockpit.mdx b/pages/transactional-email/how-to/monitor-transactional-email-cockpit.mdx new file mode 100644 index 0000000000..f12eea2fa0 --- /dev/null +++ b/pages/transactional-email/how-to/monitor-transactional-email-cockpit.mdx @@ -0,0 +1,83 @@ +--- +meta: + title: How to monitor your Transactional Emails with Scaleway Cockpit + description: Learn how to effectively monitor your Transactional Email using Scaleway Cockpit for optimal deliverability and performance. +content: + h1: How to monitor your Transactional Emails with Scaleway Cockpit + paragraph: Learn how to effectively monitor your Transactional Email using Scaleway Cockpit for optimal deliverability and performance. +tags: transactional-email email-deliverability cockpit observability dashboard metrics logs alerts +dates: + validation: 2025-03-05 + posted: 2025-03-05 +categories: + - transactional-email +--- + +You can use Scaleway Cockpit to track TEM metrics and monitor email activity, detect potential deliverability issues, and check key indicators to track your domain's reputation. + +This page explains how to get started with Scaleway Cockpit for viewing your Transactional Email metrics and logs. + + + +- 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 +- [Configured your domain(s) with Transactional Email](/transactional-email/how-to/configure-domain-with-transactional-email/) +- Added [SPF, DKIM](/transactional-email/how-to/add-spf-dkim-records-to-your-domain/), [MX](/transactional-email/how-to/add-mx-record-to-your-domain/) and [DMARC](/transactional-email/how-to/add-dmarc-record/) records to your domain(s) + +## How to activate your Cockpit + +Scaleway Cockpit is activated by default if you have created any [Scaleway resources integrated with Cockpit](/cockpit/reference-content/cockpit-limitations/#product-integration-into-cockpit). + +## How to access the Grafana dashboard + +To view your TEM metrics, use the Grafana preconfigured dashboard which is accessible from the Scaleway console: + - First, you must create a user and their associated credentials (a username and password) for Grafana + - Then, you can use these credentials to access Grafana from the Scaleway console, and visualize preconfigured dashboards for all your Scaleway products. + +1. Create a Grafana user and retrieve their username and password by [following this procedure](/cockpit/how-to/retrieve-grafana-credentials/). + +2. From the Scaleway console [Cockpit overview page](https://console.scaleway.com/cockpit/overview), click **Open dashboards** in the top right corner. + +3. Enter your Grafana username and password to log in. + + You are directed to the Scaleway Cockpit dashboards homepage. + +## How to view and understand your TEM metrics + +1. Click **Open dashboards** on the top right from the Scaleway Cockpit dashboards homepage. +2. Click either **TEM Overview** or **TEM Overview**, depending on your engine of choice, on the left side menu. + + You are directed to the TEM Overview dashboard. + + + +### List of Metrics + +Metrics are refreshed every minute, and report on the following data: + + + Metrics on dedicated IPs are only accessible to users who subscribe to the Scale offer. + + +| Category | Metric | Description | +| --- | --- | --- | +| Reputation | Current reputation score | Current reputation score of the domain. | +| Reputation | Reputation score evolution | History and evolution of the reputation score. | +| Email Activity | Global email traffic distribution by IP type | Distribution of email traffic between dedicated and shared IPs. | +| Email Activity | Global email traffic by IP type | Total volume of emails sent, segmented by IP type. | +| Email Activity | Email activity - all IPs | Total number of emails delivered and rejected across all IPs. | +| Email Activity | General activity - all IPs | An overview of email traffic. | +| Email Activity | Email rejected distribution - All IPs | Distribution of rejected emails by rejection type. | +| Errors | Errors activity - all IPs | Main recipient domains of sent emails. | +| Destinations and Rejections | Top recipient destination - all IPs | Main recipient domains of sent emails. | +| Destinations and Rejections | Top bounce recipient - all IPs | List of recipients with the most bounces. | +| Destinations and Rejections | Top fail recipient - all IPs | List of recipients for whom emails consistently failed. | + + +### Choosing metric parameters + +At the top of the dashboard, you can configure the following parameters, that control which metrics are displayed: + +- **Datasource** - Select the SCW region for which you want to see the metrics. +- **Domain** - Select the specific domain for which you want to see the metrics +- **Timeframe** - Get metrics from the last five minutes up to 31 days (free plan) and 365 days (premium plan). \ No newline at end of file diff --git a/pages/transactional-email/quickstart.mdx b/pages/transactional-email/quickstart.mdx index e126f588a9..a6e7dac40d 100644 --- a/pages/transactional-email/quickstart.mdx +++ b/pages/transactional-email/quickstart.mdx @@ -26,15 +26,19 @@ In this quickstart, we show you how to configure your domain with Transactional ## How to configure your domain with Transactional Email 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**. -3. Enter the domain name you want to use with Transactional Email. -4. Tick the box to acknowledge you have read 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 and unlimited webhooks per domain. It also features advanced blocklist management, allowing for manual additions. +4. Click **Choose a plan and add a domain**. +5. Select whether to **Use a Scaleway domain** or **Add a domain external to Scaleway**. +6. Enter the domain name you want to use with Transactional Email. +7. Click **Validate domain name** to confirm. - You need to configure your [SPF](/transactional-email/concepts/#spf-record), [DKIM](/transactional-email/concepts/#dkim-record) and [MX](/transactional-email/concepts/#mx-record) records to verify your domain and to be able to send emails. + You need to configure your [SPF](/transactional-email/concepts/#spf-record), [DKIM](/transactional-email/concepts/#dkim-record), [MX](/transactional-email/concepts/#mx-record), and [DMARC](/transactional-email/concepts/#dmarc-record) records to verify your external domain and to be able to send emails. - ## How to add SPF and DKIM records to your domain After you have configured your domain with Transactional Email, you are prompted to verify your domain by adding SPF, DKIM and MX records. You can choose to do so right after you have validated your domain, or at a later time. diff --git a/pages/transactional-email/reference-content/tem-dedicated-ip.mdx b/pages/transactional-email/reference-content/tem-dedicated-ip.mdx new file mode 100644 index 0000000000..08b2c618a0 --- /dev/null +++ b/pages/transactional-email/reference-content/tem-dedicated-ip.mdx @@ -0,0 +1,52 @@ +--- +meta: + title: Understanding managed dedicated IPs + description: Learn about the benefits of using a dedicated IP for email sending, how TEM-managed dedicated IPs work, and when to use them. +content: + h1: Understanding managed dedicated IPs + paragraph: Learn about the benefits of using a dedicated IP for email sending, how TEM-managed dedicated IPs work, and when to use them. +tags: dedicated ip email deliverability tem ip management +dates: + validation: 2024-03-10 + posted: 2024-03-10 +categories: + - transactional-email +--- + + + +The following dedicated IP management actions are included with the TEM Scale plan: +- **Automatic IP Warm-up** - Controlled progression of sending volumes to establish a good reputation. + + Refer to the [IP warm-up information](/transactional-email/concepts#ip-warm-up) to learn more about the warm-up process. + +- **Monitoring and alerting** - Real-time performance tracking and alerting in case of issues. +- **Corrective actions** - Proactive management in case of blacklisting or reputation decline. +- **Optimization of sends** - Automatic adjustments to maximize reception rates. + + + The Scaleway TEM team will intervene as much as possible to improve and maintain the domain's reputation score. However, since the TEM team does not own the domain, and has no control over traffic, they cannot commit to the complete resolution of incidents. + + +## When to use a dedicated IP? + +Dedicated IPs are useful for managing: + +- **High volumes** - If you regularly send a large volume of emails (more than 1000 emails per day), a dedicated IP helps stabilize and improve deliverability. +- **Reputation** - Dedicated IPs help you avoid being affected by the performance of other senders on a shared IP. +- **Sensitive sends** - Cases such as financial transactions, healthcare, public, defense, or critical communications where confidentiality or reputation are crucial. +- **Compliance and security** - Regulatory compliance and maintaining the security of your email sending infrastructure, including obtaining necessary certifications and whitelisting your email sending IPs. + +## When is a dedicated IP not necessary? + +A dedicated IP is not always beneficial and, in some cases, may even negatively impact deliverability: + +- **Low volumes** - If you send less than 10,000 emails per month, a dedicated IP may struggle to maintain a good reputation. +- **Irregular sends** - If your sending volumes are inconsistent, it can be difficult to stabilize the reputation of your IP. +- **Poor emailing practices** - A dedicated IP does not improve deliverability if you have poor emailing practices (high bounce rates, spam complaints, etc.). + +## Technical limitations + +- When you activate a dedicated IP on a project, all emails from the Project will be sent via this IP. +- It is not possible to use a shared and a dedicated IP on the same Project. This limitation is put in place to avoid routing and sending reputation inconsistencies. If you wish to use a shared IP for certain sends, you need to do so on a separate project. +- Only the TEM team can make advanced adjustments to the IP in the event of major incidents. \ No newline at end of file diff --git a/pages/transactional-email/reference-content/understanding-tem-reputation-score.mdx b/pages/transactional-email/reference-content/understanding-tem-reputation-score.mdx index c14d536281..678421dea0 100644 --- a/pages/transactional-email/reference-content/understanding-tem-reputation-score.mdx +++ b/pages/transactional-email/reference-content/understanding-tem-reputation-score.mdx @@ -61,7 +61,7 @@ Many factors might affect your domain's reputation. The most common are the foll - Spam traps: Your emails might be landing in [spam traps](/transactional-email/concepts/#spam-trap) which in turn, negatively impacts your reputation score. -## Emailing best practices to improve your domain reputation +## Best practices for domain reputation and deliverability For a good domain reputation, you need to implement the following emailing practices: