Gmail 노드 Message 작업 문서
Message 작업을 사용하여 Gmail에서 메시지를 발송, 답장, 삭제, 읽음/읽지 않음 표시, 라벨 추가/제거하거나 메시지를 조회합니다. 이 노드는 AI 에이전트 도구 호출에 대한 사람 검토 단계로 사용할 수 있습니다.
Message 작업을 사용하여 Gmail에서 메시지를 발송, 답장, 삭제, 읽음/읽지 않음 표시, 라벨 추가/제거하거나 메시지를 조회합니다. Gmail 노드 자체에 대한 자세한 내용은 Gmail 노드를 참조하세요.
이 노드는 AI 에이전트 도구 호출에 대한 사람 검토 단계로 사용할 수 있습니다. 이 방식으로 구성하면 AI 에이전트가 감독이 필요한 도구를 실행하기 전에 이 서비스를 통해 사람의 승인을 요청하며 일시 중지됩니다. 자세한 내용은 AI 도구 호출을 위한 Human-in-the-loop을 참조하세요.
메시지에 라벨 추가#
이 작업을 사용하여 메시지에 하나 이상의 라벨을 추가합니다.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Add Label을 선택하세요.
- Message ID: 라벨을 추가할 메시지의 ID를 입력하세요.
- Label Names or IDs: 추가할 라벨 이름을 선택하거나 표현식으로 ID를 지정하세요. 드롭다운은 선택한 자격 증명을 기반으로 채워집니다.
자세한 내용은 Gmail API Method: users.messages.modify 문서를 참조하세요.
메시지 삭제#
이 작업을 사용하여 메시지를 즉시 영구 삭제합니다.
이 작업은 취소할 수 없습니다. 복구 가능한 삭제를 원하면 대신 Thread Trash 작업을 사용하세요.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Delete를 선택하세요.
- Message ID: 삭제할 메시지의 ID를 입력하세요.
자세한 내용은 Gmail API Method: users.messages.delete 문서를 참조하세요.
메시지 조회#
이 작업을 사용하여 단일 메시지를 조회합니다.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Get을 선택하세요.
- Message ID: 조회할 메시지의 ID를 입력하세요.
- Simplify: 간소화된 응답을 반환할지(켜기) 또는 원시 데이터를 반환할지(끄기) 선택하세요. 기본값은 켜기입니다.
- 이는 API 호출의
format을metadata로 설정하는 것과 동일하며, 이메일 메시지 ID, 라벨, From, To, CC, BCC, Subject를 포함한 이메일 헤더를 반환합니다.
- 이는 API 호출의
자세한 내용은 Gmail API Method: users.messages.get 문서를 참조하세요.
여러 메시지 조회#
이 작업을 사용하여 두 개 이상의 메시지를 조회합니다.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Get Many를 선택하세요.
- Return All: 모든 메시지를 반환할지(켜기) 또는 설정된 한도까지만 반환할지(끄기) 선택하세요.
- Limit: 반환할 최대 메시지 수를 입력하세요. Return All을 끈 경우에만 사용됩니다.
- Simplify: 간소화된 응답을 반환할지(켜기) 또는 원시 데이터를 반환할지(끄기) 선택하세요. 기본값은 켜기입니다.
- 이는 API 호출의
format을metadata로 설정하는 것과 동일하며, 이메일 메시지 ID, 라벨, From, To, CC, BCC, Subject를 포함한 이메일 헤더를 반환합니다.
- 이는 API 호출의
여러 메시지 조회 필터#
노드 동작을 세부 조정하는 필터입니다:
- Include Spam and Trash: 스팸 및 휴지통 폴더의 메시지를 가져올지(켜기) 여부(끄기)를 선택하세요.
- Label Names or IDs: 선택한 라벨이 붙은 메시지만 반환합니다. 적용할 라벨 이름을 선택하거나 표현식으로 ID를 지정하세요. 드롭다운은 선택한 자격 증명을 기반으로 채워집니다.
- Search:
from:과 같은 Gmail 검색 정제 필터를 입력하여 반환되는 메시지를 필터링하세요. 자세한 내용은 Gmail에서 검색 정제를 참조하세요. - Read Status: 읽지 않은 메일과 읽은 메일, 읽지 않은 메일만(기본값), 읽은 메일만 중에서 선택하세요.
- Received After: 지정된 날짜와 시간 이후에 수신된 이메일만 반환합니다. 날짜 선택기를 사용하거나 표현식으로 ISO 형식 문자열 또는 밀리초 타임스탬프를 입력하세요.
- Received Before: 지정된 날짜와 시간 이전에 수신된 이메일만 반환합니다. 날짜 선택기를 사용하거나 표현식으로 ISO 형식 문자열 또는 밀리초 타임스탬프를 입력하세요.
- Sender: 이메일 주소 또는 발신자 이름의 일부를 입력하여 해당 발신자의 메시지만 반환합니다.
자세한 내용은 Gmail API Method: users.messages.list 문서를 참조하세요.
읽음으로 표시#
이 작업을 사용하여 메시지를 읽음으로 표시합니다.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Mark as Read를 선택하세요.
- Message ID: 읽음으로 표시할 메시지의 ID를 입력하세요.
자세한 내용은 Gmail API Method: users.messages.modify 문서를 참조하세요.
읽지 않음으로 표시#
이 작업을 사용하여 메시지를 읽지 않음으로 표시합니다.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Mark as Unread를 선택하세요.
- Message ID: 읽지 않음으로 표시할 메시지의 ID를 입력하세요.
자세한 내용은 Gmail API Method: users.messages.modify 문서를 참조하세요.
메시지에서 라벨 제거#
이 작업을 사용하여 메시지에서 하나 이상의 라벨을 제거합니다.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Remove Label을 선택하세요.
- Message ID: 라벨을 제거할 메시지의 ID를 입력하세요.
- Label Names or IDs: 제거할 라벨 이름을 선택하거나 표현식으로 ID를 지정하세요. 드롭다운은 선택한 자격 증명을 기반으로 채워집니다.
자세한 내용은 Gmail API Method: users.messages.modify 문서를 참조하세요.
메시지에 답장#
이 작업을 사용하여 기존 메시지에 답장을 보냅니다.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Reply를 선택하세요.
- Message ID: 답장할 메시지의 ID를 입력하세요.
- Email Type을 선택하세요. Text 또는 HTML 중에서 선택하세요.
- Message: 이메일 본문을 입력하세요.
답장 옵션#
노드 동작을 세부 조정하는 옵션입니다:
- Append n8n attribution: 기본적으로 노드는 이메일 끝에
This email was sent automatically with n8n문구를 추가합니다. 이 문구를 제거하려면 이 옵션을 끄세요. - Attachments: Add Attachment를 선택하여 첨부 파일을 추가하세요. 입력 노드에서 첨부 파일이 포함된 필드를 식별하기 위한 **Attachment Field Name (in Input)**을 입력하세요.
- 여러 속성의 경우 쉼표로 구분된 목록을 입력하세요.
- BCC: 숨은 참조 수신자 이메일 주소를 하나 이상 입력하세요. 쉼표로 구분하세요(예:
jay@gatsby.com, jon@smith.com). - CC: 참조 수신자 이메일 주소를 하나 이상 입력하세요. 쉼표로 구분하세요(예:
jay@gatsby.com, jon@smith.com). - Sender Name: 수신자의 이메일에 발신자로 표시될 이름을 입력하세요.
- Reply to Sender Only: 전체 답장(끄기) 또는 발신자에게만 답장(켜기)을 선택하세요.
자세한 내용은 Gmail API Method: users.messages.send 문서를 참조하세요.
메시지 발송#
이 작업을 사용하여 메시지를 발송합니다.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Send를 선택하세요.
- To: 이메일을 발송할 이메일 주소를 입력하세요.
- Subject: 제목 줄을 입력하세요.
- Email Type을 선택하세요. Text 또는 HTML 중에서 선택하세요.
- Message: 이메일 본문을 입력하세요.
발송 옵션#
노드 동작을 세부 조정하는 옵션입니다:
- Append n8n attribution: 기본적으로 노드는 이메일 끝에
This email was sent automatically with n8n문구를 추가합니다. 이 문구를 제거하려면 이 옵션을 끄세요. - Attachments: Add Attachment를 선택하여 첨부 파일을 추가하세요. 입력 노드에서 첨부 파일이 포함된 필드를 식별하기 위한 **Attachment Field Name (in Input)**을 입력하세요.
- 여러 속성의 경우 쉼표로 구분된 목록을 입력하세요.
- BCC: 숨은 참조 수신자 이메일 주소를 하나 이상 입력하세요. 쉼표로 구분하세요(예:
jay@gatsby.com, jon@smith.com). - CC: 참조 수신자 이메일 주소를 하나 이상 입력하세요. 쉼표로 구분하세요(예:
jay@gatsby.com, jon@smith.com). - Sender Name: 수신자의 이메일에 발신자로 표시될 이름을 입력하세요.
- Send Replies To: 답장 주소로 설정할 이메일 주소를 입력하세요.
- Reply to Sender Only: 전체 답장(끄기) 또는 발신자에게만 답장(켜기)을 선택하세요.
자세한 내용은 Gmail API Method: users.messages.send 문서를 참조하세요.
메시지 발송 및 승인 대기#
이 작업을 사용하여 메시지를 발송하고 워크플로 실행을 계속하기 전에 수신자의 승인을 기다립니다.
Send and Wait for Approval 작업은 단순한 승인 프로세스에 적합합니다. 더 복잡한 승인의 경우 Wait 노드 사용을 고려하세요.
다음 파라미터를 입력하세요:
- 연결에 사용할 자격 증명을 선택하거나 새로 생성하세요.
- Resource: Message를 선택하세요.
- Operation: Send and Wait for Approval을 선택하세요.
- To: 이메일을 발송할 이메일 주소를 입력하세요.
- Subject: 제목 줄을 입력하세요.
- Message: 이메일 본문을 입력하세요.
발송 및 승인 대기 옵션#
노드 동작을 세부 조정하는 옵션입니다:
- Type of Approval: 승인 버튼만 포함하려면 Approve Only(기본값)를 선택하고, 거부 옵션도 포함하려면 Approve and Disapprove를 선택하세요.
- Approve Button Label: 승인 버튼에 사용할 레이블(Approve 기본값).
- Approve Button Style: 승인 버튼을 Primary(기본값) 또는 Secondary 버튼으로 스타일링할지 선택하세요.
- Disapprove Button Label: 거부 버튼에 사용할 레이블(Decline 기본값). Type of Approval을 Approve and Disapprove로 설정했을 때만 표시됩니다.
- Disapprove Button Style: 거부 버튼을 Primary 또는 Secondary(기본값) 버튼으로 스타일링할지 선택하세요. Type of Approval을 Approve and Disapprove로 설정했을 때만 표시됩니다.
자세한 내용은 Gmail API Method: users.messages.send 문서를 참조하세요.
일반적인 문제#
일반적인 오류 및 문제와 해결 방법은 일반적인 문제를 참조하세요.
