For the channel owner
You run a paid Telegram channel or group and use an AI agent that can call web APIs. Copy the prompt, change the channel name and price, and paste it into the agent.
For AI agents
Set Up Paid Telegram Access With Your AI Agent
KickThemBot has an owner API built for AI agents. You paste one prompt, your agent pairs with your account, creates the project and plans, prepares payments, and tells you the few taps only you can make in Telegram.
The one prompt
Copy it, change the name and price, paste it into your agent.
Set up KickThemBot for my paid Telegram channel "My VIP Channel" and charge $29 a month. Use the KickThemBot API: read https://api.kickthembot.com/openapi.json and https://www.kickthembot.com/agents/ first. For payments, send me the link to connect my Stripe account in @KickThemBot, or ask me for my USDT wallet address and network and send it to @KickThemBot for me to confirm. Tell me each Telegram tap I need to make, and never ask me for passwords, bot tokens or keys in this chat.
Your agent never needs a password, bot token or key from you. If it asks for one in the chat, do not send it.
For the AI agent
Read the OpenAPI contract, pair with the owner through @KickThemBot, and follow the humanStep messages the API returns. Plan limits come from GET /api/me, never from this page.
Who does what
Your agent does the setup calls. You make a few taps.
Your AI agent
Pairs with your account
Creates a pairing and sends you a link and a code to approve in @KickThemBot.
Reads your plan
Checks your plan limits and usage with GET /api/me and offers a checkout link if you need a paid plan.
Creates the project
Creates your channel or group project and a link for your bot token.
Connects the chat
Creates a link that adds the bot to your channel as an admin with invite and ban rights.
Creates your plans
Adds your membership plans, such as $29 a month, as subscriptions or lifetime access.
Sets up payments
Sends you a Telegram link to connect Stripe in @KickThemBot, or sends your USDT wallet to @KickThemBot for you to confirm. It never gets a Stripe page and cannot save a wallet without your tap.
Checks setup and runs it
Reads setup-status until it is ready, gives you plan payment links and buttons for your website, then creates or revokes access codes when you ask. It sees and changes member records only if you grant that permission.
You, in Telegram
Approve the agent
Check the agent name (shown as not verified), the code and the permissions in @KickThemBot, then tap Approve.
Verify your email
Send your email to @KickThemBot and enter the 6-digit code, if you have not already.
Pay, if you need a paid plan
Open the Stripe checkout link your agent sends. Fresh is free and needs no payment.
Create your bot in BotFather
Send /newbot to @BotFather, then paste the token into @KickThemBot through your agent's link, never into the agent chat. @KickThemBot deletes your message right away.
Add the bot as admin
Open the link your agent sends, confirm Telegram's add-administrator screen, then tap Attach when @KickThemBot asks in your private chat.
Choose how buyers pay
Open the Telegram link your agent sends and tap Connect Stripe in @KickThemBot (only your account can), or give your agent your USDT address and network, then check the full address in @KickThemBot and tap Confirm. Crypto buyers pay your wallet and get an access code once you confirm the payment.
For the agent
Start from the contract.
- OpenAPI 3.1 contracthttps://api.kickthembot.com/openapi.json
- llms.txtSetup flow, human steps and plan limits in plain text
- API overviewOwner API for agents and project keys for your own systems
Base URL https://api.kickthembot.com. Start with POST /api/agent/pairings, send the owner every humanStep.userMessage as it is, and read plan limits from GET /api/me.
Security, in plain words
You stay in control of the account.
- You approve every agent in Telegram, where its name is marked not verified, and the agent only gets its token after that tap. Names imitating KickThemBot, Telegram, Stripe, support or admins are refused.
- By default a token can create plan checkout links, projects, plans and access codes. Member records, project API keys and USDT wallet proposals are Sensitive permissions: the agent must ask for them, and you see a warning before you approve.
- Your agent cannot save or change a USDT wallet on its own. It can only propose one: @KickThemBot shows you every full address, and nothing changes until you tap Confirm from your own Telegram account.
- Bot tokens go only to @KickThemBot, which deletes your message immediately, so they never pass through the agent.
- The agent never gets a Stripe page and cannot connect, change or disconnect Stripe. Only you connect it in @KickThemBot, and it tells you in Telegram when a Stripe account is connected.
- The owner token is scoped, rate limited and stored only as a hash. Send /agents to @KickThemBot to see when each agent was last used and tap Revoke or Revoke all; revoking also stops any project API keys that agent created. Up to 20 agents can be active.
- A token cannot delete a project, rotate a project API key, manage your team, or change a paid subscription.
- Every agent change is recorded in the audit log, without secrets.
FAQ
Questions about agent setup.
Which AI agents can set up KickThemBot?
Any agent that can read an OpenAPI file and make HTTPS requests. It pairs with your account through @KickThemBot, so it needs no password.
What do I still have to do myself?
A few taps in Telegram: approve the agent, verify your email, create your bot in BotFather and paste its token into @KickThemBot, add the bot as admin, tap Attach, pay if you choose a paid plan, and connect Stripe in @KickThemBot or give your USDT address and tap Confirm on it in @KickThemBot.
Should I paste my bot token or Stripe password into the agent chat?
No. The bot token goes only to @KickThemBot, only you connect Stripe (from @KickThemBot, then on Stripe's own page; your agent never sees a Stripe link), and a USDT address is public, so it is the only payment detail you give the agent. If you pasted a token by mistake, revoke it in BotFather with /revoke.
Can the agent take crypto payments for me?
Buyers pay USDT or other crypto to your own wallet. Your agent can send your USDT address to @KickThemBot, but it is saved only after you check it there and tap Confirm. Once you confirm a payment, you or your agent send them an access code for their plan. The agent does not receive or check crypto payments itself.
Is the API available on the free plan?
Yes. API access is on every plan, including Fresh. What the agent can create is limited by your plan's members, projects and access codes.
How do I stop an agent?
Send /agents to @KickThemBot and tap Revoke, or Revoke all. The token, and any project API key that agent created, stops working on its next request.
Get started
Paid Telegram access, managed automatically.
Open the bot, connect one private group, and let the next renewal batch run without you.
Start Free
Free plan, no card required. Upgrade or stop whenever you want.
Opens Telegram. Starting the bot does not purchase a plan.