
通过为每位收件人生成唯一令牌并结合 sendgrid 的 personalizations 功能,可实现对 to/cc 收件人点击行为的精确追踪,避免共享链接导致的身份混淆。
通过为每位收件人生成唯一令牌并结合 sendgrid 的 personalizations 功能,可实现对 to/cc 收件人点击行为的精确追踪,避免共享链接导致的身份混淆。
在批量发送含确认按钮的邮件时(如“Verify”链接),若所有收件人(包括 To 和 CC)共用同一个 URL 与 Token(如 ?myToken=abc123),则服务器无法区分是哪位用户实际触发了点击——这不仅削弱业务逻辑准确性,更可能引发权限误判或数据归属错误。
根本解决方案是:为每位收件人动态生成独立、不可预测且可验证的唯一链接。SendGrid 的 Personalizations 机制正是为此设计:它允许你为每个收件人单独定义替换变量(如 %token-url%)、自定义头信息(Subject)、收件人名称,并确保每封邮件内容完全隔离——即使多人同属一次 API 调用,也不会暴露彼此邮箱,也不依赖传统 CC 字段(因其本质仍是共享内容)。
以下是推荐的实践方式:
✅ 核心步骤
- 为每位收件人(To 或拟“逻辑 CC”用户)生成专属 JWT 或随机 token(建议含用户 ID、时间戳、签名);
- 构建唯一验证 URL(如
https://yoursite.com/mailVerify.php?token=eyJhbGciOiJIUzI1Ni...); - 使用
SendGrid\Mail\To实例数组 +Personalization变量,将该 URL 注入 HTML 模板; - 在接收端(
mailVerify.php)解析 token 并验证签名,从而 100% 确认点击者身份。
? 示例代码(优化版,含安全建议):
use SendGrid\Mail\From;
use SendGrid\Mail\HtmlContent;
use SendGrid\Mail\Mail;
use SendGrid\Mail\To;
// ✅ 安全令牌生成(示例使用 HMAC-SHA256,生产环境建议 JWT)
function generateUniqueToken(string $email, string $secret): string {
$payload = base64_encode(json_encode(['email' => $email, 'ts' => time()]));
$signature = hash_hmac('sha256', $payload, $secret);
return urlencode("{$payload}.{$signature}");
}
$secretKey = $_ENV['TOKEN_SIGNING_SECRET'] ?? 'your-secure-secret';
$recipients = [
['email' => 'to@example.com', 'name' => 'Primary User'],
['email' => 'cc1@example.com', 'name' => 'CC User One'],
['email' => 'cc2@example.com', 'name' => 'CC User Two'],
];
$tos = [];
foreach ($recipients as $r) {
$token = generateUniqueToken($r['email'], $secretKey);
$verifyUrl = "https://yoursite.com/mailVerify.php?token={$token}";
$tos[] = new To(
$r['email'],
$r['name'],
[
'-full-name-' => $r['name'],
'%verify-link%' => $verifyUrl,
],
"Please confirm your action, {$r['name']}!"
);
}
$htmlBody =
<title>Confirmation</title><h2>Hello -full-name-,</h2>
<p>Please verify your acknowledgment:</p>
<a href="%verify-link%" class="button" style="
display:inline-block; padding:12px 24px;
background:#007bff; color:white; text-decoration:none;
border-radius:4px;">Confirm Now</a>
HTML;
$email = new Mail(
new From('noreply@yoursite.com', 'Your App'),
$tos,
new \SendGrid\Mail\Subject('Action Required'),
htmlContent: new HtmlContent($htmlBody)
);
$sendgrid = new \SendGrid($_ENV['SENDGRID_API_KEY']);
$response = $sendgrid->send($email);
⚠️ 关键注意事项
- ❌ 不要复用同一 token 给多个用户(即使加了 CC);
- ✅ 始终在服务端验证 token 签名与时效性(如限制 24 小时有效期);
- ✅ 验证回调接口(
mailVerify.php)需校验 HTTP Referer 或添加 CSRF token(可选增强); - ✅ 生产环境 URL 必须使用 HTTPS,本地
localhost:3000仅用于开发测试; - ✅ SendGrid 的 Personalizations 天然支持最多 1000 个收件人/请求,无需拆分调用。
总结:与其试图从共享链接中“反向识别”点击者,不如从源头为每人投递专属信封。Personalizations 不仅解决身份溯源问题,还提升用户体验(个性化问候、精准跳转)与系统安全性(防 token 滥用、防重放)。









