Loại nút browser_getEmail
Lấy email bằng cài đặt hộp thư đã cấu hình.

Ảnh chụp từ giao diện tiếng Anh của MoreLogin Desktop V2.73.101.
Các trường này nằm trong data.browserUi.inputs.
| Trường | Kiểu hoặc giá trị | Bắt buộc theo schema | Giá trị mặc định khi thực thi | Mô tả và giới hạn |
|---|---|---|---|---|
user | string | Không | — | Tài khoản email |
authType | "password" / "oauth2" (hỗ trợ tham chiếu biến) | Không | "password" | Phương thức ủy quyền. Giá trị ban đầu trong trình chỉnh sửa: "password" |
password | string | Không | — | Mật khẩu / mã ủy quyền |
imapHost | string | Không | — | Máy chủ IMAP |
port | WorkflowNumber | Không | 993 | Cổng; số nguyên 1–65535 sau khi phân giải. Giá trị ban đầu trong trình chỉnh sửa: 993 |
tls | boolean (hỗ trợ tham chiếu biến) | Không | true | Bật TLS. Giá trị ban đầu trong trình chỉnh sửa: true |
clientId | string | Không | — | Client ID |
clientSecret | string | Không | — | Client Secret |
refreshToken | string | Không | — | Refresh Token |
status | "UNSEEN" / "SEEN" / "ALL" (hỗ trợ tham chiếu biến) | Không | "UNSEEN" | Trạng thái email. Giá trị ban đầu trong trình chỉnh sửa: "UNSEEN" |
isJunk | boolean (hỗ trợ tham chiếu biến) | Không | false | Tìm cả trong thư rác. Giá trị ban đầu trong trình chỉnh sửa: false |
seen | boolean (hỗ trợ tham chiếu biến) | Không | false | Đánh dấu là đã đọc sau khi lấy. Giá trị ban đầu trong trình chỉnh sửa: false |
from | string | Không | — | Lọc theo người gửi |
mailTo | string | Không | — | Lọc theo người nhận |
subject | string | Không | — | Chủ đề chứa |
keyword | string | Không | — | Từ khóa trong nội dung thư |
dateType | "all" / "today" / "recent" (hỗ trợ tham chiếu biến) | Không | "all" | Ngày email. Giá trị ban đầu trong trình chỉnh sửa: "all" |
reg | string | Không | — | Regex trích xuất |
- Bắt buộc:
user,imapHost,port - imapHost là tên host; port là số nguyên trong khoảng 1–65535.
- Mã lỗi xác thực:
RPA_NODE_INPUT_INVALID
authType eq "password"
- Bắt buộc:
password - Giá trị là mật khẩu hoặc mã ủy quyền của hộp thư.
- Mã lỗi xác thực:
RPA_NODE_INPUT_INVALID
authType eq "oauth2"
- Bắt buộc:
clientId,refreshToken - Chế độ này chỉ hỗ trợ IMAP của Outlook/Hotmail. refresh_token của Microsoft được đổi lấy access_token, và refresh_token mới sau khi xoay vòng được lưu đệm cục bộ ở dạng mã hóa. clientSecret là tùy chọn (ứng dụng public client không cần trường này).
- Mã lỗi xác thực:
RPA_NODE_INPUT_INVALID - Nút tạo một kết nối IMAP thực và đọc email mới nhất khớp với các bộ lọc. Chế độ password dùng mật khẩu hoặc mã ủy quyền và hoạt động với mọi host IMAP. OAuth2 và "Tìm cả trong thư rác" chỉ được hỗ trợ cho Outlook/Hotmail (outlook.office365.com, imap-mail.outlook.com); các host khác trả về MAIL_PROVIDER_UNSUPPORTED. imapHost chỉ nhận tên host, không kèm cổng hay đường dẫn. Ba ngày gần nhất là hôm nay và hai ngày trước đó, theo giờ cục bộ của máy đang thực thi. Khi đặt reg, nhóm bắt đầu tiên hoặc toàn bộ chuỗi khớp sẽ được trả về. Nếu email mới nhất không khớp, null được trả về, và không chuyển sang các email cũ hơn. Khi không đặt reg, extractedValue là nội dung thư. seen=true chỉ đánh dấu email đã chọn là đã đọc. message.receivedAt là thời điểm nhận email (giờ cục bộ của ứng dụng máy tính, YYYY-MM-DD HH:mm:ss). Hơn 10000 email ứng viên trong một thư mục sẽ trả về MAIL_SEARCH_LIMIT, một email vượt quá 10 MiB trả về MAIL_MESSAGE_LIMIT, và lỗi kết nối/xác thực trả về MAIL_CONNECTION_FAILED (văn bản gốc của máy chủ và thông tin xác thực không bị lộ). Không hỗ trợ POP3, gửi email và tải xuống tệp đính kèm.
- Mã lỗi xác thực:
RPA_NODE_INPUT_INVALID
| Trường | Dạng được phép |
|---|---|
user | literal, template |
authType | literal, template |
password | literal, template |
imapHost | literal, template |
port | literal, template |
tls | literal, template |
clientId | literal, template |
clientSecret | literal, template |
refreshToken | literal, template |
status | literal, template |
isJunk | literal, template |
seen | literal, template |
from | literal, template |
mailTo | literal, template |
subject | literal, template |
keyword | literal, template |
dateType | literal, template |
reg | literal, template |
| Trường đầu ra | Kiểu hoặc giá trị |
|---|---|
found | boolean |
message | object / null |
extractedValue | string / null |
Tham chiếu các trường đã công bố dưới dạng ${nodeId.data.field}.
Một đối tượng nút hoàn chỉnh để đặt vào mảng nodes của quy trình hoặc vào blocks của một nút khác. mailPassword là một tham số ban đầu riêng tư được khai báo trong workflow.variables.
{
"id": "read_code_email",
"type": "browser_getEmail",
"data": {
"title": "Read the verification email",
"browserAction": "getEmail",
"browserUi": {
"inputs": {
"user": "user@example.com",
"authType": "password",
"password": "${mailPassword}",
"imapHost": "imap.example.com",
"port": 993,
"tls": true,
"status": "UNSEEN",
"from": "no-reply@example.com",
"dateType": "today",
"reg": "\\b(\\d{6})\\b"
},
"exception": {
"timeout": 30000,
"policy": "interrupt"
}
}
}
}