콘텐츠로 이동

Gmail 트리거

새 이메일이 수신되면 워크플로우를 자동 실행합니다. Google OAuth 인증을 사용하며, 폴링 방식으로 주기적으로 새 메일을 확인합니다.

Gmail 트리거 설정 — OAuth 인증, 폴링 간격


설정

항목 설명 기본값
인증 정보 Google OAuth 인증 -
폴링 간격 새 메일 확인 주기 60초

인증 설정

  1. 프로젝트 설정 > 인증 정보에서 Google OAuth를 추가합니다.
  2. Google 계정 로그인 및 Gmail 접근 권한을 승인합니다.
  3. 트리거의 인증 탭에서 등록한 Google OAuth를 선택합니다.

출력

{
  "text_content": "이메일 본문 내용 (텍스트)",
  "data_content": {
    "from": "sender@example.com",
    "to": "me@example.com",
    "subject": "문의드립니다",
    "date": "2026-03-05T10:30:00Z",
    "snippet": "이메일 본문 미리보기...",
    "attachments": [
      {
        "filename": "document.pdf",
        "mime_type": "application/pdf",
        "size": 125000,
        "storage_ref": "storage://s3/..."
      }
    ]
  }
}

참조

{{ $('trigger').text_content }}                    → 이메일 본문
{{ $('trigger').data_content.from }}               → 발신자 주소
{{ $('trigger').data_content.subject }}            → 제목
{{ $('trigger').data_content.attachments[0] }}     → 첫 번째 첨부파일

활용 예시

이메일 자동 분류 + 알림

워크플로우 예시 — Gmail → 텍스트 분류 → 긴급/일반/스팸 분기

첨부파일 자동 처리

워크플로우 예시 — Gmail → PDF 추출 → AI 에이전트 → Telegram


주의 사항

폴링 간격

기본 60초 간격으로 새 메일을 확인합니다. 이미 확인한 메일은 중복 처리되지 않습니다.

권한 범위

Google OAuth 인증 시 Gmail 읽기 권한이 필요합니다. 첨부파일 다운로드도 동일 권한으로 처리됩니다.