Mailster SendGrid Integration
| 开发者 | everpress |
|---|---|
| 更新时间 | 2026年10月15日 19:38 |
详情介绍:
This plugin requires Mailster 4.0 or newer and a SendGrid account with an API key. When SendGrid is the active delivery method, outgoing email content and delivery metadata are sent to SendGrid at api.sendgrid.com.
Why send Mailster newsletters with SendGrid?
- SendGrid delivery for Mailster — Registers SendGrid as a delivery method under Newsletter → Settings → Delivery.
- Web API or SMTP — Send with the SendGrid Mail Send API v3 (recommended), or relay through
smtp.sendgrid.netusing the usernameapikey. Secure SMTP uses port 465; otherwise the plugin uses port 587. - API key check — Verifies the key against the SendGrid scopes endpoint and shows whether it is accepted.
- Categories — On the Web API, attach up to 10 SendGrid categories so you can group sends in SendGrid.
- Reply-to, attachments, and inline images — The Web API sends reply-to, file attachments, and inline images with the message.
- Campaign metadata — The Web API includes Mailster campaign, subscriber, and message IDs as SendGrid custom arguments, and forwards Mailster headers.
- Bounce and suppression sync — Reads SendGrid bounces, blocks, spam reports, and unsubscribes and applies them in Mailster.
- Install and activate Mailster SendGrid Integration alongside Mailster 4.0+.
- Create a SendGrid API key with Mail Send access and Suppressions read access, and authenticate the sender or domain in SendGrid.
- Open Newsletter → Settings → Delivery, select the SendGrid tab, paste the API key, and save.
- Choose WEB API or SMTP API. For SMTP, turn on the secure connection if you need port 465.
- Send a test email from a verified From address, then run your Mailster campaigns through SendGrid.
安装:
- Upload the entire
mailster-sendgridfolder to the/wp-content/plugins/directory, or install it 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 SendGrid, create an API key with Mail Send access and Suppressions read access, and complete sender or domain authentication. See the setup guide.
- Go to Settings → Newsletter → Delivery, open the SendGrid tab, enter the API key, and save.
- Choose WEB API (recommended) or SMTP API, add optional categories, and send a test email.
常见问题:
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 SendGrid account?
Yes. You need a SendGrid account, an API key, and a verified sender or authenticated domain. SendGrid is a separate email delivery service; see SendGrid for current plans. This plugin is not a SendGrid product.
What is the difference between WEB API and SMTP?
WEB API (recommended) sends with POST https://api.sendgrid.com/v3/mail/send and supports categories, reply-to, attachments, and inline images. SMTP API relays through smtp.sendgrid.net with username apikey and your API key as the password. Use port 465 when “secure connection” is enabled, or port 587 when it is not.
Which API key permissions are required?
Mailster’s setup guide asks for Mail Send access so messages can be sent, and Suppressions read access so bounces, blocks, spam reports, and unsubscribes can be imported. The plugin checks the key with SendGrid’s scopes endpoint.
How are bounces handled?
Choose SendGrid (recommended) to import suppressions into Mailster. With the Web API, Mailster cannot process bounces itself, so bounce handling is set to SendGrid. With SMTP you can choose Mailster’s bounce mailbox instead, but SendGrid must have preserve headers enabled or the return path is overwritten. When SendGrid handles bounces, the settings on Mailster’s bounce tab are ignored. Details: How to handle bounces with SendGrid.
What are categories?
On the Web API you can enter up to 10 comma-separated SendGrid categories. SendGrid uses categories to group messages. They are not a substitute for Mailster lists.
Is email data sent to a third party?
Yes. When this delivery method is active, Mailster sends email content and related delivery metadata to SendGrid so messages can be delivered. Suppression data is read back from SendGrid’s API.
Where can I get support?
For Mailster and this addon, see mailster.co and the SendGrid setup guide. For SendGrid account, billing, and API questions, use SendGrid’s Mail Send documentation.
更新日志:
- fixed: API key status messages using the SparkPost translation domain
- fixed: warning on PHP >8.1
- fixed: issue with invalid data type with WP 5.5
- fixed: issue with Mailster 2.3.16+ and reply_to headers
- fixed: undefined reply_to email address
- switch to SendGrid API v3 requires now an API Key
- embedded images works now with the WEB API
- several improvements
- fixed: issue with slashes in content when using the WEB API
- initial release