GetMyBot 知识库

消息与按钮

用文字、图片、消息下方的按钮和可保存回答的问题,组成机器人的回复。

本页内容

要让机器人发送文字、图片和“选择”按钮,请添加发送消息动作。回复由多个内容块组成,例如先发商品图片,再发带按钮的说明。消息下方的按钮也叫消息内按钮(inline 按钮)。同一个动作还可以提问、等待回答,并把电话号码等回答存入客户资料。

消息内容块

点击添加内容块并选择内容。可以组合文字问候、照片和课程文件。

  • 文本:最多 4096 个字符的格式化文本,可用替换内容和按钮。
  • 照片:带说明文字的图片。
  • 文件:带说明文字的文档。
  • 语音消息:OGG/OPUS、MP3 或 M4A 音频,最大 50 MB;Telegram 通过 sendVoice 显示为语音消息。
  • GIF:动画或无声 MP4,最大 50 MB(sendAnimation)。
  • 圆形视频:最长 60 秒的方形 MP4(sendVideoNote),不支持说明文字。从媒体库发送时每次都要重新上传:Telegram 的 sendVoice、sendAnimation 和 sendVideoNote 不接受通过其他方式取得的 file_id。
  • 轮播:2 至 10 张卡片,每张包含“照片 + 说明 + 自己的按钮”。在 Telegram 中,若每张照片都有可用的 file_id(卡片中指定,或从媒体库文件取得),用户可在同一消息里通过“‹ ›”切换(editMessageMedia)。只要一张照片无法取得此 ID,所有卡片就会作为独立照片消息发送。VK 等其他渠道也是分别发送;每张卡片的说明和按钮都会保留。
  • 延迟:发送下一块之前等待指定秒数。
  • AI:根据提示词生成回答。
  • 反应:调用另一反应,可选择等待其完成。

语音、GIF、圆形视频和轮播也可用于快速群发反应。内容块可拖动排序;显示模式可选按顺序或随机。机器人主菜单可保持原样、设为新菜单或隐藏。

内容块选项

文字和媒体块可设置置顶、静音、禁止转发、剧透、关闭链接预览和N 秒后自动删除。

消息内按钮

每个按钮设置按钮文字和类型:

  • 文本:点击后把按钮文字作为用户的回答发送。在 Telegram 和 VK 中使用回复键盘,可回答问题或按文字触发反应;WhatsApp、Instagram、Messenger 和网页小组件使用不常驻的回答按钮。
  • 链接:打开 URL。
  • 网页应用:打开 Telegram Mini App,见Mini App。
  • 调用反应:点击后启动另一反应。
  • Inline 查询:把“@机器人 查询”放入当前聊天的输入框,或提示选择其他聊天(switch_inline_query / switch_inline_query_current_chat)。仅 Telegram 可用,须先在 @BotFather 用 /setinline 开启 inline 模式。GetMyBot 尚未实现 answerInlineQuery,因此按钮只准备查询文本,不会执行搜索。
  • 预填文本:链接到 https://t.me/<机器人>?text=…,打开机器人聊天并在输入框填入草稿(prefill),不会自动发送。
  • 支付链接:打开必填的支付 URL。付款本身由“创建支付”动作创建;这是外部付款页面,不是 Telegram 原生账单。
  • 通知:点击时显示文字,不启动反应,也不传递按钮保存的数据(Carry)。Telegram 支持最多 200 字符的简短提示或弹窗;VK 仅支持最多 90 字符的短提示条。

文本按钮与预填文本

目的类型与配置点击后
在问卷中选“是”“文本”,按钮文字为“是”,消息设置为等待回答将“是”交给对话步骤
准备咨询内容“预填文本”,按钮文字为“发消息”,预填“我想下单”在机器人聊天输入框显示草稿,由用户自行编辑并发送

按钮文字与预填内容是两个不同字段。预填文本不会自行发送消息或启动反应。

调用反应按钮的点击会作为独立事件传给机器人,技术上称为 callback。Inline 查询和预填文本按钮由 Telegram 应用直接处理,没有 callback,因此不能使用 answerCallbackQuery 或 Carry。

按钮图标与颜色

按钮文字前可显示高级自定义表情。在 icon_custom_emoji_id 填写其 ID,即正的 64 位整数。例如 007 会被视为 7;字母、零、负数或过大的数字会被丢弃,按钮仍会保存,但不带图标。

Telegram 只会给具备相应资格的机器人显示此图标:机器人通过 Fragment 拥有额外用户名,或所有者拥有 Telegram Premium 且直接发送到私聊或群组。其他情况下 Telegram 会忽略图标,不会自动替换为普通表情。

样式(style)可设为普通无色、主要蓝色、成功绿色或危险红色。

一次性(single_use)让保存的按钮数据只能使用一次,适合确认选择。点击后修改按钮文字或删除消息,需要在点击行为中另行设置。

按钮布局选项

  • 另起一行:把按钮放在下一行。
  • 占满整行:按钮单独成行,后续按钮也从新行开始。
同一行:       [目录] [帮助]

另起一行:   [目录]
             [帮助]

占满整行:   [          帮助          ]

Telegram 和 VK 支持行布局和颜色;重新打开编辑器后布局仍会保留。Telegram 高级表情需要兼容的接入方式。没有“在 Telegram 内打开”开关,Bot API 不允许通过这个标志控制打开方式。

各渠道的限制

