Mailster SparkPost Integration
| 开发者 | everpress |
|---|---|
| 更新时间 | 2026年10月15日 19:10 |
详情介绍:
This plugin requires Mailster 4.0 or newer and a SparkPost account with a Master API key and a verified sending domain. When SparkPost is the active delivery method, outgoing email content and delivery metadata are sent to SparkPost (US or EU API, depending on your endpoint setting).Why send Mailster newsletters with SparkPost?
- SparkPost delivery for Mailster — Registers SparkPost as a delivery method under Newsletter → Settings → Delivery.
- WEB API or SMTP API — Send via the SparkPost Transmissions (WEB) API (recommended), or use SparkPost SMTP with TLS on port 587 or 2525.
- US or EU endpoint — Choose the default SparkPost API/SMTP hosts or the EU endpoint (
api.eu.sparkpost.com/smtp.eu.sparkpostmail.com). - API key verification — Verifies your Master API key against the SparkPost account and can sync Mailster’s send limit from SparkPost usage.
- Sending domains and subaccounts — Lists verified sending domains and optional SparkPost subaccounts from your account.
- Open and click tracking in SparkPost — Optionally enable SparkPost open/click tracking (account defaults, none, opens, clicks, or both).
- IP pool and tags — Set a dedicated IP pool ID and comma-separated tags attached to each transmission.
- Bounce and complaint sync — Reads SparkPost message events and applies bounces, complaints, and unsubscribes in Mailster (SparkPost handles soft delays).
- Install and activate Mailster SparkPost Integration alongside Mailster 4.0+.
- Create a SparkPost account, verify your sending domain (DNS), and create a Master API key with permissions for Account, Message Events, Sending Domains, Subaccounts, Transmissions, and (if using SMTP) Send via SMTP.
- Open Newsletter → Settings → Delivery, select the SparkPost tab, enter your API key, choose the endpoint if needed, and save.
- Select WEB API or SMTP, configure tracking, IP pool, and tags if desired, then send a test email from a verified From domain.
- Run your Mailster campaigns through SparkPost.
安装:
- Upload the entire
mailster-sparkpostfolder to the/wp-content/plugins/directory, or install from the WordPress plugins screen. - Activate the plugin through the Plugins menu in WordPress.
- Make sure Mailster 4.0 or newer is installed and active.
- In SparkPost, verify your sending domain and create a Master API key with the permissions described in the setup guide.
- Go to Settings → Newsletter → Delivery, open the SparkPost tab, enter your API key, choose Default or EU endpoint, and save.
- Choose WEB API (recommended) or SMTP API, configure optional tracking / IP pool / tags, and send a test email using a verified From address.
常见问题:
Does this plugin work without Mailster?
No. This is a delivery addon for the Mailster Newsletter Plugin and requires Mailster 4.0 or newer.
Do I need a SparkPost account?
Yes. You need a SparkPost account, a verified sending domain (or verified From address), and a Master API key. SparkPost is a paid email delivery service; see SparkPost for current plans.
What is the difference between WEB API and SMTP?
WEB API (recommended) sends through SparkPost’s Transmissions API and usually returns clearer errors. SMTP API relays via smtp.sparkpostmail.com (or the EU host) on port 587 or 2525 with TLS. Both are available in the SparkPost delivery settings.
Why Master API key?
Mailster needs Account read access (and related permissions) to verify the key, list sending domains and subaccounts, read message events for bounces, and send transmissions. A restricted key without those permissions will not work fully.
Can I use SparkPost EU?
Yes. Choose the EU endpoint in the SparkPost delivery settings to use the EU API and SMTP hosts.
How are bounces handled?
When SparkPost is the active delivery method, bounce handling is driven by SparkPost message events synced into Mailster. Mailster’s own bounce mailbox settings are ignored for this delivery method.
Is email data sent to a third party?
Yes. When this delivery method is active, Mailster sends email content and related delivery metadata to SparkPost so messages can be delivered. Bounce and engagement events are read back from SparkPost’s APIs.
Where can I get support?
For Mailster and this addon, see mailster.co and the SparkPost setup guide. For SparkPost account, billing, and API questions, use SparkPost documentation.
更新日志:
- fixed: missing $status argument in bounce checking
- fixed: waringin on PHP >8.1
- Update for Mailster 3.0
- fixed: issue with invalid data type with WP 5.5
- fixed: subaccounts were not displayed on the settings screen
- fixed: using correct host for EU endpoint
- updated: applied SparkPost API endpoint changes
- fixed: issue with Mailster 2.3.16+ and reply_to headers
- endpoint selection is now available without API key
- added option to choose EU endpoint
- added: option to define IP_POOL
- fixed: issue if embedded images is used multiple times
- fixed: issue when campaign titles have more than 64 characters
- fixed "Track in SparkPost" option now working as expected
- initial release