消息与按钮
用文字、图片、消息下方的按钮和可保存回答的问题,组成机器人的回复。
本页内容
要让机器人发送文字、图片和“选择”按钮,请添加发送消息动作。回复由多个内容块组成,例如先发商品图片,再发带按钮的说明。消息下方的按钮也叫消息内按钮(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。实际可用范围取决于渠道。