内容工作台
一次准备消息,在群发或网站中复用;了解草稿、发布、变量和发送前检查。
本页内容
在内容中可准备一份消息并在多处使用,例如将同一版课程介绍发到 Telegram 和 VK。文字、图片和按钮合称一份内容文档;邮件、弹窗、推送通知则使用相应类型的文档。
先准备草稿,按目标渠道预览,再发布版本。消息类型可用于多个即时通讯渠道和网页聊天,但各渠道的呈现和校验要分别检查。编辑所需的机器人权限与编辑反应相同;没有权限时文档只读,不能创建、修改、发布、归档或发送测试。
文档、草稿和版本
文档类型决定用途:消息、Email、弹窗、应用内、Push 通知、快捷回复、线索机器人。Push 类型可用于群发或活动中的浏览器与移动推送。
每份文档始终只有一份可编辑草稿,但可有任意多份已发布版本:
- 编辑只改变当前草稿。
- 发布把草稿固定为不可变版本,同时用相同内容打开下一份草稿。
- 已发布版本不会被覆盖。已安排的群发或运行中的弹窗始终引用固定的版本。
例如群发引用版本 2,修改草稿并发布版本 3 不会改变它。要用新文案,应在群发或弹窗设置中另选新版。保存有并发保护:界面提交读取时的版本和修订号,若别人已修改,服务器返回 409;刷新后重试。
归档从列表移除文档。如果启用中的弹窗、已安排/发送中/暂停的邮件群发,或已接收/发送中的推送群发仍引用它,就不能归档。先取消这些引用。
内容块与限制
文档由内容块组成:
- 文字、标题、列表、分隔线:可选格式的文字。
- 图片、文件、视频:媒体库文件或 URL,加说明文字。
- 按钮:链接或点击时携带动作数据(
callback)的文字。 - 列:最多四个子块的组合。编辑器用它分组,发送时子块依次输出;不支持列的渠道会给出
columns_flattened警告。 - 条件内容:满足条件才显示的组合。
服务器在保存及发布时都会检查:
- 文档名称 1–120 字符。
- 至少一块,最多 200 块。
- 嵌套不超过 8 层。
- 同一层最多 10 个按钮。
- 列最多 4 个子块。
- 每块有唯一 ID。
两次检查还会确认所有媒体属于当前机器人。浏览器漏掉的问题,服务器仍会拒绝。
变量替换
发送时展开双花括号变量,例如:
你好,{{profile.first_name}}!订单 {{event.order_id}} 已在路上。
只允许四种形式:
{{profile.<字段>}}:收件人资料字段。{{event.<字段>}}:当前事件字段。{{system.unsubscribe_url}}:此收件人的退订链接。{{system.current_date}}:YYYY-MM-DD格式的当前日期。
其他形式都被拒绝。内容不能运行 JavaScript、SQL、模板程序或 HTTP 请求。
并非客户的所有字段都能自动用于文档,只能使用当前发送位置提供的 profile 和 event 字段。这称为允许字段列表;即使数据库里有某值,不在列表中的字段仍会报“禁止的变量替换”。
已允许但缺失的值若无备用值也会报错。备用值在文档设置的 fallbacks 中,键用完整路径:
{ "fallbacks": { "profile.first_name": "朋友" } }
只有允许列表中的路径可设置备用值,每值最长 16,000 字符。转义按插入位置自动处理:HTML 格式文字会进行 HTML 转义,URL 中会进行百分号编码;URL 中的 system.* 是现成链接,不再二次编码。
条件内容块
任何块都可附条件,条件内容块可让多个子块共用一个条件。内容中的条件比受众分组条件更窄,因为渲染时只有资料和当前事件:
- 主体只能是
profile或event。 - 运算符:
eq、ne、gt、lt、ge、le、gte、lte、exists、not_exists、contains、not_contains、in、not_in、between、before、after、has_any、not_has_any。 - 不支持“过去 N 天”等时间窗口条件。
渲染时拿不到所需数据会标记 condition_unsupported;条件本身无效标记 condition_invalid。旧版已发布内容在发送前也执行同样检查,因此不支持的条件会作为检查错误出现,而不是送达故障。
按渠道检查与预览
检查按渠道真实能力渲染所选版本,返回错误和警告两份列表。
错误阻止发布和发送:
text_too_long:文字超过渠道限制。media_missing:图片、文件或视频块既无文件也无 URL。media_unsupported:渠道不支持该附件类型。button_unsupported:渠道没有内联按钮,也没有可转为普通链接的地址。invalid_document:违反上述结构限制。condition_invalid、condition_unsupported。
警告不阻止发送,但说明内容将如何简化:
columns_flattened:渠道不支持列,子块依次发送。format_flattened:格式不受支持,改发纯文字。button_as_link:按钮变成普通链接。missing_image_alt:图片缺少替代文字。vague_link_text:按钮文字为空,或为 “click here”“here”“link”“more”。
预览按所选网站、Email、Telegram、VK 或 WhatsApp 渠道展示电脑和手机效果。选择真实收件人可代入其数据,提前发现变量错误。同一文档可能在一个渠道通过、另一个渠道被拒绝。例如 Email 保留列和 HTML、支持图片与文件但不支持视频,按钮会转为链接(button_as_link)。
测试发送
测试发送使用与正式发送相同的校验、渲染及队列流程,但只发给一位收件人。不能填写任意地址或 chat ID,只能从机器人已可送达的联系人中选择。
以下情况会拒绝测试:
- 联系方式未确认(
422)。 - 已被排除,例如退订或地址不可送达(
409)。 - 文档在加载后被更改(
409)。 - 当前部署不可用该渠道(
422)。 - 内容无法按该渠道渲染(
422)。 - 渠道额度耗尽(
409)。 - 短时间发送过多测试(
429):按账户计算,连续三次后每 15 秒最多一次。
成功时返回 202 并入队,随后由正式送达机制发送。
模板
模板提供起点。选择模板会将其内容块复制到新草稿,不建立持续关联,因此以后修改模板不会影响已有文档。
图库显示部署自带模板和该机器人的模板;没有时为空。尚无“保存为模板”按钮,机器人的模板通过 API POST /api/bots/{botID}/content-templates 创建和删除。
主题、尺寸与间距
文档主题设定通用字体和颜色;选中块的样式可在属性面板单独修改。内边距分隔内容与边框,外边距分隔相邻块;均以像素计。块宽度的百分比相对于内容区域。
行高以倍数表示:1.5 是一倍半行距。检查桌面和手机预览中的换行。支持的设置因渠道而异;检查会提示样式简化或列依次发送。
邮件原始 HTML
邮件可以在可视化与 HTML 模式间切换。修改源代码后等待校验;有错时先修正 HTML,再切换回可视化模式或保存。
导入时不支持的元素可能被改动。查看结果,并在收件人使用的邮件客户端测试,因为各客户端呈现 HTML 的方式不同。
修改邮件元素
在可视化编辑器选中元素,在属性面板修改文字、链接、图片或容器的可用属性。输入框失去焦点后才应用值。链接有目标地址和显示文字;图片替代文字向看不到图片的收件人描述它。
遇到问题时
- 禁止的变量替换:路径不在当前上下文的允许列表,或拼写有误。尽量从选择器插入。
- 缺失变量值:收件人没有允许字段的值,在文档设置添加备用值。
- 发布返回
409:别人修改了文档,刷新后再发布。 - 不能归档:启用的弹窗、运行中的群发或推送仍引用该文档。
- 测试发送不可用:连接渠道中尚无已确认且未被排除的联系人。