Skip to content

Đọc email

Loại nút browser_getEmail

Chức năng

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

Cấu hình trong ứng dụng máy tính

Cấu hình nút "Đọc email" trong ứng dụng máy tính

Ảnh chụp từ giao diện tiếng Anh của MoreLogin Desktop V2.73.101.

Đầu vào

Các trường này nằm trong data.browserUi.inputs.

TrườngKiểu hoặc giá trịBắt buộc theo schemaGiá trị mặc định khi thực thiMô tả và giới hạn
userstringKhô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"
passwordstringKhông—Mật khẩu / mã ủy quyền
imapHoststringKhông—Máy chủ IMAP
portWorkflowNumberKhông993Cổng; số nguyên 1–65535 sau khi phân giải. Giá trị ban đầu trong trình chỉnh sửa: 993
tlsboolean (hỗ trợ tham chiếu biến)KhôngtrueBật TLS. Giá trị ban đầu trong trình chỉnh sửa: true
clientIdstringKhông—Client ID
clientSecretstringKhông—Client Secret
refreshTokenstringKhô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"
isJunkboolean (hỗ trợ tham chiếu biến)KhôngfalseTìm cả trong thư rác. Giá trị ban đầu trong trình chỉnh sửa: false
seenboolean (hỗ trợ tham chiếu biến)KhôngfalseĐánh dấu là đã đọc sau khi lấy. Giá trị ban đầu trong trình chỉnh sửa: false
fromstringKhông—Lọc theo người gửi
mailTostringKhông—Lọc theo người nhận
subjectstringKhông—Chủ đề chứa
keywordstringKhô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"
regstringKhông—Regex trích xuất

Yêu cầu theo chế độ và giới hạn

  • 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

Tham chiếu đầu vào

TrườngDạng được phép
userliteral, template
authTypeliteral, template
passwordliteral, template
imapHostliteral, template
portliteral, template
tlsliteral, template
clientIdliteral, template
clientSecretliteral, template
refreshTokenliteral, template
statusliteral, template
isJunkliteral, template
seenliteral, template
fromliteral, template
mailToliteral, template
subjectliteral, template
keywordliteral, template
dateTypeliteral, template
regliteral, template

Đầu ra

Trường đầu raKiểu hoặc giá trị
foundboolean
messageobject / null
extractedValuestring / null

Tham chiếu các trường đã công bố dưới dạng ${nodeId.data.field}.

Ví dụ JSON

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"
      }
    }
  }
}

Quay lại danh mục nút