AI bots
"AI bots" in the app details is where you create and manage bots, view reply statistics, and add bots to users. How bots work and how to connect your model is described in AI conversations.
The platform does not call the model and does not store model keys: when a user messages a bot, the platform calls back your service, which calls the model and streams the reply back with a server SDK. The "How it works" and "Rules" cards at the top of the page summarize this.
Permissions
| Operation | developer | admin / owner |
|---|---|---|
| View the bot list, details, statistics and recent replies | Yes | Yes |
| Create, update, enable / disable or delete bots, add to users | No | Yes |
Adding a bot to users creates friendships on the bot's behalf and requires re-verifying your identity.
Create a bot
Click "Create bot" and fill in:
| Item | Description |
|---|---|
| Username | The bot's IM username; must not duplicate an existing user; cannot be changed later |
| Nickname | The name users see, such as "Support assistant"; change it later on the "IM users" page |
| Callback address | Address called when users message the bot; if not set, addresses subscribed to ai.message_received are used. Addresses are managed in Callback configuration |
| Note | Shown only in the console |
| Advanced | Context included (0–50 messages, default 10), timeout without content (10–300 seconds, default 60), maximum replies generated at once (default 1000) |
Once created, the bot is an IM user in the app: it can be added as a friend or blocked, cannot log in or join groups, and only replies in one-to-one chats. Its friend-add mode is "accept directly". Each app can have up to 100 bots.
Bot list
The list shows each bot's status, callback address, replies today and replies being generated, and can be searched by nickname or username. The top summarizes the number of bots (enabled and disabled).
- Disable: users can still message the bot, but the platform stops calling back your service and new replies cannot start; replies already being generated are not affected. You can enable it again at any time.
- Delete: the bot's IM user is deleted too, replies being generated end as "interrupted", and existing messages are kept. This cannot be undone.
Bot details
Click a bot to open its details, which have three tabs:
- Statistics: messages received and replies per day for the last 7 or 30 days, split into completed, stopped and interrupted, plus average time to first token, average generation time and interruption rate; switch between chart and table. Counted by UTC date, for display only, not used for billing.
- Recent replies: the latest 100 replies with user, start time, status, time to first token, duration, finish reason and model, filterable by status; records are kept for 30 days and the message is authoritative for content.
- Configuration: change the callback address, note and advanced settings; nickname and avatar are changed on the "IM users" page.
Add to users
A bot appears in a user's conversation list only after they become friends or the user messages it. On the details page click "Add to users" and enter one username per line, up to 1000 at a time:
- The bot and each user become friends directly, without the user's confirmation;
- Optionally check "Also send a welcome message", sent as the bot, so the bot appears in the user's conversation list;
- The result shows how many were added and how many failed.
To remove friends or block, use the "IM users" page. Your server can also add bots in bulk with the add friend API.