ボット: 5分の道のり

1. 1. コンソールで適用

   表示名 + ユーザー名を提出します (^[a-z][a-z0-9_]{2,63}$)。管理者の承認を待ちます。

   適用
2. 2. ワンタイムトークンを保存

   承認後、概要にsbot_…が一度表示されます (7日間のRedis TTL、読み取り後に破棄)。失われた場合は再生成します。

   コンソール
3. 3. Webhookまたはポーリングを選択

   公開HTTPS → Webhookを設定します。ローカル → Webhookを空にしてgetUpdates / startPollingを使用します。

   Webhook ガイド
4. 4. SDKをインストールして返信する

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

   Node SDK

最小エコー (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.musuwa.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()