让任何平台接入 JianChat 机器人

TG · QQ · 企业微信 · 自建服务 —— 一条 WebSocket + 一个长期 API Key，即可向 JianChat 群收发消息

创建机器人

打开 JianChat App →「我的机器人」→ 创建机器人 → 拉进群

复制 API Key

机器人详情页查看长期 Key（jk_xxxx），随时可复制、可重置

调用接口

用 Key 通过 WebSocket 连接平台，向指定群发消息 / 配置定时推送

连接地址 WebSocket

通道	地址	说明
HTTPS (WSS)	`wss://q.kisn.cn/ws`	生产推荐，443 端口反代
WS 直连	`ws://api.kisn.cn:28901`	备用直连
HTTP API	`https://api.kisn.cn/v1`	HTTP 扩展接口（开发中）

认证方式 Key / Token 双通道

所有接口使用请求中的 key（长期 API Key，格式 jk_...）或 token（创建时一次性）认证。推荐使用 Key。

Key 是机器人的唯一凭据，请妥善保管。泄露后可在 App 内「重置 Key」，旧 Key 立即失效。

接口列表 action

接口	参数	说明
`bot_send`	key · gid · data · type	机器人向群发消息（type 默认 text）
`bot_cron_add`	key · gid · text · interval_min	添加定时推送（1~10080 分钟）
`bot_cron_list`	key	查看定时任务
`bot_cron_del`	key · cron_id	删除定时任务
`bot_key`	bot_id（登录态）	查看机器人 Key（App 内使用）
`bot_key_reset`	bot_id（登录态）	重置机器人 Key（App 内使用）

示例：Python 发消息

# pip install websockets
import asyncio, json, websockets

KEY = "jk_你的机器人Key"
GID = "g_群ID"

async def send():
    async with websockets.connect("wss://q.kisn.cn/ws") as ws:
        await ws.send(json.dumps({
            "action": "bot_send", "key": KEY,
            "gid": GID, "data": "大家好，我从开放平台接入"
        }))
        while True:
            r = json.loads(await ws.recv())
            if r.get("action") == "bot_sent":
                print("发送成功:", r["m"]["from_name"]); break

asyncio.run(send())

示例：定时推送

ws.send(json.dumps({
    "action": "bot_cron_add",
    "key": KEY, "gid": GID,
    "text": "每天早报时间",
    "interval_min": 1440   # 每 24 小时一次
}))