360Bots
机器人用于驱动菜单、流程、OTP 外壳和合作伙伴框架服务。
列出机器人
GET /api/v1/bots
{
"bots": [
{
"code": "portail",
"name": "SEED Portail",
"runtime_mode": "local",
"partner": { "code": "seed", "name": "SEED" }
}
]
}
创建机器人
POST /api/v1/bots
{
"code": "support",
"name": "Support bot",
"runtime_mode": "service",
"channel_inapp": true
}
机器人详情
GET /api/v1/bots/{code}
当 runtime_mode=local 时,包含菜单、流程和操作。
会话
GET /api/v1/bots/{code}/sessions
查看活动会话及其上下文,以便运维和调试。
框架服务
由合作伙伴管理、负责实现业务逻辑的 HTTP 服务:
| 端点 | 用途 |
|---|---|
GET /api/v1/bot-framework | 获取当前配置 |
PUT /api/v1/bot-framework | 设置 service_base_url、身份验证和路径 |
当 runtime_mode=service 时,MorisBox 会调用您的 /start 和 /input 端点,并将其响应映射为客户端事件。
流程邀请
POST /api/v1/bots/{code}/flows/{flow_code}/invite - 请参阅流程。
每个机器人的凭证
每个机器人都有一个经过哈希的机器人令牌和一个 HMAC Webhook 密钥。
完整的安全模型和 API 请参阅**机器人凭证与 Webhook**。