agentinbox

Agent Inbox for Telegram

Give your AI agentits own Telegram bot

Create a private bot with BotFather and connect it in one command. Your agent can then message you, ask with buttons, and wait for your tap.

npx @agentinbox/cli setup telegram

A Telegram chat where an AI agent asks to approve a deploy, with Approve and Deny buttons
fig. 01 — telegram[ agent → asks → human ]

What your agent can doon Telegram

Its own private bot

You create the bot with @BotFather, so only you control it.

Buttons you tap

Approvals and choices arrive as buttons in the chat. One tap answers.

It messages you first

Your agent starts the conversation when it needs you.

Replies in context

Each answer goes back to the conversation that asked for it.

Set up inthree steps

$ npm i -g @agentinbox/cli

added 1 package in 2s
✓ agentinbox is ready

Ask, approve, choose, tellon Telegram

Four message types cover what an agent needs from a person. Every type except tell waits for the answer.

A yes or no before anything hard to undo. Two buttons in the chat.

$ agentinbox send approve "Restart the production database?" --to ana --ttl 1h
Approved by Ana at 9:41 AM
(exit code 0, or 10 if denied)

Works withyour agent

Pick your agent for setup steps and prompts written for it.

Using another agent?Read the CLI docs →

Who canreach your agent

Contacts

The people your agent can reach. You're the first one.

agentinbox contact list

Invites

Send a teammate a link that opens your bot. Once they tap Start, your agent can reach them.

agentinbox contact invite carol --name "Carol Diaz" --via telegram

What peoplebuild with it

Support

Approve refunds from your phone. The refund waits for your tap, wherever you are.

agentinbox send approve 'Refund $240?' --to maya

DevOps

Approve deploys on call. The on-call engineer gets the deploy request in Telegram and answers with a tap.

agentinbox send approve "Deploy v2.4 to prod?" --to oncall

Personal assistant

Let your assistant ask, not guess. Options arrive as buttons, so picking takes a second.

agentinbox send choose "Which flight?" --option 9am --option 1pm

Monitoring

Get told when it matters. A short message when a job finishes or fails.

agentinbox send "Nightly build: 0 failures"

Questions,
answers

Do I create my own Telegram bot?

Yes. You create a private bot with @BotFather and paste its token in your terminal or on the Agent Inbox setup page. Only you control it, and the token never goes into a chat with your agent.

Can my team use the same bot?

Yes. Invite teammates as contacts and each gets a link that opens the bot. Your agent can then message any of them, or ask up to 50 at once and take the first valid answer.

What happens if nobody taps a button?

Every question has a time limit: 24 hours by default, up to 5 days. When it runs out, the question expires and your agent gets that result, so it can decide what to do next.

Can my bot message strangers?

No. Your agent starts conversations only with contacts. If a stranger writes first, the message arrives as information, never as instructions, and your agent can reply. Switch to contacts only to keep strangers out.

Does it cost anything?

Agent Inbox is free for 100 conversations a month. You can also try it without an account: a keyless setup gives you 5 free messages.

Give your agenta Telegram bot.Today

Free for 100 conversations a month. No credit card required.

npx @agentinbox/cli setup telegram

An agent completes customer conversations and receives a reply.