🏠 回到导航页 ← 返回Mailgun配置

📧 Mailgun 邮件发送指南

详细的Mailgun API使用说明，包含完整的邮件发送示例和最佳实践

📋 目录

1 概述

Mailgun是一个强大的邮件发送服务，提供可靠的邮件投递、跟踪和分析功能。本指南将帮助您快速掌握Mailgun API的使用方法。

注意： 使用Mailgun需要先注册账号并验证域名。建议使用独立域名以获得更高的送达率。

主要功能：

2 配置准备

开始使用前，您需要准备以下信息：

1. 获取API Key

  1. 登录 Mailgun控制台
  2. 进入 Settings → API Keys
  3. 复制 Private API Key（格式：d142579e51ac928981a75218a433365d-556e0aa9-08856502）

2. 配置域名

  1. 添加您的发送域名（如：mg.yourdomain.com）
  2. 配置DNS记录（TXT、MX、CNAME）
  3. 等待验证通过（通常需要几分钟）
提示： 在本平台中，进入 Mailgun配置页面，输入API Key和Domain，即可开始使用。
3 发送简单邮件

最基本的邮件发送示例。

POST https://api.mailgun.net/v3/YOUR_DOMAIN/messages 
curl -s --user 'api:YOUR_API_KEY' \
    https://api.mailgun.net/v3/YOUR_DOMAIN/messages \
    -F from='Support ' \
    -F to='user@example.com' \
    -F subject='Hello' \
    -F text='Testing some Mailgun awesomeness!'

参数说明：

参数 类型 必填 说明
from string 是 发件人地址（格式：Name <email@domain>）
to string 是 收件人地址（可多个，逗号分隔）
subject string 是 邮件主题
text string 否 纯文本内容
html string 否 HTML格式内容
成功响应： 
{
    "id": "<20111114174239.25659.5817@samples.mailgun.org>",
    "message": "Queued. Thank you."
}
4 批量发送邮件

向多个收件人发送邮件，支持最多1000个收件人。

curl -s --user 'api:YOUR_API_KEY' \
    https://api.mailgun.net/v3/YOUR_DOMAIN/messages \
    -F from='Marketing ' \
    -F to='user1@example.com,user2@example.com,user3@example.com' \
    -F subject='Summer Sale Announcement' \
    -F text='Check out our amazing deals!'
提示： 批量发送时，每个收件人会收到独立的邮件副本，其他收件人地址不会被泄露。
5 使用收件人变量

为每个收件人定制邮件内容，实现个性化批量发送。

curl -s --user 'api:YOUR_API_KEY' \
    https://api.mailgun.net/v3/YOUR_DOMAIN/messages \
    -F from='Support ' \
    -F to='user1@example.com,user2@example.com' \
    -F subject='Hello %recipient.name%' \
    -F text='Hi %recipient.name%, your code is %recipient.code%' \
    -F recipient-variables='{
        "user1@example.com": {"name": "Alice", "code": "A123"},
        "user2@example.com": {"name": "Bob", "code": "B456"}
    }'

变量使用规则：

实际效果： 
user1@example.com 收到：
主题：Hello Alice
内容：Hi Alice, your code is A123

user2@example.com 收到：
主题：Hello Bob
内容：Hi Bob, your code is B456
6 发送HTML邮件

发送富文本HTML格式的邮件，提升用户体验。

curl -s --user 'api:YOUR_API_KEY' \
    https://api.mailgun.net/v3/YOUR_DOMAIN/messages \
    -F from='Marketing ' \
    -F to='user@example.com' \
    -F subject='Welcome to Our Service' \
    -F text='Plain text version for email clients that dont support HTML' \
    -F html='<html>
        <body style="font-family: Arial, sans-serif;">
            <h1 style="color: #E94F37;">Welcome!</h1>
            <p>Thank you for joining our service.</p>
            <a href="https://example.com" style="background: #E94F37; color: white; padding: 10px 20px; text-decoration: none; border-radius: 5px;">Get Started</a>
        </body>
    </html>'
最佳实践： 同时提供text和html内容，确保所有邮件客户端都能正常显示。
7 添加附件

在邮件中添加文件附件。

curl -s --user 'api:YOUR_API_KEY' \
    https://api.mailgun.net/v3/YOUR_DOMAIN/messages \
    -F from='Support ' \
    -F to='user@example.com' \
    -F subject='Your Invoice' \
    -F text='Please find your invoice attached.' \
    -F attachment=@/path/to/invoice.pdf \
    -F attachment=@/path/to/receipt.pdf
限制： 附件总大小不能超过25MB。支持多个附件。
8 邮件追踪

启用邮件打开和点击追踪功能。

curl -s --user 'api:YOUR_API_KEY' \
    https://api.mailgun.net/v3/YOUR_DOMAIN/messages \
    -F from='Marketing ' \
    -F to='user@example.com' \
    -F subject='Product Update' \
    -F html='<html><body><a href="https://example.com">Check it out</a></body></html>' \
    -F o:tracking=yes \
    -F o:tracking-clicks=yes \
    -F o:tracking-opens=yes

追踪参数：

参数 说明
o:tracking 启用/禁用追踪（yes/no）
o:tracking-clicks 追踪链接点击（yes/no/htmlonly）
o:tracking-opens 追踪邮件打开（yes/no）
9 最佳实践

1. 提高送达率

2. 发送策略

3. 安全建议

10 常见问题

Q1: 邮件发送失败怎么办？

A: 请检查：

Q2: 为什么邮件进入垃圾箱？

A: 可能的原因：

Q3: 批量发送有什么限制？

A: 限制说明：

Q4: 如何测试邮件发送？

A: 建议步骤：

  1. 先发送到自己的邮箱测试
  2. 检查邮件在不同客户端的显示效果
  3. 测试垃圾邮件评分（使用mail-tester.com）
  4. 小批量测试后再大规模发送
技术支持： 如需更多帮助，请访问 Mailgun官方文档 或联系技术支持团队。