Bots: 5-minute path

1. 1. Apply in the console

   Submit display name + username (^[a-z][a-z0-9_]{2,63}$). Waits for Admin approval.

   Apply
2. 2. Save the one-time token

   After approval, Overview shows sbot_… once (7-day Redis TTL, destroyed after read). Regenerate if lost.

   Console
3. 3. Choose webhook or polling

   Public HTTPS → configure Webhook. Local → leave webhook empty and use getUpdates / startPolling.

   Webhook guide
4. 4. Install SDK and reply

   pnpm add @starim-io/bot-sdk. Point SOCHAT_API_BASE at your gateway.

   Node SDK

Minimal Echo (Node, polling)

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.sochatlive.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)
})

// 本地：先确保未配置 Webhook
bot.startPolling()