SuperAPI AI 工具集

twilio-email

办公与效率

查看项目

更新于 10-16 05:00

技能介绍

用途:让 OpenClaw 在生产环境中实现、运维和排查 SendGrid(Twilio)事务邮件,包括发送、模板、事件回调、抑制列表与送达率配置。

主要能力:通过 SendGrid v3 API 发送事务邮件,处理认证、重试、幂等与可观测性;使用 Dynamic Templates(Handlebars)并注意转义、条件与循环,支持模板版本与灰度;处理 Event Webhook(delivered/open/click/bounce/spamreport/dropped/deferred 等),要求 ECDSA 签名校验与重放保护;管理抑制列表(退信、封禁、垃圾举报、退订)并正确实现 list-unsubscribe;配置域名认证(SPF/DKIM/DMARC)、专用 IP 与 IP 预热。

使用方式:需 Twilio SendGrid 账号并启用 Mail Send,API Key 至少含 mail.send,按需 templates、suppression、eventwebhook 权限。推荐 Node @sendgrid/mail@8.1.3、Python sendgrid==6.11.0;Webhook 校验可用 @sendgrid/eventwebhook@8.1.0 或自行 ECDSA 验证。发送示例:pip install twilio sendgrid,设置 SENDGRID_API_KEY 后调用 /v3/mail/send。Webhook 需公网 HTTPS 端点,校验 X-Twilio-Email-Event-Webhook-Signature 与 Timestamp,按 sg_event_id 去重。

适用场景:密码重置、收据、告警等事务邮件管道,以及退信/投诉监控与送达率治理。

限制:SendGrid 的 /mail/send 不提供显式幂等头,需应用层用 outbox 表实现;4xx 不应盲目重试,429 与 5xx 才退避重试;模板中 {{{var}}} 未转义需谨慎;专用 IP 需逐步预热。资料未提供具体价格与完整 CLI 工具说明。