定时任务 (Scheduled Tasks)

商业功能的「定时任务」允许您自动化更新自己的 Telegram 账号资料（名字、姓氏、用户名、个人简介）。

适合场景

• 状态展示：在名字后定时更新营业状态、当前接单状态。
• 动态简介：在简介中循环展示不同产品、活动信息或格言。
• 引流与营销：定时更新用户名（如果拥有多个可用的用户名），配合不同渠道的推广。
• 趣味性：每隔一段时间在名字里加上随机表情。

基础配置

在面板中创建或编辑定时任务时，您可以配置以下字段：

字段	说明
状态	启用/禁用该任务。
执行周期	任务执行的频率（支持 Cron 表达式，如 */5 * * * * 表示每 5 分钟执行一次）。
更新目标	勾选需要更新的字段：名字(First Name)、姓氏(Last Name)、用户名(Username)、简介(Bio)。
清除原值	勾选后，该字段将被清空（注意：名字不能清空）。
更新内容	填入要更新的新内容。

更新方式

目前系统会按照您设定的周期，将目标字段更新为您填写的固定内容。后续版本将支持从内容池中随机或顺序抽取内容进行更新。

限制与规则

• 任务数量：每个用户最多可创建 3 个处于启用状态的定时任务。
• 频率限制：执行周期最短建议为 5 分钟，过高频率可能导致 Telegram 官方限制（Rate Limit）。

失败与暂停机制

如果由于网络问题、账号异常、授权失效等原因导致任务执行失败：

• 自动暂停：当任务连续失败 3 次时，系统会自动将该任务的状态置为禁用（暂停）。
• 通知机制：系统会通过 bot 向您发送一条暂停通知。为了不打扰您，同样的失败通知存在 24 小时的冷却期。
• 恢复任务：修复问题（如重新连接 Business Chatbot）后，您可以在面板中手动重新启用任务。

服务器部署说明

(此部分供系统管理员参考)

要使定时任务正常运行，服务器必须配置 Laravel 的任务调度。 在服务器终端中运行：

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

面板会自动派发 CommerceTaskRunner 来处理到期的定时任务。