SuperAPI AI 工具集

twilio-sendgrid-account-setup

编程与开发

查看项目

更新于 10-16 08:02

技能介绍

用途:为邮件发送配置 SendGrid 账户。SendGrid 使用独立的认证体系,其 API Key 以 SG. 开头,不能用 Twilio 的 Account SID/Auth Token,也没有 Twilio MCP 工具封装 SendGrid。

主要能力与用法:

  1. API Key:在 SendGrid 控制台 Settings > API Keys 获取,设置环境变量 export SENDGRID_API_KEY=SG.xxx。按需安装 SDK:pip install sendgrid、npm install @sendgrid/mail、gem install sendgrid-ruby、composer require sendgrid/sendgrid、go get github.com/sendgrid/sendgrid-go 等。
  2. Key 权限:Full Access 仅用于开发;生产用 Restricted Access 并限制到 Mail Send 等实际所需范围。仅 Mail Send 的 Key 无法读取退订、管理模板或访问统计,403 时检查权限。
  3. SMTP 中继:服务器 smtp.sendgrid.net,端口 587(TLS) 或 465(SSL),用户名固定为字面量 apikey,密码为 SG. 开头的 API Key。
  4. 域名认证:生产必需。控制台 Settings > Sender Authentication > Authenticate Your Domain,配置 3 条 CNAME(s1/s2._domainkey 用于 DKIM,em 记录用于回信地址);可通过 GET /v3/whitelabel/domains/{id}/validate 校验。DKIM/SPF 之后配置 DMARC 记录,建议先 p=none 监控。专用 IP 属 Pro+ 方案,需 30 天渐进式预热。服务器可选全球 https://api.sendgrid.com 或欧盟 https://api.eu.sendgrid.com。

限制与安全:Single Sender Verification 仅用于测试,改发件地址需重新验证;域名认证需要 DNS 修改权限;域名查询 API 可能返回过期条目,需按 valid: true 过滤;API Key 仅在创建时显示一次,应立即保存到密钥管理器(如 AWS Secrets Manager、Vault),不要写入提交到版本库的代码或环境文件;绝不在回复中展示、记录或重复用户的 API Key,若用户已在对话中暴露应建议立即轮换。相关后续主题:邮件发送、域名设置与模板、投递跟踪。