TARGETF4Admin · 配置机器人 webhook、polling、事件版本、签名和故障切换的集成开发者与值班人员

事件订阅与开发配置

Webhook 与 polling 使用同一版本化 EventEnvelope;验签、持久化、去重、快速 ACK 与异步处理形成明确交付边界

/robot/devConfig/:idminiapp-open-platform
UI STUDIOtarget-open-bot-config
Admin1440 × 900100%
100%
/robot/devConfig/:id
TARGET UI1440 × 900FIT 100%
ORGANIZATION / REITS APAC / BOTAutomation Control Plane
DX
EVENT CONFIGURATION · PRODUCTION

事件订阅与开发配置

Webhook 与 polling 共享同一版本化 EventEnvelope;先验签、持久化和去重,再快速 ACK,业务处理异步执行。

Webhook · primaryPush delivery · fast ACK · signed payloadACTIVE
Polling · standbyDurable checkpoint · controlled failoverPAUSED
WEBHOOK ENDPOINT · REVISION 8

Production endpoint

VERIFIED
API version2026-07-01ACK deadline3 secondsMax body1 MiBReplay window5 minutes
Signing secretwhsec_••••••••••••7A2Frotated 14d ago
Endpoint verification passedTLS valid · HMAC accepted · ACK 142ms · no redirect
chk_01J3C8
OpenSDK headers: X-IM-Bot-Signature / Timestamp / Update-ID / Event-ID
SUBSCRIBED EVENTS

最小事件集合

Event typeVersion24hHealth
message.createdv12,418Healthy
command.invokedv11,286Healthy
installation.changedv12Healthy
message.updatedv10Disabled
REFERENCE VIEWPORT1440 × 900Desktop first · responsive
PRIMARY TASK发布配置 revision主操作、权限与完成反馈必须同屏可验证
DATA CONTRACTEventSubscriptionready / loading / empty / error 使用同一 fixture
ACCESSIBILITYKeyboard + WCAG AA焦点顺序、可读名称、对比度进入 UI CI
VISUAL BASELINETARGET · 2026-07-17桌面/移动、浅色/错误态按稳定 Screen ID 留档

IMPLEMENTATION MAP

可以直接拆成开发任务的目标定义

目标稿与当前实现严格分轨;只有产品仓实现、测试与生产证据齐全后,才会转为 current evidence。

01

页面区域

  • 机器人与环境上下文
  • 配置任务头
  • 交付模式
  • Endpoint 表单
  • 签名与安全参数
  • 事件订阅
  • 消费契约
  • 发布 revision
02

用户动作

  • 发布配置 revision
  • 验证 Endpoint
  • 发送测试事件
  • 添加或移除事件
  • 轮换签名 secret
  • 切换交付模式
  • 查看失败诊断
03

必须状态

  • 事件配置就绪
  • Endpoint 与订阅加载
  • 尚未配置 Endpoint
  • 事件健康部分失败
  • 配置发布失败
  • 离线只读配置
  • 缺少 bot.webhook:manage
  • 模式切换/轮换确认
  • 配置 revision 已生效
04

数据契约

  • EventSubscription
  • WebhookEndpointRevision
  • WebhookSigningSecret
  • BotEventEnvelope
  • EventTypeVersion
  • PollCheckpoint
  • DeliveryModeSwitch
  • AuditReceipt

TARGET MODULES

目标页面必须交付的模块

  1. 01Webhook/Polling 模式
  2. 02HTTPS endpoint 验证
  3. 03事件订阅表
  4. 04API version
  5. 05HMAC secret 双密钥轮换
  6. 06ACK/Body/Replay 限制
  7. 07durable PollCheckpoint
  8. 08模式切换与诊断

PRODUCT ROUTE INDEX

开放平台 · 自动化 的 38 个稳定 Screen ID

同一产品内的页面共享 token、导航和状态语言,但每个 Screen ID 保留自己的字段、数据契约和 QA 基线。

01
开发者登录/login
Web
02
我的小程序/apps
Web
03
创建小程序/apps/new
Web
04
应用发布/apps/:id/publish
Web
05
应用索引与控制面健康/apps
Admin
06
三步创建应用/apps/new
Admin
07
上传、审核与原子发布/apps/:appId/releases/new
Admin
08
应用基本信息与生命周期/apps/:appId/settings
Admin
09
环境、回调与凭证/apps/:appId/config
Admin
10
版本历史、对比与回滚/apps/:appId/versions
Admin
11
接口、Scope 与使用量/apps/:appId/capabilities
Admin
12
能力申请与审核/apps/:appId/capability-requests
Admin
13
组织目录与企业边界/mini-company/list
Admin
14
创建与验证企业/mini-company/create
Admin
15
开发治理概览/console/development
Admin
16
开发者身份与资源关系/console/developer
Admin
17
成员、邀请与离职治理/console/member
Admin
18
角色、策略与有效权限/console/role
Admin
19
服务账号与工作负载身份/console/service-accounts
Admin
20
操作、授权与安全审计/console/log
Admin
21
机器人目录与运行健康/robot/list
Admin
22
创建机器人与最小授权/robot/create
Admin
23
机器人基本信息与生命周期/robot/baseInfo/:id
Admin
24
事件订阅与开发配置/robot/devConfig/:id
Admin
25
命令定义、权限与测试/robot/command/:id
Admin
26
Bot Token 与运行凭证/robot/token/:id
Admin
27
事件交付、重试与 Redelivery/robot/:id/deliveries
Admin
28
支付订单与资金生命周期/mini/:type/paymentOrders/:id
Admin
29
用户数据、授权与主体请求/mini/:type/userData/:id
Admin
30
支付能力申请与独立复核/mini/:type/payApply/:id
Admin
31
组织财务、结算与对账/console/finance
Admin
32
公共开发者首页与能力总览/
Web
33
Mini App 产品、Quickstart 与宿主边界/mini
Web
34
企业开发与组织治理介绍/mini-company
Web
35
机器人、命令与事件自动化介绍/robot
Web
36
商业合作、场景准入与能力边界/business
Web
37
平台公告、变更影响与订阅中心/notice
Web
38
个人账号、安全、授权与偏好中心/console/my
Admin