iri 문서

Telegram 통합

iri Telegram 봇은 1:1 톡. 하루 동안 떠오른 거 봇한테 입력하면 워크스페이스의 conversation 로그에 모든 메시지가 저장. /summary로 그 로그를 구조화된 iri 노트로 변환.

이게 모바일 우선 캡처 surface. 회의 사이, 지하철, 자기 전 같이 노트 앱 열기 귀찮을 때 쓰세요.

가능한 것

명령어 동작 쿼터 차감?
(일반 텍스트) conversation 로그에 저장. 40자 이상이면 봇이 조용히 ✓ saved 응답. 아니오
/summary [hours] 최근 N시간 메시지를 구조화된 iri 노트로 (결정 / 액션 / 아이디어 / 메모). 기본 24h. 6h, 1d, 30m 가능. 예 (summary 1회)
/ask <질문> 워크스페이스 RAG 답변, 출처 포함 예 (ask 1회)
/find <검색어> top 5 매칭 노트 + 링크 아니오
/capture <텍스트> 즉시 노트 저장 (conversation 로그 건너뜀) 아니오
/recent 워크스페이스 최근 노트 5개 아니오
/help 명령어 가이드 아니오
/unlink 이 Telegram을 iri에서 분리 아니오

Conversation 로그 보존은 플랜별: Free 14일, Pro EA 30일, Team 90일. 그 이후 raw 메시지는 자동 삭제. /summary나 /capture로 명시적으로 저장한 노트는 워크스페이스에 영구 보관.

셋업

워크스페이스 admin 또는 manager 권한 필요.

1. Telegram을 iri 워크스페이스에 연결

  1. iri에서: Workspace → Integrations → Telegram → Generate link.
  2. iri가 3가지 연결 옵션 표시. Telegram 클라이언트에 맞는 거 사용:
    • Open in Telegram (버튼) — 데스크톱/모바일 Telegram 앱에서 동작.
    • Open in web.telegram.org — 브라우저에서 봇 열기. 웹은 deep link 파라미터가 가끔 떨어지니 step 3 추천.
    • /start CODE 수동 전송 — 가장 안정적. "Copy command" 클릭, 어떤 Telegram 클라이언트든 봇 열고 붙여넣기 + 보내기.
  3. 봇이 "Connected." 응답. iri에서 "I sent /start — refresh" 클릭.

링크는 15분 만료. 놓치면 새로 generate.

2. 기본 destination 지정

/summary와 /capture가 노트 저장할 곳.

  • Target sphere. personal이나 일일 저널용 sphere가 일반적.
  • Folder. 선택, 예: journal, daily-logs.

3. 시도

Telegram에서 생각 몇 개 입력:

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

/summary 1h 보냄. 봇이 그 생각들을 결정 / 액션 / 아이디어 / 메모로 정리한 새 iri 노트 링크 응답.

두 가지 모드 (auto vs agent)

Slack 통합과 동일한 dichotomy.

Auto 모드 (기본). iri가 서버에서 자체 LLM 호출로 /summary. 월간 쿼터에 차감.

Agent 모드. 본인 AI 에이전트가 MCP로 Telegram conversation 로그 읽고 (list_bot_messages, Pro 플랜) 본인이 요약 결정. iri 쿼터 차감 안 함; 본인 에이전트 토큰 사용.

그룹 채팅

지금은 iri Telegram 봇은 1:1 only. BotFather 레벨에서 그룹 채팅 명시적 비활성 (setjoingroups: Disable).

이유: Telegram 그룹 봇은 본인 멘션이나 /-prefix 메시지만 볼 수 있고 (privacy mode), 과거 메시지 히스토리 API 없음. 그래서 Slack에서 잘 되는 "#standup 그룹 24시간 요약" 패턴이 Telegram에선 동작 안 함.

그룹 채팅 지원은 Telegram API 변경 대기 중. 팀 스레드는 Slack 통합 (채널 히스토리 지원).

플랜별 한도

Free Pro EA
월 server-LLM (summary + ask) 10 100
Per-summary 메시지 cap 500 2,000
Conversation 로그 보존 14일 30일

Free 이상은? info@iri-ai.com — 파일럿 동안 유료 액세스는 1:1로.

Troubleshooting

봇이 "Welcome to iri" 말하는데 연결 안 됨. Deep link가 코드를 떨어뜨림 (웹 Telegram 흔함). iri로 돌아가서 link 카드의 "Copy command" 클릭, /start XXXX를 봇에 붙여넣기.

봇이 아예 응답 안 함. Webhook 등록 안 됨. Integrations → Telegram 열기. Webhook (advanced) 섹션에 URL 표시돼야 함. "No webhook registered yet" 떠있으면 Setup webhook 클릭. iri는 Generate link 누르면 자동 등록.

/start CODE가 "That link expired." 코드는 15분 valid. 새로 generate.

/summary가 "No messages in the last 24h." 그 시간 동안 일반 텍스트 메시지 안 보냄 (명령어만 보낸 건 안 셈). 생각 몇 개 보내고 다시 요약.

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

쿼터 초과. 월별 reset 기다리거나, /find와 /capture 사용 (쿼터 없음), 또는 info@iri-ai.com.

개인정보

  • 봇한테 보낸 일반 텍스트 메시지는 iri의 bot_conversations 테이블에 워크스페이스 RLS 격리로 저장.
  • 보존은 플랜별 (위 표) + 매일 auto-purge cron으로 강제.
  • 봇 토큰은 iri 서버 env vars, 노출 안 됨.
  • /unlink → Telegram-워크스페이스 binding 즉시 제거. /summary나 /capture로 저장한 과거 노트는 유지; raw conversation 로그는 플랜 보존 기간대로 purge.