触发器

触发器是反应响应的事件。在编辑器的触发器区块中可同时启用多个类型:它们以**"或"关系组合——只要满足任意一个**已启用的触发器,反应即触发。额外限制(标签、参数、聊天)在条件中单独设置。

文本消息

对文本或媒体说明文字触发。在**"搜索内容"**字段中选择模式:

  • 关键词 — 单词/短语列表。**"匹配方式"参数:包含精确匹配开头为正则表达式;以及"区分大小写"**选项。
  • 链接 — 消息中包含 URL。
  • 邮箱 — 包含邮件地址。
  • 提及(@username) — 包含提及。
  • 任意文本 — 任意文本消息。

命令

对斜杠命令触发。在**"命令(不含"/")"**字段中列出名称,例如 helpmenu。机器人将响应 /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

下一步