> ## Documentation Index
> Fetch the complete documentation index at: https://help.finerd.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram 봇 연결하기

> finerd Telegram 봇을 공간 하나에 연결하고 읽기 전용 또는 읽기 및 쓰기를 선택한 다음, 채팅으로 지출을 기록하고 돈에 관해 물어봐요.

finerd Telegram 봇 [@finerds\_bot](https://t.me/finerds_bot)을 쓰면 Telegram 채팅에서 기록을 관리할 수 있어요. “커피 85”라고 쓰거나, 음성 메시지나 영수증 사진을 보내거나, 지난달 택시비로 얼마 썼는지 물어볼 수 있고, 검토가 필요한 거래가 생기면 메시지를 받아요. 봇은 finerd 공간 하나에 연결되고, 그 공간을 읽기만 할지 변경도 할지 내가 선택해요.

봇은 Free 플랜에서도 쓸 수 있어요. finerd에서 무료인 기능은 봇에서도 모두 무료이고, Pro 기능에는 연결하는 공간에 **Pro**가 있어야 해요. 연결은 Telegram과 브라우저의 finerd 페이지에서 하고, 연결 해제는 채팅에서 `/logout`으로 해요. finerd 웹, Android, iOS 앱에는 Telegram 설정이 없어요. Claude나 ChatGPT 같은 AI 어시스턴트는 finerd MCP를 통해 다른 방식으로 연결해요. [AI로 재정 관리하기](https://help.finerd.ai/ko/ai.md)를 참고하세요.

## 봇 연결하기

1. Telegram에서 봇을 열어요.

   > [tab] Web
   >
   > 브라우저에서 [t.me/finerds\_bot](https://t.me/finerds_bot)을 연 다음 Telegram으로 열거나, Telegram에서 **finerds\_bot**을 검색해요. 봇 이름은 **OnlyFinerds Bot**이에요.

   > [tab] Android
   >
   > **더 보기**를 열고 **연결** 아래의 **Telegram 봇**을 선택해요. 봇 페이지가 열리면 Telegram에서 열어요.

   > [tab] iOS
   >
   > **더 보기**를 열고 **연결** 아래의 **Telegram 봇**을 선택해요. Telegram이 설치되어 있으면 봇이 Telegram에서 열려요. 설치되어 있지 않으면 Safari에 **START BOT** 버튼과 Telegram 다운로드 링크가 있는 봇 페이지가 표시돼요.
   >
   > ![finerd iOS의 More 탭, Connections 섹션: Institutions, Family access, Telegram Bot, Emails, Apple Wallet.](https://mintcdn.com/finerdai/VKs44KzasmsahKpA/images/ai/connect-telegram/ios-more-telegram-bot.png?fit=max\&auto=format\&n=VKs44KzasmsahKpA\&q=85\&s=6ccf20dc6c2a765beecea54dca0dafb9)
   >
   > Telegram 봇은 더 보기의 연결 아래에 있어요.
   >
   > ![OnlyFinerds Bot(@finerds\_bot)의 Telegram 웹 페이지와 START BOT 버튼.](https://mintcdn.com/finerdai/VKs44KzasmsahKpA/images/ai/connect-telegram/ios-bot-page.png?fit=max\&auto=format\&n=VKs44KzasmsahKpA\&q=85\&s=8e8c2ba1de3cf208f11a806509454b56)
   >
   > Telegram이 설치되어 있지 않으면 Safari에 봇 페이지가 표시돼요.

2. 봇을 시작해요. 봇의 첫 메시지에는 9개 언어로 된 인사 버튼이 있어요. 내 언어를 선택하거나 직접 인사말을 써요(한국어 버튼은 없으니 “안녕하세요”처럼 보내면 돼요). 그러면 봇이 그 언어로 메시지를 써요.

3. 봇이 어떤 은행을 쓰는지 물으면 **I have an account**를 선택해요. 이 버튼을 비롯해 봇의 버튼은 영어로 표시되고, 이 문서에 인용한 봇의 답장도 영어 원문 그대로예요.

4. **Sign in to Finerd**를 선택해요. 브라우저에서 finerd 페이지가 열리면, finerd가 요청할 경우 로그인해요. 봇은 그 페이지에 로그인된 finerd 계정에 연결되므로, 브라우저에 다른 사람의 계정이 로그인되어 있다면 먼저 로그아웃하세요.

5. **finerd 공간**에서 봇이 작업할 공간을 선택해요. **접근 수준 선택**에서 **읽기 전용** 또는 **읽기 및 쓰기**를 선택해요([공간과 접근 수준 선택하기](#space-access) 참고). 그런 다음 **허용하고 계속**을 선택해요.

   ![finerd의 Connect Telegram 페이지: Personal로 설정된 Finerd space, Read only가 선택된 Choose access level과 Read & Write, 암호화와 AI 제공업체에 관한 경고, Allow and continue.](https://mintcdn.com/finerdai/VKs44KzasmsahKpA/images/ai/connect-telegram/web-connect-telegram.png?fit=max\&auto=format\&n=VKs44KzasmsahKpA\&q=85\&s=29479572f5fdd3dea7804b0b25fa45b9)

   공간과 접근 수준을 고른 다음 허용하고 계속을 선택해요.

6. 페이지에 **동의가 기록되었어요**라고 표시돼요. **Telegram으로 돌아가기**를 선택해요. 봇은 내가 Telegram으로 돌아간 뒤에야 접근 권한을 얻어요. 봇이 ✅ 표시와 함께 완료를 알리고, 무엇을 쓰면 되는지 몇 가지 예를 보여 줘요.

**Sign in to Finerd** 버튼은 10분 동안 한 번만 쓸 수 있어요. 페이지가 열리지 않거나 링크가 만료됐다고 나오면 채팅에 “new link”라고 쓰고 새 버튼을 사용하세요.

**아직 finerd 계정이 없나요?** **I have an account**를 선택하지 말고 봇의 질문에 답하세요. 봇이 이메일을 묻고 그 주소로 로그인 코드를 보낸 다음, 통화와 도시를 묻고 finerd 계정을 만들어 줘요. 그러면 finerd 페이지를 열 필요 없이 봇이 새 개인 공간에 **읽기 및 쓰기**로 연결돼요.

## 공간과 접근 수준 선택하기

봇은 finerd 페이지에서 선택한 공간 하나에서만 작업해요. **finerd 공간**에는 내 개인 공간과 비즈니스 공간이 나오고, 현재 finerd에서 열려 있는 공간이 선택되어 있어요. 데모 공간은 목록에 없어요. 채팅에서 기록하는 모든 내용, 모든 답변, 모든 알림은 그 공간에 속해요.

![Connect Telegram 페이지의 Finerd space 목록: Personal(선택됨), Business인 Help test Migration과 Help test Studio.](https://mintcdn.com/finerdai/VKs44KzasmsahKpA/images/ai/connect-telegram/web-choose-space.png?fit=max\&auto=format\&n=VKs44KzasmsahKpA\&q=85\&s=9148a23f316813ceb7fe9dfef4a94223)

finerd 공간에는 개인 공간과 비즈니스 공간이 나와요.

| 접근 권한 | 봇이 할 수 있는 일 |
| - | - |
| **읽기 전용**(처음에 선택됨) | 공간의 금융 데이터를 보고 잔액, 거래, 리포트, 예산, 채무, 영수증에 관한 질문에 답해요. |
| **읽기 및 쓰기** | 지출과 이체도 기록하고, 거래의 카테고리, 태그, 가맹점, 메모, 날짜를 바꾸고, 거래를 나누고, 검토 완료나 가족으로 표시하고, 카테고리, 태그, 가맹점, 예산, 계좌를 만들고, 계좌를 보관해요. |

어느 접근 수준이든 봇은 거래를 삭제하거나 결제 금액을 바꿀 수 없어요. 이런 작업은 finerd 앱에서 하세요. 봇을 통한 변경은 finerd에 바로 저장돼요.

접근을 허용하기 전에 페이지에 경고가 표시돼요. Telegram은 봇과의 채팅에 종단 간 암호화를 쓰지 않고, 봇은 답변을 만들기 위해 내 요청과 그 결과를 AI 제공업체로 보낸다는 내용이에요. finerd는 내 데이터로 학습하지 않는 제공업체만 사용해요.

봇을 다른 공간으로 옮기거나 접근 수준을 바꾸려면 `/logout`을 보낸 다음 `/start`를 보내고, **I have an account**를 선택해 다시 로그인하면서 원하는 공간과 접근 수준을 고르세요.

finerd MCP로 연결한 AI 어시스턴트는 다르게 작동해요. 연결 하나로 내가 속한 모든 공간을 쓸 수 있어요. [어시스턴트가 볼 수 있는 공간](https://help.finerd.ai/ko/ai/manage-access.md#spaces)을 참고하세요.

## 채팅에서 할 수 있는 일

친구에게 메시지를 보내듯 봇에게 쓰세요. 봇은 내가 마지막으로 보낸 메시지의 언어로 답해요.

* **지출 기록**(**읽기 및 쓰기**): “커피 85”처럼 쓰거나, 음성 메시지나 영수증 사진을 보내요.
* **돈에 관해 묻기**: “9월에 택시비로 얼마 썼어요?”처럼 묻거나, 잔액, 리포트, 예산, 채무에 관해 물어봐요.
* **은행이나 계좌 추가**: “connect mono”, “connect privat”, “add a manual account”라고 써요. 다른 은행은 브라우저에서 열리는 finerd 페이지에서 연결해요. [은행 연결하기](https://help.finerd.ai/ko/institutions/connect-institution.md)를 참고하세요.
* **새 거래 검토**: 공간에 검토가 필요하거나 카테고리가 필요한 거래가 생기면, 봇이 **Open in Finerd** 버튼이 있는 메시지를 보내요. **읽기 및 쓰기**에서는 메시지에 **✅ Mark as reviewed**도 있어요.

[가족 가계부](https://help.finerd.ai/ko/family-accounting.md)를 쓰고 봇에 **읽기 및 쓰기** 권한이 있으면, 이 메시지에 **👨‍👩‍👦 Mark as family**도 있어요. 이 버튼은 거래를 가족으로 표시해 파트너의 공간에 사본을 추가하고, 거래를 검토 완료로 표시해요. 그 뒤 버튼은 **↩ Remove from family**로 바뀌어요. 표시를 없애면 파트너의 사본이 삭제되고, 파트너가 그 사본에 한 변경도 함께 사라져요. 봇은 나눈 거래, 계좌 간 이체, 공동 계좌의 거래는 가족으로 표시할 수 없어요. 이런 거래는 finerd에서 바꾸세요.

봇은 다음 명령어도 알아들어요.

| 명령어 | 하는 일 |
| - | - |
| `/start` | finerd 계정을 연결하거나, 하던 단계를 이어서 진행해요 |
| `/help` | 명령어 목록을 보여 줘요 |
| `/accounts` | 내 계좌를 보여 줘요 |
| `/banks` | 연결된 은행을 보여 줘요 |
| `/mode` | 봇이 보낼 메시지를 선택해요: **Everything**, **Only family questions**, **Only review questions** |
| `/cancel` | 현재 단계를 잠시 멈춰요 |
| `/logout` | finerd 계정에서 봇 연결을 해제해요 |

채팅에 은행 비밀번호나 은행 인증 코드를 절대 보내지 마세요. 로그인할 때 봇에게 필요한 것은 이메일뿐이에요.

## 봇 연결 해제하기

봇과의 채팅에서 `/logout`을 보내요. 봇이 “You are logged out of Finerd in this chat”이라고 답하고 내 공간에서 작업을 멈춰요. finerd 앱에서는 봇 연결을 해제할 수 없어요.

누군가 **변경 취소**로 내 finerd 계정의 이메일 변경을 취소할 때도 봇 연결이 해제돼요. [내가 이메일을 바꾸지 않았다면](https://help.finerd.ai/ko/account/profile-and-sign-in-methods.md#undo)을 참고하세요. 봇을 다시 쓰려면 `/start`를 보내고 로그인하세요.

Telegram으로 finerd에 로그인하는 기능은 봇과 별개예요. `/logout`을 보내도 Telegram 로그인은 없어지지 않고, Telegram 로그인을 연결 해제해도 봇은 없어지지 않아요. [프로필과 로그인 방법 관리하기](https://help.finerd.ai/ko/account/profile-and-sign-in-methods.md#disconnect)를 참고하세요.

봇이 이미 한 변경은 finerd에 남고, 채팅 기록은 Telegram에 남아요. Telegram 계정 하나는 한 번에 finerd 계정 하나에만 연결돼요. 계정을 바꾸려면 `/logout`을 보낸 다음 `/start`를 보내고 다른 계정으로 로그인하세요.

연결된 공간에서 Pro가 끝나도 봇은 연결된 상태로 남고, 무료인 기능은 모두 계속 동작하며 알림도 계속 보내요. Pro 기능이 필요한 요청에는 그 기능에 유료 플랜이 필요하다는 답이 업그레이드 링크와 함께 와요. [finerd 구독 관리하기](https://help.finerd.ai/ko/account/manage-subscription.md)를 참고하세요.

## 연결 문제 해결하기

| 표시되는 내용 | 해결 방법 |
| - | - |
| finerd 페이지의 **잘못된 연결 링크**, 또는 “유효하지 않은 연결 링크예요” | 채팅으로 돌아가 “new link”라고 쓴 다음 새 **Sign in to Finerd** 버튼을 사용하세요. |
| “연결 링크가 만료되었어요” 또는 “이미 사용한 연결 링크예요” | 링크는 10분 동안 한 번만 쓸 수 있어요. 채팅에 “new link”라고 쓰세요. |
| “Telegram connections are not available for this account or space” | finerd가 이 계정을 선택한 공간에 연결할 수 없어요. 내가 속한 다른 공간을 선택하세요. 계속 이런 일이 생기면 [고객 지원에 문의하세요](https://help.finerd.ai/ko/contact-us.md). |
| “연결 시도가 너무 많아요” | 잠시 기다린 다음 채팅에 “new link”라고 쓰세요. |
| Telegram으로 돌아왔는데 봇이 답하지 않음 | `/start`를 보내고, 봇이 요청하면 다시 로그인하세요. |
| “Your finerd connection is no longer available. Please reconnect it.” | 봇과 내 계정의 연결이 끊겼어요. 예를 들어 이메일 변경이 취소된 경우예요. `/start`를 보내고 다시 로그인하세요. |
| “That action needs write access” 또는 “Changes need edit permission” | 봇이 **읽기 전용**이에요. `/logout`을 보낸 다음 `/start`를 보내고, 로그인할 때 **읽기 및 쓰기**를 선택하세요. |
| 봇이 기능에 유료 플랜이 필요하다고 답함 | Pro 기능을 쓰는 요청인데, 연결된 공간에 Pro가 없어요(비즈니스 공간이라면 내가 유료 이용 인원에 포함되어 있지 않아요). [업그레이드](https://help.finerd.ai/ko/account/manage-subscription.md)하거나 봇을 Pro가 있는 공간에 연결하세요. |

문제가 반복되면 시각과 봇의 답장을 적어 [고객 지원에 문의하세요](https://help.finerd.ai/ko/contact-us.md).

## 관련 문서

* [AI로 재정 관리하기](https://help.finerd.ai/ko/ai.md)
* [AI 접근 권한 관리하기](https://help.finerd.ai/ko/ai/manage-access.md)
* [프로필과 로그인 방법 관리하기](https://help.finerd.ai/ko/account/profile-and-sign-in-methods.md)
* [가족 가계부 설정하기](https://help.finerd.ai/ko/family-accounting.md)
* [가져온 거래 검토하기](https://help.finerd.ai/ko/transactions/review-imported-transactions.md)
* [finerd 구독 관리하기](https://help.finerd.ai/ko/account/manage-subscription.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.