iri docs

Telegram integration

The iri Telegram bot is a 1:1 chat. Type any thought into it during the day; the bot stores every message in your workspace's conversation log. Run /summary whenever you want to convert that log into a structured iri note.

This is the mobile-first capture surface. Use it when ideas come up between meetings, on the train, before sleep — places you don't want to context-switch to a notes app.

What you get

Command What it does Counts toward quota?
(any plain text) Saves the message to your conversation log. iri sends a quiet ✓ saved ack on substantive messages (40+ chars). No
/summary [hours] Convert the last N hours of your messages into a structured iri note (Decisions / Action items / Ideas / Notes). Default 24h. Accepts 6h, 1d, 30m. Yes (one summary call)
/ask <question> RAG-style answer over your workspace, with sources Yes (one ask call)
/find <query> Top 5 matching notes with links No
/capture <text> Save a quick note immediately (skips the conversation log) No
/recent List 5 most-recent notes across the workspace No
/help Show all commands No
/unlink Disconnect this Telegram from iri No

Your conversation log is retained based on plan: Free 14 days, Pro EA 30 days, Team 90 days. After that, raw messages are auto-purged. Notes you've explicitly saved (via /summary or /capture) live in your workspace forever.

Setup

You need to be a workspace admin or manager.

1. Connect Telegram to your iri workspace

  1. From iri: Workspace → Integrations → Telegram → Generate link.
  2. iri shows three connection options. Use whichever fits your Telegram client:
    • Open in Telegram (button) — works in the Telegram app on desktop or mobile.
    • Open in web.telegram.org — opens the bot in your browser; on web, the deep-link parameter sometimes drops, so prefer step 3.
    • Send /start CODE manually — the most reliable option. Click "Copy command", open the bot in any Telegram client, paste, send.
  3. The bot replies "Connected." Click "I sent /start — refresh" in iri.

The link expires in 15 minutes. If you miss it, just generate a new one.

2. Pick a default destination

Where /summary and /capture save notes.

  • Target sphere. Likely personal or whichever sphere holds your daily journal.
  • Folder. Optional, e.g. journal, daily-logs.

3. Try it

In Telegram, type a few thoughts:

오늘 가격 정책 결정함
$9 EA 1년 락
부가세 포함 ₩15,000

Then send /summary 1h. The bot replies with a link to a new iri note that organizes those thoughts into Decisions / Action items / Ideas / Notes.

Two modes (auto vs agent)

Same dichotomy as the Slack integration.

Auto mode (default). iri runs /summary on the server with its own LLM call. Counts toward your monthly server-LLM quota.

Agent mode. Your AI agent reads your Telegram conversation log via MCP (list_bot_messages, available on Pro plans) and decides how to summarize. No iri quota cost; you pay your own agent's tokens.

Group chats

Right now, the iri Telegram bot is 1:1 only. Group chats are explicitly disabled at the BotFather level (setjoingroups: Disable).

Why: Telegram bots in groups can only see messages addressed to them or /-prefixed (privacy mode), and there's no API for past message history. So the "summarize the last 24h of #standup-style group chat" pattern that works on Slack doesn't translate.

Group chat support is on the roadmap pending Telegram API changes. For team threads, use the Slack integration (which supports channel history).

Limits per plan

Free Pro EA
Monthly server-LLM calls (summary + ask) 10 100
Per-summary message cap 500 2,000
Conversation log retention 14 days 30 days

Beyond Free? hello@iri-ai.com — paid access is arranged 1:1 during pilot.

Troubleshooting

Bot says "Welcome to iri" but doesn't connect. The deep link dropped the code (common on web Telegram). Go back to iri, click "Copy command" in the link card, paste the /start XXXX into the bot.

Bot doesn't respond at all. The webhook isn't registered. Open Integrations → Telegram. The Webhook (advanced) section should show a URL. If it shows "No webhook registered yet", click Setup webhook. iri also auto-registers on Generate link.

/start CODE says "That link expired." Codes are valid 15 minutes. Generate a new one.

/summary returns "No messages in the last 24h." You haven't sent any plain-text messages in that window (only commands don't count). Send some thoughts first, then summarize.

/summary says "Set a default sphere first." Open Integrations → Telegram → Defaults → Target sphere.

Quota exceeded. Either wait for the monthly reset, use /find and /capture (no quota), or contact hello@iri-ai.com.

Privacy

  • Plain-text messages you send to the bot are stored in iri's bot_conversations table, RLS-isolated to your workspace.
  • Retention is plan-bound (see above) and enforced by a daily auto-purge cron.
  • The bot token is in env vars on the iri server, not exposed.
  • /unlink removes the Telegram-to-workspace binding immediately. Past notes saved via /summary or /capture stay; the raw conversation log will purge per your plan retention.