跳转到主要内容
GOWA Message Scheduler Overview 任何发送请求都可以定时执行。添加 scheduled_at 和 timezone 后,GOWA 会存储该请求,并由后台工作进程在指定时间发送。定时任务会在重启后保留;如果设备离线,则会等待设备上线。 可定时发送的消息类型:文本、图片、文件、视频、音频、贴纸、联系人、链接、位置、投票和转发(/message/{id}/forward)。在线状态、正在输入提示和实验性端点 /send/interactive 不支持定时执行。

计划字段

没有scheduled_at,请求将会像往常一样立即发送。

示例:

计划中的响应有 schedule_id 而不是 message_id 。
上传的文件会保留在服务器上,直到定时任务结束。在 multipart 请求体中,请通过重复字段发送 weekdays(-F weekdays=1 -F weekdays=3)。

管理计划表

定时任务归属于某台设备;请发送相同的 X-Device-Id。
列表返回 results.data 和 results.pagination(limit,默认为 25;offset;total)。

Statuses

送货行为

  • 工人每5秒检查到期时间。
  • 设备离线或未登录: 运行等待并每30秒重试一次。 等待不会计为失败的尝试,所以一个时间表会持续很长时间。
  • 发送错误: 采用退避机制重试,间隔从 15 秒开始,最长为 5 分钟,每次计划执行最多尝试 10 次。之后,重复任务会跳至下次执行时间;一次性任务则变为 failed。
  • 无效的请求 (例如一个坏的收件人):在没有重试的情况下立即失败。
  • 延迟运行: 未发送一个事件延迟通过 end_at 。
  • 崩溃和重启: 关闭不会中止已经在飞行中的发送。在第一次尝试之前,GOWA仍然存在一个 WhatsApp 消息ID。 在其2分钟的索赔到期后,中断的事件通常与同一ID合并,并计入尝试预算。 调查还会在所有检索中保留加密密。这会在确认含糊不清后保存消息身份,但不会保证一旦交货。
  • **较早中断的尝试:**遗留下来但结果未知的尝试保留了保守的恢复。 工人跳过重复计划或一次性计划而不是给它分配一个新的消息身份。

超过 MCP

MCP 工具 whatsapp_send 接受相同的定时字段,whatsapp_schedule 则用于列出、获取、暂停、恢复和取消定时任务。参阅 MCP 服务器。
检查GET /app/info: results.scheduled_sends 是true 当服务器接受schedule字段并暴露/send/schedules时。