Telegram devices
Connect Telegram bots by pasting BotFather API tokens.
Open Channel → Telegram → Devices.
What this page is for
Each row is a Telegram bot linked with the bot token from @BotFather. Kirisan checks the token with Telegram, registers the bot, and gives you a Kirisan API token for the Send API and device pickers.
Pick a bot when sending from Send → Send, autoreply rules, flows, or webhooks.
Create the bot in Telegram first (/newbot in BotFather), then paste that token here — Kirisan does not create bots for you.
Sample data shown.
| Header control | What it does |
|---|---|
| Add device | Open a dialog to paste a BotFather token and register the bot |
Search
Search is field-based — click the search area first, pick which column to search, then type your query.
| Step | What happens |
|---|---|
| 1. Click search | A Search in popup opens — you must choose a field before typing |
| 2. Pick a field | Bot name, @username, or API token |
| 3. Type | Kirisan filters the table as you type (short debounce) |
After you pick a field, the search bar shows the field name on the left (for example Bot name ▼). Click it to switch fields — changing the field clears the query.
| Search field | Matches | Minimum length |
|---|---|---|
| Bot name | Bot display name that contains your query | 3 characters |
| @username | Telegram @username that contains your query | 3 characters |
| API token | Kirisan API token that contains your query | 3 characters |
If you type fewer than three characters, Kirisan waits until the minimum is met and shows a short hint under the search bar.
Device table
Each row is one Telegram bot:
| Column | Meaning |
|---|---|
| Bot name | Display name Telegram reports for the bot |
| @username | Public bot handle (shown with @) |
| Plan | Free or paid plan badge — click to open Telegram plan (see Plan and free slot below) |
| Credits | Remaining send credits on this bot |
| Expires | Days left on the plan — Expired in red; under 5 days in amber |
| API token | Truncated Kirisan device token — full value shown only once when the bot is added |
| Created | When the bot was registered in Kirisan |
| Actions | Edit, Remove, and optional Use as active free device — see below |
Pagination below the table shows 25 devices per page when you have more than one page of results.
Plan and free slot
Click any Plan badge to open Telegram plan:
| Section | What it shows |
|---|---|
| Summary | Whether this bot is the active free slot, parked on free tier, or on a paid plan |
| Details | Credits, expiry, and active-since date for free devices |
| What to do next | Switch free slot, renew under Billing → Order, or copy the API token |
Every new bot starts on the free plan with 1,000 credits and a 30-day validity window. When the active free period ends, Kirisan refills 1,000 credits and another 30 days automatically. When a paid plan expires, the bot returns to free with 1,000 credits (see Plans and quota).
Badge colors in the table:
| Badge | Meaning |
|---|---|
| Green Free | Active free sending bot (only one Telegram bot can send on free tier at a time) |
| Red Free | Parked free bot — not the active sending slot |
| Violet plan name | Paid plan (for example Lite) — badge shows the actual plan name |
On the free tier, only the active free bot can send. On a parked free row, click Use as active free device to switch the slot (at most once every 7 days). Upgrading a bot to a paid plan on Billing → Order removes it from the free slot automatically.
Renewing the same paid plan while it is still active adds credits and extends expiry. Changing to a different plan replaces credits and resets expiry from today. See Plans and quota.
Add a device
- In Telegram, open @BotFather and create a bot with
/newbot, or open an existing bot and copy its token. - On Devices, click Add device.
- Paste the Bot token into the field.
- Click Save.
If the token is valid and not already registered, the bot appears in the list.
On success, Kirisan shows the Kirisan API token once — copy and store it before closing the dialog.
The token is not shown in full on the list afterward (only a short preview). You can still pick the bot in Send → Send and other pickers without re-entering the token.
Edit device
Click the Edit icon on a row to configure how inbound messages are handled and optional contact capture.
| Section | What it does |
|---|---|
| On incoming message | Exactly one handler for new inbound chats: Autoreply, Flow, Spreadsheet, or Webhook |
| Contacts | Optional contact group — when set, new senders are saved to contacts and added to that group |
The BotFather token and Kirisan API token cannot be changed here. Remove the device and add it again if you need to link a different bot.
Remove a device
Click the Remove icon. Kirisan asks you to confirm, then disconnects the bot from your account.
You can register the same bot again later with the same BotFather token if needed.
Related
- Templates — reusable message layouts for bots
- Inbox — read inbound messages to your bots
- Logs — outbound send history
- Plans and quota — free tier, renewals, plan changes, and expiry
- Place an order — upgrade bots from free to paid plans
- Send API — send programmatically with device API tokens