레퍼런스노드 레퍼런스트리거트리거
Gmail 트리거
새 이메일이 도착하면 워크플로우를 자동으로 실행합니다.
개요
| 항목 | 내용 |
|---|---|
| 카테고리 | 트리거 |
| 연동 필요 | Gmail OAuth2 인증 |
| 동작 방식 | 폴링 (설정된 간격으로 새 이메일 확인) |
설정 옵션
| 옵션 | 설명 | 필수 |
|---|---|---|
| 이벤트 | 이메일 수신 | ✅ |
| 확인 간격 | 새 이메일 확인 주기 (1분, 5분, 10분, 15분, 30분, 1시간) | |
| 간소화 출력 | 이메일 정보를 간소화된 형태로 반환 | |
| 최대 메시지 수 | 한 번에 가져올 최대 이메일 수 (1~100) |
필터 옵션
| 필터 | 설명 |
|---|---|
| 읽음 상태 | 읽지 않은 이메일만, 읽은 이메일만, 모든 이메일 |
| 라벨 ID | 특정 라벨의 이메일만 (쉼표로 구분, 예: INBOX, IMPORTANT) |
| 보낸 사람 | 특정 발신자의 이메일만 |
| 검색어 | Gmail 검색 문법 사용 (예: has:attachment, subject:주문) |
| 스팸/휴지통 포함 | 스팸 및 휴지통 이메일 포함 여부 |
| 임시 보관함 포함 | 임시 보관함 이메일 포함 여부 |
추가 옵션
간소화 출력을 비활성화하면 아래 옵션을 사용할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| 첨부파일 다운로드 | 이메일 첨부파일을 다운로드 |
| 첨부파일 접두사 | 첨부파일 속성 이름 접두사 (기본: attachment_) |
출력 데이터
| 필드 | 타입 | 설명 |
|---|---|---|
id | string | 메시지 ID |
threadId | string | 스레드 ID |
from | string | 보낸 사람 |
to | string | 받는 사람 |
cc | string | 참조 |
bcc | string | 숨은 참조 |
subject | string | 제목 |
date | datetime | 날짜 |
snippet | string | 미리보기 |
body | string | 본문 |
labelIds | array | 라벨 목록 |
hasAttachments | boolean | 첨부파일 유무 |
attachments | array | 첨부파일 목록 |
활용 예시
주문 이메일 자동 처리
트리거: Gmail 트리거
├── 확인 간격: 5분
├── 필터 - 보낸 사람: [email protected]
├── 필터 - 검색어: subject:주문확인
액션 1: OpenAI
├── 입력: {{trigger.body}}
└── 프롬프트: "이메일에서 주문번호, 상품명, 수량을 JSON으로 추출"
액션 2: 행 생성 (주문 데이터모델)첨부파일 자동 저장
트리거: Gmail 트리거
├── 확인 간격: 10분
├── 간소화 출력: 비활성
├── 옵션 - 첨부파일 다운로드: 활성
├── 필터 - 검색어: has:attachment
액션 1: 조건 분기 (첨부파일 유무)
액션 2: 반복 (첨부파일 목록)
액션 3: Supabase - 파일 업로드
└── 파일 데이터: {{loop.current.data}}고객 문의 자동 분류
트리거: Gmail 트리거
├── 확인 간격: 5분
├── 필터 - 라벨 ID: INBOX
├── 필터 - 읽음 상태: 읽지 않은 이메일만
액션 1: OpenAI
├── 입력: {{trigger.subject}} {{trigger.body}}
└── 프롬프트: "문의 유형 분류: 기술지원/결제/배송/기타"
액션 2: 행 생성 (문의 데이터모델)모범 사례
Gmail OAuth2 인증은 Google Cloud Console에서 OAuth2 클라이언트를 생성한 뒤 연결합니다. Gmail API 권한이 필요합니다.
폴링 간격 설정
- 긴급한 처리가 필요한 경우: 1분 또는 5분
- 일반적인 업무: 15분 또는 30분
- 일일 배치: 1시간
에러 처리
Gmail API 호출 실패 시 재시도하거나 관리자에게 알림을 보내세요.