机器人：5 分钟最短路径

1. 1. 在控制台申请机器人

   填写显示名与 username（小写开头，^[a-z][a-z0-9_]{2,63}$），然后提交平台审核。

   去申请
2. 2. 保存一次性 Token

   审核通过后，在机器人「概览」中保存仅显示一次的 sbot_… Token。丢失后请重新生成。

   打开控制台
3. 3. 选 Webhook 或长轮询

   有公网 HTTPS：控制台 Webhook 页配置 URL + secret。本机调试：保持无 Webhook，用 getUpdates / startPolling。

   Webhook 指南
4. 4. 装 SDK 并回复

   pnpm add @starim-io/bot-sdk。用 SOCHAT_API_BASE 指向控制台提供的 API 地址。

   Node SDK

最小 Echo（Node，长轮询）

import { StarIMBot } from '@starim-io/bot-sdk'

const bot = new StarIMBot({
  token: process.env.SOCHAT_BOT_TOKEN!,
  baseUrl: process.env.SOCHAT_API_BASE!, // e.g. https://api.example.com/api/v1
  secretToken: process.env.SOCHAT_WEBHOOK_SECRET,
})

bot.on('message', async (ctx) => {
  const text = ctx.message?.text
  if (text) await ctx.reply(text)
})

// Ensure no webhook is configured before polling.
bot.startPolling()