SuperAPI AI 工具集

designing-email-templates

设计与创作

查看项目

更新于 10-16 03:45

技能介绍

用途:在 PostHog workflows 中创建或编辑邮件模板,供广播活动和 function_email 工作流动作渲染发送。

主要能力:以设计 JSON(content.email.design)撰写模板,用 workflows-create-email-template 保存,服务端用与可视化编辑器相同的渲染器生成邮件,模板可被人工以可编辑块打开。支持 Liquid 模板({{ }}、{% %}),可用于正文、主题和链接;营销邮件需含退订链接,使用 {{ unsubscribe_url }},另有 {{ unsubscribe_url_one_click }}。所有链接默认经点击追踪重定向,会破坏移动端通用链接/深链,可在 <a> 标签上加 clicktracking="off" 或 data-ph-no-track 关闭(标记须在 a 标签本身)。图片先用 media-images-list(purpose="email")复用,新增图片走预签名上传:media-image-upload-start 获取 id、upload_url、form_fields,再用 curl -X POST <upload_url> -F key=value... -F file=@/path/to/image.png 上传,最后 media-image-upload-complete 获取永久 url,填入 image 块 values.src.url;图片须小于 4MB 且为 PNG、JPEG、GIF、WebP、AVIF 或 BMP。

使用方式:创建时提供 name、description、type、content(templating 为 liquid,email 含 subject、design、text),subject 必填,始终撰写 design 并省略 html,text 须为真实纯文本。创建或更新后调用 workflows-show-email-template 预览。编辑采用读-改-写:workflows-get-email-template 取最新,修改后 workflows-update-email-template 整体替换 content;小改动可用 workflows-patch-email-template 按 id 操作。工作流步骤内邮件用 workflows-patch-action-email 编辑,活动工作流会暂存草稿,用 workflows-test-run(use_draft=true)测试后 workflows-publish 发布。模板通过 workflows-list-email-templates 列出,用 UUID 在 config.template_uuid 引用;步骤保存时快照模板正文,之后改库模板不影响已用步骤。模板可通过 workflows-update-email-template 设 deleted: true 软删除。

限制:设计 JSON 的 schema 与示例见 references/unlayer-design-json.md,撰写前应读 references/design-guidelines.md;块编辑器无法表达的片段可用 html 类型内容块。工具调用被拒为格式错误时,修正 JSON 转义后原样重发,不要改写内容。资料未提供具体收费、价格或平台支持范围。