이메일 수신¶

이메일 수신 스킬은 IMAP 서버에서 이메일을 가져옵니다. 발신자/제목 필터링, 읽지 않은 메일 필터, 첨부파일 S3 추출을 지원합니다.

설정 방법¶

1. 스킬 노드 추가 및 선택¶

스킬 노드를 추가하고 우측 패널에서 이메일 수신을 선택합니다.

2. IMAP 인증 연결¶

인증 탭에서 IMAP 인증 정보를 선택합니다. Gmail의 경우 앱 비밀번호를 사용합니다.

3. 필터 및 옵션 설정¶

설정 탭에서 폴더, 필터 조건, 첨부파일 추출 여부 등을 설정합니다.

파라미터¶

파라미터	필수	설명
folder		메일함 폴더 (기본: `INBOX`)
limit		최대 조회 수 (기본: 10)
email_ids		특정 이메일 ID 목록 (검색 결과에서 전달)
filter_from		발신자 이메일 필터
filter_subject		제목 키워드 필터
unread_only		읽지 않은 메일만 (기본: false)
include_attachments		첨부파일 추출 여부 (기본: false)

인증 정보¶

IMAP 인증이 필요합니다.

항목	설명
host	IMAP 서버 주소 (예: `imap.gmail.com`)
port	포트 번호 (993: SSL)
username	계정 이메일
password	앱 비밀번호
use_ssl	SSL 사용 여부 (기본: true)

출력¶

{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "1234",
        "subject": "주문 확인서",
        "from": "shop@example.com",
        "to": "user@example.com",
        "date": "2026-03-05T10:30:00",
        "body": "주문이 확인되었습니다...",
        "has_attachments": true,
        "attachments": [
          {
            "filename": "invoice.pdf",
            "file_ref": "storage://s3/attachments/...",
            "content_type": "application/pdf",
            "size": 52480
          }
        ]
      }
    ],
    "total": 1,
    "folder": "INBOX"
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.emails }}             → 이메일 목록
{{ $('skill_1').data_content.result.emails[0].subject }}  → 첫 번째 이메일 제목
{{ $('skill_1').data_content.result.emails[0].body }}     → 본문
{{ $('skill_1').data_content.result.total }}               → 총 이메일 수

사용 예시¶

읽지 않은 이메일 자동 처리¶

첨부파일 추출 → AI 분석¶

참고¶

첨부파일은 S3에 자동 업로드되며, storage:// 참조로 다른 스킬에서 사용할 수 있습니다.
UTF-8을 지원하여 한국어, 일본어 등 다국어 이메일을 올바르게 처리합니다.
Gmail 사용 시 앱 비밀번호와 IMAP 활성화가 필요합니다.