2.1. 이메일 연동 및 설정 (Email Settings)
TFlow는 외부 이메일(Google Workspace/Gmail, 일반 IMAP/POP3)을 시스템에 연동하여 무역 관련 메일을 플랫폼 내에서 직접 파악하고 대응할 수 있도록 지원합니다.
⚠️ 자신 소유의 개인 회사 계정 연동은 누구나 가능하나, 그룹 대표메일(sales@company.com 등)의 System-wide IMAP 연동은 최고 관리자(Admin) 권한이 요구될 수 있습니다.
1. Google (Gmail) 계정 연동 방법
안전한 방식의 OAuth2 연동을 통해 Google 계정을 TFlow에 연결합니다.
- TFlow 좌측 메뉴에서 Email(이메일) 탭을 클릭한 뒤, 하단의 Settings(설정) 메뉴로 진입합니다.
- "Connect with Google(구글 연결)" 버튼을 클릭합니다.
- 구글 로그인 팝업이 뜨면, 연동할 업무용 구글 계정을 선택합니다.
- TFlow가 이메일에 접근할 수 있도록 **접근 권한(권한 허용)**을 승인합니다.
- 연동이 완료되면, "Connected(연결됨)" 상태로 표시되며 이메일 동기화를 시작합니다.
1-1. Google 연동 문제 해결 (FAQ)
- Q: "접근 거부됨 (Access Denied) 또는 앱 차단 오류가 발생합니다."
- 에러코드/현상:
OAUTH_ACCESS_DENIED,GOOGLE_APP_BLOCKED - A: 브라우저 팝업 차단이 되어 있는지 확인하세요. 만약 회사가 Google Workspace 환경이라면 관리자가 서드파티 앱(TFlow) 권한을 허용하지 않아 막혀 있는 것일 수 있습니다. 관리자에게 승인을 요청하세요.
- 에러코드/현상:
2. 외부 이메일 (IMAP / POP3) 연동 방법
자체 구축 서버나 타 서비스 업체의 이메일을 사용하는 경우, IMAP 직접 설정을 통해 연동할 수 있습니다.
- Email > Settings(설정) 메뉴에서 "Custom IMAP Setup(사용자 지정 IMAP 설정)" 영역을 찾습니다.
- 다음 필수 정보(
field_ids)를 정확히 입력합니다:- 이메일 주소: 전체 이메일 주소 (예: user@yourdomain.com)
- 비밀번호: '앱 비밀번호(App Password)' 입력을 권장합니다.
- IMAP 설정: 서버 주소, Port 번호(예:
993SSL) - SMTP 설정 (선택): 서버 주소, Port 번호(예:
465SSL /587TLS)
- **Save Integration(연동 저장)**을 클릭하여 연결을 확인합니다.
2-1. IMAP / POP3 연동 문제 해결 (FAQ)
- Q: "IMAP 연동 실패 (Authentication Failed) 에러가 뜹니다."
- 에러코드/현상:
IMAP_AUTH_FAILED,WRONG_PASSWORD_OR_BLOCKED - A: 비밀번호가 틀렸거나, 보안 때문에 이메일 공급자(네이버, 다음 등) 측에서 '보안 수준이 낮은 앱의 외부 접속'을 기본 차단했기 때문입니다. 이메일 사이트 환경설정으로 가셔서 **"IMAP 허용"**을 켜시고, **"앱 비밀번호"**를 생성해서 원래 비밀번호 대신 입력하셔야 합니다.
- 에러코드/현상:
- Q: "최신 메일이 너무 늦게 보이고 싱크가 안 맞습니다."
- 에러코드/현상:
EMAIL_SYNC_DELAY - A: 시스템의 백그라운드 워커 큐가 밀려 순차 동기화가 지연된 경우입니다. 급한 경우 Inbox(받은편지함) 우측 상단의
Sync(동기화)아이콘버튼을 눌러 수동 새로고침을 강제 실행시켜 주시면 됩니다.
- 에러코드/현상: