用途:该技能通过 SendGrid API 发送税务报告、合规截止提醒和组织邀请,并处理模板渲染、附件管理、投递状态跟踪及退信/投诉监控。
主要能力:支持四类邮件模板——会计师报告投递(含 PDF/Excel 附件与 TASA 2009 免责声明)、合规提醒(含严重级别与截止日期)、组织邀请(含签名令牌,链接 7 天过期)、分析完成通知。附件支持 PDF(20MB)、Excel(20MB)、CSV(10MB),单封邮件总计不超过 30MB。跟踪 delivered、bounce、dropped、spam_report、open、click 等事件。
使用方式:需配置环境变量 SENDGRID_API_KEY(SG.xxx 格式)与 NEXT_PUBLIC_APP_URL。调用 POST https://api.sendgrid.com/v3/mail/send,请求头为 Authorization: Bearer $SENDGRID_API_KEY 与 Content-Type: application/json。发件地址须在 SendGrid 中验证,建议使用 noreply@ 或 reports@ 地址。输出为 email_delivery_result 结构,含 message_id、template、to、subject、status、sent_at、attachments 与 includes_disclaimer。
适用场景:向会计师发送报告、向实体联系人发送合规提醒、向团队成员发送组织邀请、通知用户分析完成、分发共享报告链接、发送修正期到期警告。
限制:附件不得包含原始 Xero OAuth 令牌、TFN 或敏感个人信息;PDF 须含 TASA 2009 免责声明,Excel 须含“ESTIMATE ONLY”表头。不得发送未经许可的邮件,非事务性邮件须含退订链接。退信地址须立即移除。建议使用签名 URL 并先在沙箱模式测试。免费版每日 100 封,本应用预期量低于 50 封/天。