Bảng tra mã từ chối của Email Relay

Tra mã trả lời SMTP mà Email Relay gửi cho máy chủ thư của bạn, phân biệt từ chối tạm với từ chối vĩnh viễn, và biết khi nào cần can thiệp.

Email Relay trả lời máy chủ thư của bạn bằng mã SMTP, không phải bằng JSON. Mã đó nằm trong nhật ký của máy chủ thư của bạn, không phải trên bảng điều khiển CloudFly.

Cần đi từ triệu chứng thay vì từ mã thì xem Xử lý sự cố Email Relay.

Đọc chữ số đầu tiên trước

Đây là điều quan trọng nhất trên trang này, và cũng là chỗ hay hiểu nhầm nhất.

Nhóm mã	Nghĩa	Máy chủ thư của bạn sẽ làm gì
`2xx`	Đã nhận	Chuyển thư khỏi hàng đợi, coi như xong
`4xx`	Từ chối tạm	Tự giữ thư và thử lại, thường trong 24–48 giờ
`5xx`	Từ chối vĩnh viễn	Bỏ thư và gửi thư báo lỗi về cho người gửi

4xx phần lớn không cần bạn làm gì — máy chủ thư của bạn tự xử lý. 5xx thì luôn cần: thư đã mất và người gửi đã nhận thư báo lỗi.

Mã 250 không có nghĩa là đã tới nơi

250 chỉ nói rằng CloudFly đã nhận thư và chịu trách nhiệm chuyển tiếp. Việc giao tới hộp thư người nhận diễn ra sau đó và có thể vẫn thất bại. Kết quả cuối xem ở màn hình Thống kê & Nhật ký.

Từ chối lúc đăng nhập

Mã	Nội dung	Nguyên nhân
`535`	`Authentication failed`	Sai tên đăng nhập hoặc sai SMTP key

Tên đăng nhập luôn là chữ apikey — đúng chuỗi đó, không phải địa chỉ email của bạn. Mật khẩu là SMTP key dạng cfr_....

SMTP key chỉ hiện một lần lúc tạo. Không lưu lại thì tạo key mới, không có cách xem lại.

Xem Tạo SMTP key.

Từ chối ở bước khai người gửi

Nội dung trả lời	Nhóm	Nguyên nhân
`DOMAIN_NOT_VERIFIED`	`5xx`	Tên miền của địa chỉ gửi chưa hoạt động, không tồn tại, hoặc thuộc dịch vụ khác
`DAILY_QUOTA_EXCEEDED`	`4xx`	Hết hạn mức thư trong ngày
`INTERNAL_ERROR`	`4xx`	Lỗi tạm phía hệ thống
`relay backend unavailable`	`4xx`	Không liên lạc được với hệ thống kiểm tra

Chú ý cặp đối lập ở đây, vì nó quyết định thư của bạn còn hay mất:

Hết hạn mức là từ chối tạm. Máy chủ thư của bạn giữ thư lại và thử lại sau. Sang ngày mới, hạn mức đặt lại và thư tự đi. Thường không cần bạn làm gì.
Tên miền chưa xác minh là từ chối vĩnh viễn. Thư bị trả lại ngay. Xác minh xong rồi thì phải gửi lại từ đầu, những thư đã bị trả lại không tự đi tiếp.

Từ chối ở bước khai người nhận

Nội dung trả lời	Nhóm	Nguyên nhân
`RECIPIENT_SUPPRESSED`	`5xx`	Địa chỉ nằm trong danh sách chặn
`RECIPIENT_PLATFORM_SUPPRESSED`	`5xx`	Địa chỉ không tồn tại — hệ thống đã xác minh và chặn cho mọi khách hàng
`TOO_MANY_RECIPIENTS`	`4xx`	Vượt 50 người nhận trong một thư

RECIPIENT_SUPPRESSED chỉ từ chối đúng địa chỉ đó. Những người nhận còn lại trong cùng thư vẫn được nhận bình thường.

Địa chỉ vào danh sách chặn vì thư trước gửi tới đó bị trả lại vĩnh viễn, hoặc vì người nhận báo thư rác. Gửi tiếp cho địa chỉ hỏng làm giảm uy tín gửi của cả tên miền, nên đây là bảo vệ chứ không phải cản trở. Xem Đọc và xử lý danh sách chặn.

TOO_MANY_RECIPIENTS cố ý là từ chối tạm, để máy chủ thư của bạn giữ thư lại thay vì trả về cho người gửi. Nhưng thử lại cũng vẫn vượt trần — phải sửa phía bạn: chia thành nhiều thư, mỗi thư tối đa 50 địa chỉ.

Từ chối vì hệ thống đang quá tải

Mã	Nhóm	Nguyên nhân
`451`	`4xx`	Hàng đợi gửi đang sâu, hệ thống đẩy bớt tải về phía bạn
`too many connections`	`4xx`	Quá nhiều kết nối cùng lúc từ phía bạn

Cả hai đều là từ chối tạm và tự hết. Máy chủ thư của bạn thử lại là thư đi.

Gặp liên tục nhiều giờ thì mới cần báo — lúc đó không còn là đợt tải nhất thời.

Từ chối vì thư quá lớn

Ngay khi mở kết nối, CloudFly thông báo trần 25 MB cho máy chủ thư của bạn. Phần mềm gửi đúng chuẩn sẽ dừng ngay tại đó và không tải thư lên.

Thư vượt trần bị từ chối vĩnh viễn, vì thử lại không làm thư nhỏ đi. Giảm dung lượng file đính kèm, hoặc đặt file ở nơi tải xuống và gửi liên kết.

Bảng đối chiếu nhanh

Bạn thấy trong nhật ký	Cần làm gì
`535`	Sửa tên đăng nhập hoặc SMTP key, rồi khởi động lại tiến trình gửi
`DOMAIN_NOT_VERIFIED`	Xác minh tên miền, rồi gửi lại các thư đã bị trả lại
`RECIPIENT_SUPPRESSED`	Kiểm địa chỉ; chỉ dòng Thêm thủ công mới tự gỡ được — dòng trả cứng hoặc khiếu nại phải liên hệ hỗ trợ
`RECIPIENT_PLATFORM_SUPPRESSED`	Địa chỉ đã được xác minh là không tồn tại. Bạn không tự gỡ được — liên hệ hỗ trợ nếu chắc chắn địa chỉ còn dùng
`TOO_MANY_RECIPIENTS`	Chia nhỏ thư, tối đa 50 địa chỉ mỗi thư
`DAILY_QUOTA_EXCEEDED`	Không cần làm gì; gặp thường xuyên thì xin nâng hạn mức
`451` hoặc `too many connections`	Không cần làm gì
Thư quá lớn	Giảm dung lượng đính kèm

Hạn mức thật của tài khoản nằm trên màn hình Tổng quan — xem Đọc trang Tổng quan của từng dịch vụ. Trần dung lượng một thư ghi ở khối Giới hạn kích thước trên trang Cấu hình SMTP.