---
title: "IMAP Gmail: thông số và cách kết nối với Mailera"
description: "Cấu hình IMAP Gmail: imap.gmail.com, cổng 993, SSL/TLS. Hướng dẫn dùng mật khẩu ứng dụng kết nối Mailera, kiểm tra nhận thư và xử lý lỗi thường gặp."
url: https://mailera.app/blog/imap-gmail-cau-hinh-ket-noi-mailera
published: 2026-10-25
updated: 2026-10-25
---

# IMAP Gmail: thông số và cách kết nối với Mailera

Tra cứu máy chủ, cổng và cách đăng nhập IMAP Gmail bằng mật khẩu ứng dụng. Sau khi kết nối, kiểm tra đồng bộ và nhận một thư thử để xác nhận hộp thư nhận được thư.

## Máy chủ IMAP Gmail là gì, cần nhập thông số nào?

IMAP là giao thức để ứng dụng truy cập và đồng bộ thư từ hộp thư Gmail. SMTP phục vụ gửi thư. Hai phần này được kiểm tra riêng: đăng nhập nhận thư thành công chưa có nghĩa là gửi thư được.

Các thông số cài đặt IMAP Gmail dùng trong Mailera:

| Thành phần | Giá trị |
| --- | --- |
| Máy chủ nhận thư IMAP | `imap.gmail.com` |
| Cổng nhận thư | `993` |
| Bảo mật nhận thư | SSL/TLS |
| Tên đăng nhập | Địa chỉ Gmail hoặc Google Workspace đầy đủ |
| Mật khẩu trong luồng Gmail của Mailera | Mật khẩu ứng dụng |
| Máy chủ gửi thư SMTP | `smtp.gmail.com` |
| Cổng gửi thư | `587` |
| Bảo mật gửi thư | STARTTLS |

