SuperAPI AI 工具集

twilio-email-send

办公与效率

查看项目

更新于 10-15 23:41

技能介绍

用途:在调用方持有 Twilio 凭据(Account SID + Auth Token,或 API Key SID + Secret)时,通过 comms.twilio.com/v1/Emails 发送邮件。注意 Twilio Email 与 SendGrid 是不同产品,API、凭据、模板语言和端点均不同;若持有 SG. 前缀的 SendGrid API key,应改用 twilio-sendgrid-email-send。

主要能力:使用 Basic Authentication 发送邮件;单次请求最多 10,000 个收件人;单封邮件(含附件)最大 10MB;支持 Liquid 模板({{variable}})在 subject、html、text 中做个性化;接口为异步,返回 202 Accepted 与 operationId、operationLocation,需轮询该地址跟踪投递状态。

使用方式:向 https://comms.twilio.com/v1/Emails 发送 POST 请求,JSON 包含 from(address、name)、to 数组(address、name,可带 variables)与 content(subject、html、text)。批量发送时在 to 数组中添加多个收件人;使用模板变量时,需为每个收件人在 variables 中提供所有被引用的键。示例命令:curl -X POST "https://comms.twilio.com/v1/Emails" --header "Content-Type: application/json" --data '{...}' -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN。

适用场景:需要以 Twilio 凭据批量发送事务性或通知类邮件,并做简单个性化与批量状态跟踪的场景。

限制:不能使用 SendGrid API key;单请求收件人上限 10,000;单封邮件含附件不超过 10MB;from 字段不支持 Unicode;不支持 Handlebars 模板(仅 Liquid);无法获得同步投递确认,202 仅表示已排队;所有 tags 合计长度不超过 10,000 字节。发送前须与用户确认收件人、主题和内容,邮件发出不可撤回,未经明确批准不得自主发送,尤其是批量发送。前置条件包括 Twilio 账户、与 from 地址域名匹配的已验证发件人身份,以及遵守 CAN-SPAM、GDPR 等地区反垃圾邮件法规。错误码包括 400、401、429、500、503,需按情况检查载荷、凭据或退避重试。