SMTP Email Delivery

VIDEO WALKTHROUGH

SMTP Email Delivery: setup guide

2:43

Recorded on version 1.0.3 · Narrated walkthrough · English captions

Jump to a chapter 8 chapters

1. 0:00Set up SMTP Email Delivery
2. 0:13Open settings and choose scope
3. 0:33Enable SMTP at the right scope
4. 0:53Configure an encrypted connection
5. 1:16Check sender and delivery settings
6. 1:37Send a deliberate test after setup
7. 1:59Save and verify your setup
8. 2:20Your setup checklist

Read the full video transcript

SMTP Email Delivery 1.0.3 — Magento Admin setup

00:00:00 — Set up SMTP Email Delivery
Welcome to the Agentic Ecom S M T P Email Delivery Admin guide. We'll walk through the main setup screens and the checks to make before using the module. This guide assumes the extension is already installed.

00:00:13 — Open settings and choose scope
Start in Magento Admin and open Stores, Configuration. Choose SMTP. Check the Scope selector before editing. Use the appropriate website or store view where the setting supports it. The screen values here are a demonstration; enter the settings and service details that belong to your own store.

00:00:33 — Enable SMTP at the right scope
Enable the module for the intended store scope. Prepare an SMTP account and an approved sender address from your own email provider. Provider charges and account requirements are separate from the extension. Keep credentials concealed when sharing screenshots or recordings of this screen.

00:00:53 — Configure an encrypted connection
Choose a provider preset or enter its host and port. Confirm the values with your provider. Select the required encryption and authentication method. STARTTLS requires successful TLS negotiation before sending credentials or message data. For Google or Microsoft OAuth, choose the supported OAuth authentication and enter your own application details.

00:01:16 — Check sender and delivery settings
Review the sender override, Return Path and any global copy recipients. Your provider must permit the sender addresses you use. Check Magento's contact email configuration as well. A copied recipient receives customer messages too, so use those settings deliberately and test them with disposable staging messages.

00:01:37 — Send a deliberate test after setup
When your account details are ready, enter Test Email Recipient and choose Send Test Email. That button sends a real message. Save OAuth credentials before testing OAuth. Check provider acceptance and inbox delivery separately; a successful application response or email log does not guarantee that the message reached the inbox.

00:01:59 — Save and verify your setup
When your required settings are complete, use the screen's Save control and wait for Magento's confirmation. Then reopen the record or configuration and check the saved values at the intended scope. If the storefront still shows earlier settings, refresh the relevant caches. Test your own configuration before using it with customers.

00:02:20 — Your setup checklist
That's the Admin setup walkthrough for S M T P Email Delivery. Check permissions and scope, review the module-specific settings, then save and verify a small staging example. Use the written guide at user guides dot Agentic Ecom dot net for installation details, complete field references and any separate storefront integration steps.

Download videoEnglish captionsDownload transcript

Current direct-store release: 1.0.4. SMTP Email Delivery routes Magento outbound email through a merchant-configured SMTP server when the module is enabled. It uses Symfony Mailer and supports provider presets or a custom host and port. Your SMTP account, approved sender and any provider charges are separate from the module.

Compatibility and installation

Version 1.0.3 was installed, upgraded and compiled on Magento Open Source 2.4.9 with PHP 8.5.10. Magento severity-10 coding checks and transport policy tests passed. Test your provider, PHP version and Magento edition in staging before production use.

Find your Composer licence key in My Licences, then run:

composer config repositories.agenticecom composer https://repo.agenticecom.net
composer config --global --auth http-basic.repo.agenticecom.net <YOUR-LICENCE-KEY> x
composer require agenticecom/module-smtp:^1.0.4
php bin/magento module:enable AgenticEcom_Smtp
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Configure SMTP

1. Open Stores → Configuration → AgenticEcom · System → SMTP for the intended store scope. Set Enable to Yes.
2. Choose Quick Setup — Select Provider or enter the SMTP host and port. Provider presets fill starting values; confirm the current requirements with your provider.
3. Choose SSL, STARTTLS or None, then the provider’s authentication method: None, LOGIN, PLAIN, CRAM-MD5 or XOAUTH2. STARTTLS mode requires a successful TLS negotiation before credentials or message data are sent. Prefer encryption when using credentials.
4. Enter the mailbox username and password. For Google or Microsoft OAuth 2.0, select XOAUTH2 and provide your own provider application credentials and refresh token in the OAuth fields. Save those credentials before testing OAuth.
5. Set a valid sender address using the sender override, or configure Magento’s General Contact email. Optionally set Return-Path, global CC/BCC and a plain-text alternative. Your provider must allow the sender and Return-Path addresses.
6. Under Test Connection, enter Test Email Recipient and click Send Test Email. This sends a real email. For password authentication, the button can test credentials typed in the form before saving; for OAuth, save first. Check provider acceptance and inbox delivery separately.

Secrets and delivery

The SMTP password, OAuth client secret and refresh token use Magento’s encrypted configuration backend. Successful application sending or logging does not guarantee inbox delivery.

Logging and resend

Enable Email Logging if you need the Admin log at System → SMTP → Email Log. Logs may contain names, addresses, subjects and message bodies. Restrict Admin access and set the retention period appropriate for your store.

The log records application send status and supports a sandboxed message preview. Single and mass resend reconstruct a text-only message from the saved record. They do not recreate the original HTML, attachments, CC/BCC or exact MIME structure. Check a reconstructed message before resending it to a customer.

Staging delivery control

Disable Actual Delivery (Dev Mode) blocks ordinary module delivery unless every To, CC and BCC address, including global CC/BCC, appears in the exceptional email or domain allowlist. A message with mixed allowed and disallowed recipients is blocked as a whole and can be logged. Admin resend is blocked in this mode. The explicit Send Test Email action still sends a real message, so enter a safe recipient when testing staging.

Release notes

1.0.4 — direct-store release: Groups SMTP configuration under AgenticEcom · System. The SMTP transport implementation is unchanged from 1.0.3. The recorded walkthrough and runtime checks above use 1.0.3.

1.0.3: Removes the final modifier from the SMTP transport builder to satisfy Adobe’s Magento coding review. SMTP behavior is unchanged from 1.0.2.

1.0.2: STARTTLS and the selected authenticator are enforced; XOAUTH2 works on Admin resends. Developer-mode checks all To/CC/BCC recipients. Return-Path sets the SMTP envelope sender. The Admin test uses the selected store scope and a valid sender. Log previews are isolated.

For support and purchase terms, see SMTP Email Delivery and the AgenticEcom licence.