可以为内容块或单个按钮选择连接。“所有渠道”只能使用共同支持的功能;不支持的按钮类型无法保存。

  • Telegram:URL、Mini App、调用反应、通知或弹窗、行布局、颜色,以及机器人有权限时的自定义表情。
  • VK:URL、调用反应、短提示条、行布局和颜色。仅选择兼容的 VK 连接时可用 VK Mini App 和 VK Pay。
  • WhatsApp:一条消息最多一个 URL 行动按钮,且不能与其他按钮并存。普通回答按钮最多 3 个;4 至 10 个显示为列表。按钮文字最多 20 字符。不支持行布局、颜色、Mini App 和通知。
  • Instagram / Messenger:当前适配器只发送快速回答按钮,文字最多 20 字符;不支持 URL、Mini App、通知、行布局和颜色。
  • 网页小组件:支持 URL 和回答按钮,不支持行布局、颜色和通知。
  • Email:支持链接(含支付链接),不支持回答按钮和通知。

从列表生成按钮时,仅支持行布局的渠道可设置列数;其他渠道自行决定布局。按钮数量和文字长度限制会在发送时检查。

点击后的行为

对于会把点击传给机器人的按钮,若渠道支持,可以替换消息为文字或另一反应的内容、删除消息、添加标签或保存参数。点击后修改按钮自身的文字仅 Telegram 支持,例如把“报名”改为“已选择”;VK 虽能编辑消息,却不能修改按钮文字。

Telegram 等待机器人调用 answerCallbackQuery 确认点击。GetMyBot 通常会自动确认,让按钮上的加载状态消失;跳过 answerCallbackQuery会关闭此确认。

调用反应按钮的点击提示文字可填写“课程已选择”等简短确认(Telegram 最多 200 字符,VK 最多 90 字符,可用替换内容)。Telegram 默认短暂显示提示;仅 Telegram 的显示为弹窗会以 show_alert 打开窗口。文字为空时只取消加载状态。如果启用了跳过 answerCallbackQuery,提示和弹窗都不会发送。

按钮携带的数据(Carry)

Carry 让按钮记住对应的对象。例如两件商品都有“购买”按钮,可以分别保存 product_id=101 和 product_id=102;点击第二个按钮后,下一反应中的 {{ctx.product_id}} 就是 102。

编辑器中此设置叫点击时的数据。键是数据名称,值可以是数字、文字或替换内容。机器人在发送消息时保存每个按钮各自的数据,点击时将它们放进该反应的临时上下文 ctx。

有效期(ttl_seconds)以秒为单位;3600 为一小时,0 使用默认的 30 天。到期后数据不可用;一次性(single_use)在首次点击后删除数据。保存的价格不会随商品目录自动更新,付款前应根据商品 ID 再查当前价格。参见动态按钮与参数。

动态按钮

如果商品或课程已在列表中,可使用从列表生成动态按钮内容块,为每项生成一个按钮。设置 ctx 中的列表位置、单项别名、每行按钮数和模板。例如 {{item.name}} 会插入当前商品名称。详见动态按钮与参数。

文本中的高级表情

在文本块中点击高级表情,可插入 <tg-emoji emoji-id="…">🙂</tg-emoji>。支持时 Telegram 会显示自定义表情,否则显示标签中的普通表情。HTML 和 Markdown 格式的内容块都可用。ID 最多 32 位数字,可通过 getCustomEmojiStickers 或把表情消息转发给 @idstickerbot 查询。

机器人链接与预填文本

t.me/<机器人>?start=<参数> 会在 Telegram 中触发 /start <参数>。这种链接无法只打开带参数的聊天而不触发 /start。可选做法:

  • 不显示回复的 /start:为带有指定启动链接标记的“/start 命令”反应添加不含内容块的“发送消息”动作;用户不会看到针对 /start 的回复,但标记已在事件上下文中,可供同一反应的条件和动作使用。
  • 预填文本:https://t.me/<机器人>?text=<文本> 或“预填文本”按钮只在输入框放入草稿,不触发 /start,由用户自行发送。
  • 以用户身份自动发送消息:Bot API 不支持机器人代替用户发消息。可改用 ?start= 深链接,再由反应以机器人身份回复。

等待回答(对话步骤)

文本块可以等待用户回答,使流程暂停;连续多个步骤就能在聊天中完成问卷。

期待的内容类型

可等待文字、从选项中选择、照片、视频、圆形视频、音频、文档、语音消息、位置、联系人、日历或骰子。错误类型的回答不会被接受。

验证文字

可检查电话号码、电子邮件、链接、日期、时间,或是否符合公式。例如期待电话号码时,任意文字不会被接受,机器人会显示错误提示。公式验证使用高级公式:成功时返回空文字,拒绝时返回错误文字。

保存回答

回答可保存到用户参数,随后可通过 {{param.键名}} 插入消息,也可用于条件判断。

错误、提醒和超时

  • 验证失败提示:回答未通过检查时显示。
  • 提醒:用户迟迟不回答时发送。
  • 超时停止等待:设置等待时间;超时后还可启动反应,例如结束问卷。该反应在关联图中显示为“等待超时”,回答触发的反应显示为“等待回答”。

用命令退出步骤

/cancel 或俄语词 отмена 是内置的取消方式:解除等待并回复“已取消。”;如配置了取消反应,则改为运行该反应。其他命令默认也会被当作回答并接受检查。如果启用机器人命令(如 /start)会中断等待(escape_on_command),任何命令(例如问卷中途的 /start)都会静默解除等待,再正常执行该命令。

替换内容

替换内容按钮可插入发送者数据({{first_name}}、{{username}}、{{user_id}})、事件数据({{text}}、{{chat_id}}、{{datetime}})和用户参数({{param.键名}})。完整列表见替换内容与公式。

机器人菜单按钮

菜单按钮动作可设置默认菜单、命令列表或带文字和 URL 的 Mini App 按钮。可只针对当前聊天,也可修改机器人的通用设置,例如仅为当前客户显示个人 Mini App。实际可用范围取决于渠道。

接下来