触发器
触发器是反应响应的事件。在编辑器的触发器区块中可同时启用多个类型:它们以**"或"关系组合——只要满足任意一个**已启用的触发器,反应即触发。额外限制(标签、参数、聊天)在条件中单独设置。
文本消息
对文本或媒体说明文字触发。在**"搜索内容"**字段中选择模式:
- 关键词 — 单词/短语列表。**"匹配方式"参数:包含、精确匹配、开头为、正则表达式;以及"区分大小写"**选项。
- 链接 — 消息中包含 URL。
- 邮箱 — 包含邮件地址。
- 提及(@username) — 包含提及。
- 任意文本 — 任意文本消息。
命令
对斜杠命令触发。在**"命令(不含"/")"**字段中列出名称,例如 help、menu。机器人将响应 /help 和 /menu。
/start 命令
专门针对 /start 的触发器。Payload 字段捕获深度链接参数(/start <payload>);留空表示匹配任意 /start。这是实现推荐链接和活动链接的基础。
点击 inline 按钮(callback)
对点击 inline 按钮触发。"按钮数据(callback_data)"字段和"匹配方式"(精确、开头为、包含、正则表达式)决定捕获哪些按钮。
媒体
对所选类型的附件触发:照片、视频、视频消息、文档、音频、语音、GIF、贴纸、骰子、游戏、投票、联系人、地理位置、地点、相册。
系统事件
对聊天事件触发:通过链接加入、被添加至聊天、离开聊天、被移出聊天、状态变更、加入申请、消息反应、反应计数。适用于欢迎语、内容审核和处理加入申请。
回复与转发
- 回复消息 — 当消息是对另一条消息的回复时触发。
- 转发消息 — 对转发消息触发。
每第 N 条消息
对用户发送的每第 N 条消息触发(**"第几条消息"**字段)。适合定期提示或防刷屏。
按计划(日期)
在指定时间点触发(日期列表)。计划反应在到期时群发给活跃订阅者——详见群发。
传入 Web 请求(webhook)
对来自外部的 HTTP 请求触发。设置路径(完整 URL 由机器人地址和路径组成)、密钥令牌(用于保护)和方法(POST / GET / PUT / ANY)。请求数据进入执行上下文,可在动作中通过 {{ctx.字段}} 访问。详见Web 请求与 webhook。