Bot API

TypeScript SDK v1

Чистый TS client для owner-side и bot runtime сценариев лежит в `apps/web/lib/bot-api-sdk.ts`.

ReferenceWebhooksLong pollingTS SDK
1. Создание клиента

SDK не привязан к React и работает поверх стандартного `fetch`.

import { createBotApiClient } from "@/lib/bot-api-sdk";

const ownerClient = createBotApiClient({
  baseUrl: "https://api.yullama.ru",
  token: process.env.YULLAMA_OWNER_TOKEN!,
});
2. Owner-side вызовы

Owner client умеет создавать ботов, ротировать токены, настраивать webhook и читать operational state.

const created = await ownerClient.owner.createBot({
  username: "news_tatarstan_bot",
  display_name: "News Bot",
});

await ownerClient.owner.updateWebhook(created.bot.id, {
  url: "https://bot.example.test/webhook",
  secret_token: "secret-123",
});
3. Bot runtime вызовы

Bot client использует bot token и работает как сам бот: публикует посты и читает update.

const botClient = createBotApiClient({
  baseUrl: "https://api.yullama.ru",
  token: process.env.YULLAMA_BOT_TOKEN!,
});

await botClient.bot.createChannelPost(channelId, {
  body: "Bot API production news update",
});