Bots: 5-minute path

1. 1. Apply in the console

   Enter a display name and username (^[a-z][a-z0-9_]{2,63}$), then submit the bot for review.

   Apply
2. 2. Save the one-time token

   After approval, save the sbot_… token shown once in Overview. Regenerate it if it is 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.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()