🔌 외부 계정 연동 및 파일 자동화

설정 → 연결된 계정에서 비즈니스 도구를 한 번만 연동해 두면, AMBA가 사내 문서, 스프레드시트, 계약서 등을 프로젝트로 자동 수집합니다. 매번 수동으로 파일을 업로드할 필요가 없습니다.

연결된 계정은 프로세스가 사용합니다. Telegram 그룹이나 Drive 폴더가 프로젝트의 파일 소스가 되고, 보고서는 여러분의 Telegram 봇을 통해 받는 사람에게 전달됩니다.

---

⚡ 개요: 3가지 파일 연동 방식

AMBA는 기업의 업무 환경에 맞춰 3가지 안전하고 간편한 파일 연동 방식을 제공합니다:

연동 서비스	최적 활용 분야	설정 소요 시간	주요 혜택
📁 Google Drive	팀 공유 드라이브, 클라우드 재무제표 및 계약서	30초	1-클릭 구글 로그인 — Drive 폴더를 직접 탐색하고 필요한 파일을 선택 수집.
✈️ Telegram Bot	단체 채팅방을 통한 영수증, 세금계산서, 현장 보고서 수집	1분	24시간 자동 수집 — 직원이 단톡방에 파일을 올리면 AMBA가 즉시 감지하여 저장.
💻 로컬 동기화 폴더	데스크톱용 Google Drive, OneDrive, Dropbox	15초	클라우드 지연 없는 즉각 동기화 — PC에 이미 동기화된 사내 폴더와 즉시 연결.

한 번 설정으로 모든 프로젝트에 활용

글로벌 설정에서 계정을 한 번만 연동하면, 이후 생성하는 모든 경영진 프로젝트에서 재인증 없이 자유롭게 활용할 수 있습니다.

---

1. Google Drive 연동 (1-클릭 간편 설정)

Google Drive를 연동하면 사내 스프레드시트, 계약서 PDF, 공유 폴더를 프로젝트로 가져오거나, 회계 담당자가 Drive 폴더에 넣는 모든 파일을 프로세스가 자동으로 모으도록 할 수 있습니다.

단계별 설정 방법:

1. AMBA 왼쪽 사이드바에서 설정 메뉴를 열고, 연결된 계정 탭을 선택합니다.
2. 연결된 계정 추가 → Google Drive를 클릭합니다.
3. Google로 로그인을 클릭합니다.
4. 기본 브라우저에서 Google의 로그인 페이지가 열립니다. 로그인하고 권한(Drive 파일 읽기, 이메일 주소 보기)을 확인한 뒤 계속을 클릭합니다. *"Google에서 확인하지 않은 앱"*이 표시되면 고급 → AMBA(으)로 이동을 클릭하세요. 앱이 Google 테스트 단계에 있는 동안 표시됩니다.
5. 브라우저에 Authentication Successful이 표시되면 AMBA로 돌아갑니다. 계정 이름과 이메일이 표시되며, 로그인 정보는 운영체제 키체인에 저장됩니다.

Windows에서 처음 로그인할 때

열리는 브라우저는 기본 브라우저(Edge, Chrome 등)입니다. 로그인하는 동안 AMBA는 몇 분간 127.0.0.1에서만 대기하므로 보통 Windows Defender 방화벽 확인 창이 뜨지 않습니다. 보안 프로그램이 묻는다면 개인 네트워크에 대해 허용을 선택하세요. 로그인은 5분 안에 완료해야 합니다.

로그인에 실패할 때

표시 내용	해결 방법
액세스 차단됨: AMBA에서 Google 인증 절차를 완료하지 않았습니다	AMBA가 테스트 중인 동안에는 테스트 사용자 목록에 있는 Google 계정만 로그인할 수 있습니다. AMBA 팀에 계정 추가를 요청한 뒤 다시 시도하세요.
오류 400: redirect_uri_mismatch 또는 "유효한 Google 로그인 설정이 없습니다"	사용 중인 AMBA에 공식 로그인 설정이 없습니다. 공식 릴리스를 설치하거나 **수동 API 구성 (고급)**에 회사의 Desktop app 클라이언트를 입력하세요.
이 앱은 차단되었습니다 (회사 Google Workspace)	Workspace 관리자가 AMBA를 허용해야 합니다.
5분이 지나도 응답이 없음	브라우저 탭을 닫고 Google로 로그인을 다시 클릭하세요.

"다시 로그인 필요"