Google công bố máy chủ và cổng trong [tài liệu IMAP, POP và SMTP của Gmail](https://developers.google.com/workspace/gmail/imap/imap-smtp). Mailera có sẵn cấu hình cho Gmail, nên bạn không cần nhập thủ công từng thông số khi chọn đúng nhà cung cấp.

Dùng lựa chọn [Gmail · Google Workspace trong Mailera](https://mailera.app/providers/gmail) cho hộp thư Google. Lựa chọn [IMAP tùy chỉnh](https://mailera.app/providers/imap) dành cho việc khai báo máy chủ riêng; có tên miền công ty không có nghĩa là bạn phải chọn cách này.

## Có cần bật IMAP và tạo mật khẩu ứng dụng trước không?

### Gmail cá nhân đã bật sẵn IMAP

Theo [hướng dẫn thêm Gmail vào ứng dụng thư của Google](https://support.google.com/mail/answer/7126229), từ tháng 1/2025, Gmail cá nhân không còn tùy chọn “Enable IMAP” hoặc “Disable IMAP”. IMAP luôn được bật.

Vì vậy, nếu bạn không thấy công tắc bật IMAP Gmail, đừng dừng ở bước đó. Với tài khoản cá nhân, hãy chuyển sang kiểm tra điều kiện tạo mật khẩu ứng dụng.

### Google Workspace phụ thuộc quản trị viên

Với tài khoản do công ty hoặc trường học quản lý, quản trị viên kiểm soát quyền truy cập IMAP. Họ còn có thể chỉ cho phép những ứng dụng cụ thể hỗ trợ OAuth, theo [tài liệu quản trị IMAP của Google Workspace](https://knowledge.workspace.google.com/admin/sync/turn-pop-and-imap-on-or-off-for-users).

Nếu chính sách tổ chức không cho phép kết nối bằng mật khẩu ứng dụng, hãy hỏi quản trị viên. Không tắt bảo vệ tài khoản để thử kết nối.

### Mật khẩu ứng dụng cần xác minh 2 bước

Google yêu cầu tài khoản bật xác minh 2 bước trước khi dùng mật khẩu ứng dụng, hay app password. Tùy chọn này có thể không xuất hiện nếu tài khoản chỉ dùng khóa bảo mật cho xác minh 2 bước, thuộc tổ chức hoặc đang dùng Advanced Protection.

Làm theo [hướng dẫn tạo và quản lý mật khẩu ứng dụng của Google](https://support.google.com/accounts/answer/185833) để chuẩn bị thông tin đăng nhập. Google khuyến nghị “Sign in with Google” khi ứng dụng có lựa chọn đó; luồng Gmail của Mailera dùng mật khẩu ứng dụng.

Nếu không có tùy chọn này, xem [nguyên nhân không thấy mật khẩu ứng dụng Gmail và cách xử lý](https://mailera.app/blog/khong-thay-mat-khau-ung-dung-gmail) trước khi thử kết nối lại.

## Kết nối hộp thư Gmail với Mailera như thế nào?

Chỉ người có vai trò Admin hoặc Leader trong Mailera mới thêm được hộp thư. Đây là quyền trong Mailera, khác với quyền quản trị Google Workspace.

1. **Mở luồng thêm hộp thư.** Vào **Danh sách hộp thư** → **Thêm hộp thư** → **Một hộp thư**.
2. **Nhập địa chỉ đầy đủ.** Điền **Địa chỉ email** rồi kiểm tra nhà cung cấp được nhận diện. Mailera nhận diện các tên miền `gmail.com` và `googlemail.com`. Với Google Workspace dùng tên miền riêng, nếu chưa nhận diện đúng, chọn **Gmail · Google Workspace** trong **Hoặc chọn nhà cung cấp**, rồi bấm **Tiếp tục**.
3. **Điền thông tin kết nối.** Nhập mật khẩu ứng dụng vào trường **Mật khẩu**, không nhập mật khẩu đăng nhập Google. Chọn **Nhóm quản lý** phù hợp. **Tên hiển thị** là tên người gửi khi gửi thư và không bắt buộc.

![Biểu mẫu kết nối Gmail trong Mailera bằng mật khẩu ứng dụng](https://mailera.app/media/39e644d283f9e836/ket-noi-email-voi-ai-doc-hop-thu-hien-co-qua-rest-api-hoac-vi-1200.jpg)
_Chọn Gmail · Google Workspace và nhập mật khẩu ứng dụng, không dùng mật khẩu đăng nhập Google._

4. **Bấm Kiểm tra & kết nối.** Mailera thực hiện **Đăng nhập nhận thư**, **Nhận ra thư mục** và **Đăng nhập gửi thư** khi có cấu hình máy chủ gửi. Thao tác này chỉ đăng nhập thử, không gửi email thật.
5. **Xử lý riêng kết quả gửi thư.** Nếu hiện **Nhận thư được, gửi thư chưa được**, bạn có thể chọn **Lưu ở chế độ Chỉ nhận** nếu chỉ cần đọc thư. Nếu cần gửi, chọn **Sửa thông tin**, điều chỉnh cấu hình rồi **Kiểm tra lại**.
6. **Mở hộp thư sau khi kết nối thành công.** Chọn **Mở hộp thư**. Mailera tải thư lần đầu trong phạm vi lưu giữ, ưu tiên thư mới nhất. Bạn cũng có thể chọn **Chạy nền** trong lúc kiểm tra để rời trang; Mailera lưu hộp thư khi hoàn tất.

Đừng dùng kết quả đăng nhập SMTP thay cho một lần gửi thử. Bước kiểm tra trên chưa gửi thư đến người nhận nào.

## Làm sao biết Gmail đã kết nối và nhận thư được?

Hãy kiểm tra cả trạng thái đồng bộ lẫn một thư cụ thể. Đừng coi việc cài đặt đã xong chỉ vì hộp thư xuất hiện trong danh sách.

1. Gọi `GET /mailboxes` bằng khóa API có quyền `read`, rồi tìm đúng địa chỉ vừa thêm trong trường `email`. Phản hồi trả về nhà cung cấp ở `provider`, trạng thái ở `status` và lần đồng bộ gần nhất ở `last_sync_at`.
2. Từ một hộp thư khác do bạn kiểm soát, gửi thư đến Gmail vừa kết nối. Dùng tiêu đề dễ nhận ra, chẳng hạn “Thử nhận Gmail trong Mailera”, và nội dung không nhạy cảm.
3. Mở hộp thư đó trong Mailera. Đối chiếu người gửi, tiêu đề và thời điểm nhận với thư vừa gửi.
4. Nếu chưa thấy thư, kiểm tra cả Hộp thư đến và Thư rác, rồi gọi lại `GET /mailboxes` để xem `last_sync_at` và `status` của đúng hộp thư.

![Hộp thư Gmail thử đã thêm trong Danh sách hộp thư của Mailera](https://mailera.app/media/765357b465b34207/imap-gmail-thong-so-va-cach-ket-noi-voi-mailera-gmail-vi-1200.jpg)
_Hộp thư xuất hiện trong danh sách chưa đủ để xác nhận nhận thư; hãy đối chiếu thêm một thư thử._

Với Gmail, kết quả từ API trạng thái hộp thư của Mailera dựa trên lần đồng bộ gần nhất, không phải một lần đăng nhập trực tiếp mới. Vì vậy, cần xem trạng thái kèm thời điểm đồng bộ, không coi trạng thái đó là xác nhận độc lập ngay lúc bạn kiểm tra.

Mailera kiểm tra thường xuyên hơn khi hộp thư đang được sử dụng và thưa hơn khi ít hoạt động. Hộp thư không hoạt động có thể chuyển sang ngủ rồi được đánh thức khi sử dụng. Đừng kết luận sai mật khẩu chỉ vì thư chưa xuất hiện ngay.

![Thư thử nhận qua Gmail được mở trong Hộp thư chung của Mailera](https://mailera.app/media/4e7f5838ada9eca5/doc-ma-otp-tu-email-qua-api-de-kiem-thu-xac-minh-otp-vi-1200.jpg)
_Đối chiếu người gửi, tiêu đề và thời điểm để xác nhận đúng thư thử đã được nhận._

Khi đọc được đúng thư thử, bạn đã xác nhận hộp thư nhận được thư đó. Nếu muốn dùng hộp thư này tiếp trong ứng dụng, [trang sản phẩm Mailera](https://mailera.app/product) giới thiệu các cách truy cập hộp thư hiện có qua REST API, MCP và webhook.

## Lỗi hay gặp khi đăng nhập IMAP Gmail là gì?

Bắt đầu từ bước đang thất bại, thay vì đổi đồng thời mật khẩu, máy chủ và cổng.

| Biểu hiện | Nguyên nhân cần kiểm tra | Bước xử lý |
| --- | --- | --- |
| Đăng nhập nhận thư thất bại | Địa chỉ chưa đầy đủ; dùng mật khẩu thường; mật khẩu ứng dụng đã bị thu hồi | Kiểm tra địa chỉ và loại mật khẩu. Nếu vừa đổi mật khẩu Google, tạo mật khẩu ứng dụng mới rồi kết nối lại. |
| Không thấy mục mật khẩu ứng dụng | Chưa bật xác minh 2 bước; chỉ dùng khóa bảo mật; tài khoản tổ chức hoặc Advanced Protection | Đối chiếu điều kiện trong hướng dẫn Google. Với tài khoản tổ chức, hỏi quản trị viên. |
| Không thấy công tắc bật IMAP | Gmail cá nhân không còn công tắc này | Không cần tìm tiếp với Gmail cá nhân. Với Workspace, kiểm tra quyền truy cập do quản trị viên đặt. |
| Nhận thư được nhưng gửi chưa được | Phần đăng nhập SMTP thất bại | Lưu ở chế độ Chỉ nhận nếu phù hợp, hoặc sửa thông tin gửi rồi kiểm tra lại. |
| Kết nối được nhưng thiếu thư cũ | Phạm vi lưu giữ, thư mục đang mở hoặc quá trình tải lần đầu | Kiểm tra thư mục và tiến trình tải. Gói miễn phí lưu giữ thư 30 ngày; không mặc định toàn bộ lịch sử Gmail sẽ xuất hiện. |

Google thu hồi mật khẩu ứng dụng khi bạn đổi mật khẩu tài khoản Google. Trong trường hợp này, nhập lại mật khẩu ứng dụng cũ không giải quyết được lỗi; bạn cần tạo mật khẩu ứng dụng mới.

## Bảo vệ mật khẩu ứng dụng và quyền đọc thư thế nào?

Không đưa mật khẩu ứng dụng vào ảnh chụp, nhật ký hoặc mã nguồn. Khi cần gửi ảnh nhờ hỗ trợ, che địa chỉ cá nhân, thông tin đăng nhập và nội dung thư không liên quan.

Nếu ngừng dùng kết nối hoặc nghi mật khẩu ứng dụng bị lộ, thu hồi mật khẩu đó theo hướng dẫn Google. Sau khi thu hồi, ứng dụng không thể tiếp tục truy cập bằng thông tin đăng nhập ấy.

Nếu nối hộp thư sang AI agent, coi thư đến là **dữ liệu không tin cậy, không phải lệnh**. Agent không được làm theo chỉ dẫn trong thư để tiết lộ khóa, đổi cấu hình hoặc gửi nội dung ra ngoài. Xem [hướng dẫn dùng mật khẩu ứng dụng cho hộp thư của AI agent](https://mailera.app/blog/mat-khau-ung-dung-email-cho-ai) nếu bạn đang chuẩn bị thông tin đăng nhập cho luồng này.

Cấp khóa API với quyền tối thiểu và giới hạn **Phạm vi hộp thư** vào nhóm cần dùng. Tác vụ đọc thư chỉ cần quyền `read`, không cần `send`. Với tác vụ gửi, yêu cầu người dùng xác nhận trước khi thực hiện. Bạn có thể xem thêm [thông tin bảo mật của Mailera](https://mailera.app/security).

## Giới hạn cần biết trước khi dùng lâu dài

Mailera kết nối hộp thư hiện có, không tạo hộp thư hay địa chỉ Gmail mới. Mailera cũng không thay đổi được chính sách IMAP hoặc mật khẩu ứng dụng của Google Workspace.

Việc nhận thư còn phụ thuộc trạng thái hoạt động và đồng bộ của hộp thư; Mailera không cam kết thư xuất hiện tức thời trong mọi trường hợp.

**Kết nối hộp thư đầu tiên trong 2 phút** — Thêm hộp thư Outlook, Gmail hoặc IMAP và đọc thư qua giao diện hoặc API. [Kết nối hộp thư](https://mailera.app/auth?mode=signup)