SuperAPI AI 工具集

template-builder-ui

办公与效率

查看项目

更新于 10-16 09:56

技能介绍

用途:设计并审计 Sent 面向租户的模板构建器界面,包括模板编辑器表单、变量插入、预览、校验、生命周期体验与 API 载荷映射。

主要能力:以 Sent v3 定义契约为规范保存与提交模型,不直接使用 Meta 的 components[] 载荷。产品模型为单个草稿对象:可选 category 与 language;必填 definition.body.multiChannel;可选的 sms、whatsapp、rcs 完整 body 覆盖;可选的 definition.header、footer、buttons、definitionVersion、authenticationConfig;提交项 creation_source、submit_for_review、sandbox。不暴露顶层 name、channels、body、header、buttons 等创建字段。

推荐编辑顺序:捕获意图与类别,写 multiChannel 正文,以结构化实体插入变量,添加可选分渠道覆盖、header/footer/buttons,审查实时预览与可访问性,本地校验并配合 sandbox: true,先存草稿再显式提交审核。类别不阻塞首次输入,但提交前必须可见,因其影响认证规则与 WhatsApp 策略审核。

变量 UX:插入变量同时生成占位符(如 {{0:variable}})与带 id、name、type、props.sample 的匹配实体;变量移动时原子重编号;禁止独立编辑占位符语法与实体表;对裸 {{1}} 或无定义 ID 显示明确错误。

校验矩阵:按 references/template-validation-matrix.md 执行,如正文上限 1,024 字符、header/footer 60 字符、footer 无变量、按钮共 10 个及按类型限制、authenticationConfig 限制、渠道覆盖需完整独立有效。对序列化 JSON 运行 waba-template-author 检查器,服务端校验仍为权威。

渠道预览:SMS 展示纯文本与 GSM/UCS-2 分段估算,说明分段估算影响计费而非模板正文上限;WhatsApp 预览 header/body/footer/buttons,展示样例值、类别、语言与审核影响;RCS 目前支持文本加最多四个建议块,富卡片、轮播与媒体附件为路线图能力,不应生成不可用功能声明。渠道路由属发送流程而非模板编辑器;省略 channel 或 ["sent"] 表示自动路由与回退,["rcs"] 固定 RCS 且无跨渠道回退,多个显式值表示广播并分别计费,不可将 RCS+SMS 数组描述为有序回退。

保存与审核:使用 sandbox: true 校验,submit_for_review: false 保存;改为 true 前展示类别与语言、含样例值的渲染预览、渠道覆盖、按钮动作、警告及供应商审核属外部状态变更,不要保存时自动提交。

生命周期:状态含 DRAFT、PENDING、APPROVED、REJECTED、PAUSED,保留未知状态渲染;WhatsApp 模板 webhook 事件字段为 "templates",状态在 payload.status,可能包括 CATEGORY_UPDATED、DISABLED 等未来值,详见 references/template-status-handling.md。

可访问性与失败恢复:每个错误关联字段与摘要,不单靠预览颜色,校验失败保留用户编辑,为高级用户保留原始 JSON 查看,导入的 Meta JSON 在转换前标记为“Meta Cloud API source”,为服务端规范化与供应商驱动的类别/状态变化提供 diff。状态转换见 references/template-ui-wireflows.md,文案与策略判断用 waba-template-author,已有资源操作用 sent-templates,RCS 上线准备用 rcs-agent-onboarding。