Google은 저장된 로그인을 더 이상 허용하지 않을 수 있습니다. AMBA가 테스트 중인 동안에는 7일 후 만료되며, Google 계정에서 AMBA의 액세스를 삭제하거나 비밀번호를 바꿔도 중단됩니다. 그러면 AMBA는 계정을 다시 로그인 필요로 표시하고 연결된 계정에 배너를 표시합니다. 그 계정에서 파일을 읽는 프로세스의 카드에는 조치 필요: Google에 다시 로그인해야 합니다와 다시 로그인 버튼이 나타납니다. 같은 Google 계정으로 로그인하면 프로세스가 같은 폴더로 계속 실행됩니다.

파일 소스로서의 Drive 폴더

프로세스가 파일을 모으는 Drive 폴더는 프로젝트의 파일 소스입니다(프로세스 참고). AMBA는 실행 중 약 1분마다 확인합니다:

• 첫 확인 때 폴더에 이미 있는 파일을 한 번 가져올 수 있습니다. 이후에는 새 파일이나 변경된 파일만 받습니다.
• 하위 폴더도 3단계까지 읽습니다(예: 10월/07-10). 하위 폴더 이름은 파일이 어느 영업일 것인지 판단하는 데 도움이 됩니다.
• Google 스프레드시트, 문서, 프레젠테이션은 .xlsx, .docx, .pptx로 받습니다. 바로가기는 원본 파일을 따라가며, 삭제되었거나 공유되지 않은 파일의 바로가기와 Google 설문지는 메모와 함께 건너뜁니다.
• 파일이 많은 폴더도 모든 페이지를 읽으며, 같은 내용의 파일이 날짜 폴더에 이미 있으면 두 번 저장하지 않습니다.

이전 AMBA가 감시하던 Drive 폴더는 자동으로 파일 소스로 옮겨졌습니다. 새 Drive 폴더를 파일 소스로 추가하는 기능은 이 버전에서 아직 지원하지 않습니다.

기업용 Google Cloud 전용 키 설정 (고급)

AMBA의 클라이언트 대신 회사 자체 Google Cloud OAuth 클라이언트가 필요하다면 Desktop app 유형의 클라이언트를 만들고, 대화 상자의 **수동 API 구성 (고급)**에 Client ID와 Secret을 입력하세요.

---

2. Telegram 연동 (단체 채팅방 자동 파일 수집)

회계팀, 영업팀, 현장 관리자가 텔레그램 단체 채팅방에 영수증 사진이나 엑셀 파일을 전송하기만 하면, AMBA가 백그라운드에서 실시간으로 감지하여 지정된 프로젝트 폴더로 자동 다운로드합니다.

Telegram 단체방"회계팀 영수증 제출방"

직원이 영수증 사진 및 엑셀 전송

봇 자동 수집

AMBA Desktop실시간 자동 수집

백그라운드에서 즉시 수신 및 검증

로컬 금고 저장

프로젝트 폴더sources/<group>/<YYYY-MM-DD>/

Agent의 즉각적인 대사 분석 대기

단계별 설정 방법:

1단계: 봇 생성 (소요 시간: 약 1분)

1. Telegram 앱을 열고 검색창에 @BotFather를 검색한 후 **시작(Start)**을 누릅니다.
2. /newbot 명령어를 입력하고 안내에 따라 진행합니다:
   • 봇 이름 입력 (예: Acme Assistant).
   • 봇 사용자명 입력 (반드시 bot으로 끝나야 함, 예: AcmeExecutiveBot).
3. @BotFather가 발급해 주는 API Token(예: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ) 문자열을 복사합니다.

2단계: AMBA에 봇 등록

1. AMBA에서 설정 → 연결된 계정 → 연결된 계정 추가 → Telegram을 선택합니다.
2. 복사한 API Token을 입력창에 붙여넣고 테스트 및 자동 감지를 클릭합니다.
3. 봇 이름이 정상 확인되면 계정 저장을 클릭합니다.

3단계: 단체 채팅방에 봇 초대

1. 파일을 수집할 Telegram 단체방(예: 회계팀, 물류센터, 경영진 보고)을 엽니다.
2. 방금 생성한 봇을 멤버로 초대합니다.
3. 중요: 단체방 설정에서 봇을 **관리자(Admin)**로 지정해 주세요(메시지 읽기/Read Messages 권한만 허용하면 됩니다). 이를 통해 봇이 첨부 문서를 안전하게 감지할 수 있습니다.

4단계: 프로세스에서 그룹 사용하기

1. 프로젝트 열기 → 프로세스 탭.
2. 프로세스를 쓰면서 그룹을 평소 부르는 이름으로 적습니다. 예: “매일 오후 2시에 회계팀에서 보고서를 모으고…”.
3. AMBA가 어느 그룹인지 묻고, 봇이 본 그룹을 이름으로 보여 줍니다. 해당 그룹을 누르세요. 봇이 아직 보지 못한 그룹이면 새 Telegram 그룹 연결을 누르고, 그룹에 메시지를 하나 보낸 뒤 새로고침을 누릅니다.

