Cấu hình SMTP với Resend
Kết nối Resend để ChatHub gửi email đặt lại mật khẩu, thư mời nhân viên và thư workflow: xác minh tên miền, tạo API key, cấu hình SMTP và gửi thử.
Trước khi bắt đầu#
Cấu hình Email được dùng chung cho thư đặt lại mật khẩu, thư mời nhân viên và bước workflow “Gửi email”. Chuẩn bị tài khoản ChatHub có quyền quản lý cài đặt, tài khoản Resend, tên miền bạn sở hữu và quyền sửa DNS của tên miền đó.
1. Xác minh tên miền gửi trên Resend#
- 1
Đăng nhập Resend, mở Domains và thêm tên miền hoặc tên miền con dùng để gửi thư.
- 2
Mở chi tiết tên miền, xem Records và thêm đúng các bản ghi DNS Resend cung cấp tại nơi quản lý DNS. Sao chép chính xác loại bản ghi, tên và giá trị; không dùng giá trị mẫu của một tên miền khác.
- 3
Bấm Verify DNS Records và chờ xác minh khả năng gửi. Nếu còn pending, kiểm tra lại DNS rồi chờ hệ thống cập nhật; chỉ tiếp tục khi tên miền đã được xác minh để gửi.
- 4
Chọn địa chỉ gửi thuộc tên miền đã xác minh. Ví dụ, nếu xác minh mail.example.com thì dùng noreply@mail.example.com.
2. Tạo API key dành cho ChatHub#
- 1
Trong Resend, mở API Keys và tạo khóa riêng, đặt tên dễ nhận biết như ChatHub SMTP.
- 2
Chọn quyền gửi email (Sending access) và giới hạn vào tên miền sẽ dùng nếu có lựa chọn này.
- 3
Sao chép khóa ngay khi tạo và cất ở nơi quản lý bí mật an toàn. Resend không cho xem lại giá trị khóa sau đó. Bạn sẽ dán khóa vào ô Mật khẩu của ChatHub.
3. Điền cấu hình Email trong ChatHub#
Mở Quản trị → Cài đặt → Email, hoặc mở /settings?tab=email trên tên miền ChatHub của bạn. Trong khối Máy chủ email (SMTP), điền lần lượt:
- 1
Máy chủ SMTP: smtp.resend.com — chỉ nhập tên máy chủ, không thêm https://.
- 2
Mã hoá: STARTTLS. Cổng: 587.
- 3
Tài khoản đăng nhập: resend.
- 4
Mật khẩu: dán API key Resend vừa tạo. Nếu đã có mật khẩu, trường hiển thị Mật khẩu mới; nhập khóa mới khi cần thay thế.
- 5
Tên người gửi: tên shop hoặc thương hiệu, ví dụ ChatHub.
- 6
Địa chỉ gửi: địa chỉ thuộc tên miền đã xác minh, ví dụ noreply@example.com sau khi thay bằng tên miền thật của bạn.
- 7
Địa chỉ nhận trả lời: hộp thư bạn thực sự theo dõi, ví dụ support@example.com sau khi thay bằng địa chỉ thật. Có thể để trống nếu dùng cùng địa chỉ gửi và địa chỉ đó nhận được thư.
- 8
Bật công tắc Bật gửi email.
Nếu dùng cổng 465, chọn SSL/TLS thay cho STARTTLS. Kiểm tra lại cả cổng và kiểu mã hoá sau khi đổi lựa chọn. Hai cặp thường dùng là STARTTLS + 587 hoặc SSL/TLS + 465.
4. Lưu rồi gửi thư thử#
- 1
Rà lại thông tin rồi bấm Lưu. Chờ thông báo “Đã lưu cấu hình email.”
- 2
Trong Gửi thư thử, điền Gửi tới bằng hộp thư của bạn để kiểm tra. Nút này gửi một email thật bằng cấu hình đã lưu.
- 3
Bấm Gửi thư thử, đọc kết quả rồi mở hộp thư nhận, kiểm tra cả thư rác. Đối chiếu tên người gửi, địa chỉ gửi và địa chỉ trả lời.
- 4
Nếu chưa thấy thư, mở mục Emails trên Resend để xem thư SMTP và trạng thái xử lý. Thông báo gửi thành công trong ChatHub chưa bảo đảm thư nằm trong hộp thư đến.
ChatHub mã hóa mật khẩu khi lưu và không hiển thị lại. Ô Mật khẩu mới để trống sẽ giữ mật khẩu hiện có; việc ô này trống sau khi lưu là bình thường. Tắt Bật gửi email rồi Lưu sẽ ngừng gửi thư hệ thống nhưng giữ cấu hình.
5. Xử lý lỗi thường gặp#
- 1
Bị từ chối tài khoản hoặc mật khẩu: kiểm tra tài khoản là resend, mật khẩu là API key còn hiệu lực, có quyền gửi và đúng tên miền. Nhập lại khóa rồi Lưu.
- 2
Lỗi người gửi hoặc tên miền: kiểm tra Địa chỉ gửi không trống, đúng định dạng, đúng tên miền đã xác minh trong Resend và được khóa cho phép sử dụng.
- 3
Lỗi SSL/TLS: kiểm tra đúng cặp STARTTLS + 587 hoặc SSL/TLS + 465; không chọn Không mã hoá để khắc phục lỗi.
- 4
Không kết nối được hoặc hết thời gian chờ: kiểm tra smtp.resend.com và kết nối SMTP đi ra từ máy chủ chạy ChatHub, gồm DNS, tường lửa và giới hạn của nhà cung cấp hosting.
- 5
Báo chưa cấu hình hoặc đang tắt: kiểm tra Máy chủ SMTP, công tắc Bật gửi email và lưu lại.
- 6
Bị từ chối người nhận hoặc vượt giới hạn: đọc chi tiết lỗi, kiểm tra địa chỉ nhận và giới hạn gửi hiện tại trong tài khoản Resend.
- 7
Đã gửi nhưng chưa nhận: kiểm tra Emails trong Resend, thư rác và địa chỉ nhận; dựa vào trạng thái từng thư để xử lý tiếp.