GetMyBot 知识库

内容工作台

一次准备消息,在群发或网站中复用;了解草稿、发布、变量和发送前检查。

本页内容

在内容中可准备一份消息并在多处使用,例如将同一版课程介绍发到 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 的方式不同。

修改邮件元素

在可视化编辑器选中元素,在属性面板修改文字、链接、图片或容器的可用属性。输入框失去焦点后才应用值。链接有目标地址和显示文字;图片替代文字向看不到图片的收件人描述它。

遇到问题时

  1. 禁止的变量替换:路径不在当前上下文的允许列表,或拼写有误。尽量从选择器插入。
  2. 缺失变量值:收件人没有允许字段的值,在文档设置添加备用值。
  3. 发布返回 409:别人修改了文档,刷新后再发布。
  4. 不能归档:启用的弹窗、运行中的群发或推送仍引用该文档。
  5. 测试发送不可用:连接渠道中尚无已确认且未被排除的联系人。

下一步