그룹은 프로젝트의 파일 소스가 되며, 이후 그룹에 보낸 파일은 약 1분 안에 프로젝트의 소스로 들어와 영업일별로 표시됩니다. 이전의 “문서 가져오기 → Telegram → 수집 규칙 저장” 규칙은 자동으로 파일 소스로 옮겨졌습니다.

---

3. 로컬 동기화 폴더 연동 (데스크톱 드라이브)

Google Drive for Desktop, Microsoft OneDrive, 또는 Dropbox를 사용 중이시라면, 클라우드 파일이 이미 PC의 로컬 디스크(예: ~/Google Drive/ 또는 C:\Users\Name\OneDrive\)에 실시간 동기화되어 있습니다.

이 폴더를 연동하면 최고의 편의성과 속도를 누릴 수 있습니다:

• ⚡ 초고속 동기화: 인터넷 업로드/다운로드 대기 시간 0초.
• 🔒 100% 오프라인 지원: 인터넷 연결이 끊겨도 완벽히 작동.
• ♾️ API 트래픽 제한 없음: 대용량 기가바이트 파일도 즉시 처리.

단계별 설정 방법:

1. AMBA에서 설정 → 연결된 계정 → 연결된 계정 추가 → 로컬 클라우드 폴더를 엽니다.
2. **찾아보기(Browse)**를 눌러 PC에 있는 클라우드 동기화 폴더를 선택합니다.
3. 계정 저장을 클릭하면 즉시 완료됩니다!

---

4. 프로젝트 내 파일 활용 및 결과물 발송

계정 연동이 완료되면 직관적인 인터페이스를 통해 문서를 손쉽게 분석하고 외부로 전달할 수 있습니다.

📥 1. 직접 파일 추가하기

1. 프로젝트를 엽니다.
2. 파일 트리에서 섹션의 ⋯ 메뉴를 열고 파일 업로드를 선택합니다.
3. 컴퓨터의 파일을 고르면 바로 프로젝트에 추가되어 에이전트가 사용할 수 있습니다.

Telegram 그룹과 Drive 폴더의 파일은 프로젝트의 파일 소스가 되면 자동으로 소스(sources/<소스>/<YYYY-MM-DD>/)에 들어옵니다(프로세스 참고).

🤖 2. 자동 문서 인식 및 심층 분석

가져온 문서를 일일이 열어보거나 요약할 필요가 없습니다:

• 스프레드시트(.xlsx, .csv)는 회계 수식 구조를 보존한 채 즉시 색인됩니다.
• 스캔된 PDF나 영수증 이미지는 내장된 Apple Vision OCR로 정밀하게 텍스트가 추출됩니다.
• Word 문서(.docx) 및 슬라이드(.pptx)도 즉시 심층 분석에 활용됩니다.
• 채팅창에 자연어로 요청하기만 하세요: "소스의 재무 보고서를 요약해 줘", "방금 수집된 세금계산서의 총 공급가액을 집계해 줘".

📤 3. 결과 보내기

보고서는 프로세스를 통해 받는 사람에게 전달됩니다. 프로세스의 보내기 단계가 요약과 만든 파일을 여러분의 Telegram 봇으로 개인이나 그룹에 보냅니다(예: “…4시에 요약해서 나에게 보내 줘”). 이전의 원클릭 “산출물 발송” 버튼과 Drive·로컬 폴더 발송 대상은 제거되었습니다.

---

🛡️ 엔터프라이즈급 데이터 보안 및 기밀성

AMBA는 철저한 로컬 퍼스트(Local-First) 철학에 따라 설계되었습니다:

• OS 키체인 저장: 봇 토큰과 Google 인증 정보는 운영체제 키체인(macOS Keychain, Windows Credential Manager, Linux의 Secret Service)에만 저장됩니다. 평문으로 저장되지 않으며, 키체인을 사용할 수 없으면 연결이 저장되지 않습니다.
• 100% 로컬 데이터 처리: 문서는 제3자의 중간 서버를 전혀 거치지 않으며, 오직 사용자의 PC와 공식 서비스(Google Drive / Telegram) 간에만 직접 전송됩니다.
• 외부 수신 포트 없음: AMBA는 웹 서버를 실행하지 않습니다. Google 로그인 중에만 브라우저의 응답을 받기 위해 127.0.0.1(사용자 PC 내부에서만 접근 가능)에서 대기하며, 직후 그 포트를 닫습니다.
• 샌드박스 프로젝트 격리: AI 에이전트는 사용자가 지정한 프로젝트 폴더 내의 파일만 읽고 쓸 수 있으며, PC 내의 다른 개인 파일에는 절대 접근할 수 없습니다.