用途:该技能封装 ZeptoMail 事务性邮件 API,适用于注册欢迎、OTP 验证码、订单确认、发票、月度报告等触发式邮件场景,明确不用于营销或群发推广邮件。
主要能力:
- 发送基础 HTML 邮件;2) 发送纯文本邮件;3) 开启 track_clicks、track_opens 跟踪;4) 支持 cc、bcc、reply_to;5) 支持 Base64 附件与内联图片(cid 引用);6) 通过 template_key 与 merge_info 使用模板;7) 批量发送,最多 500 收件人,可带个性化 merge_info;8) 批量模板发送。
使用方式:基础地址为 https://api.zeptomail.com/v1.1。
- 普通邮件:curl -s "https://api.zeptomail.com/v1.1/email" -X POST --header "Authorization: Zoho-enczapikey $ZEPTOMAIL_TOKEN" --header "Content-Type: application/json" -d @/tmp/zeptomail_request.json
- 模板邮件:/email/template
- 批量:/email/batch
- 批量模板:/email/template/batch 请求体写入 /tmp/zeptomail_request.json,包含 from、to、subject、htmlbody 或 textbody 等字段。
排查:请求失败可运行 zero doctor check-connector --env-name ZEPTOMAIL_TOKEN 或 zero doctor check-connector --url https://api.zeptomail.com/v1.1/email --method POST。
限制:需先验证发件域名;邮件总大小(头+正文+附件)不超过 15 MB;批量单次最多 500 收件人;API 仅支持 TLS v1.2+;认证令牌为 Zoho-enczapikey。常见错误码:TM_101 认证失败、TM_102 参数无效、TM_103 域名未验证、TM_104 超限,EM_104 表示成功。具体计费与套餐暂未提供。