List Customer Emails
Đọc các email đã gửi cho khách hàng và kết quả phân phối của chúng.
Get Email Content
Đọc một email chính xác như khi được gửi.
Tổng quan
Dodo Payments gửi email giao dịch cho khách hàng thay mặt bạn: biên lai, thông báo hoàn tiền, thông báo subscription, email nhắc thanh toán và khôi phục, cấp entitlement, cùng các liên kết đăng nhập Customer Portal. Tab Sent Emails trên bản ghi khách hàng sẽ lưu lại từng email. Với mỗi email, bạn có thể xem nội dung đã gửi, email đã được xử lý đến đâu và lý do email không đến nơi nếu gửi thất bại. Bạn có thể mở email mà khách hàng đã nhận và gửi lại email đó.
Email được lưu trong 180 ngày. Trạng thái gửi đến từ nhà cung cấp email và thường được cập nhật trong vòng vài giây sau mỗi sự kiện gửi.
Xem email của khách hàng
1
Open the Customer
Đi đến Sales → Customers trong dashboard và chọn khách hàng.
2
Open the Sent Emails Tab
Tab này liệt kê mọi email đã gửi cho khách hàng này trong 180 ngày qua, theo thứ tự mới nhất trước.
3
Read a Row
Mỗi hàng hiển thị chủ đề, cùng với địa chỉ người gửi và người nhận bên dưới. Các cột khác hiển thị Category, Date & Time, Delivery Status và Actions mà bạn có thể thực hiện.
Delivery Status
Mỗi email có một trong năm trạng thái. API trả về giá trị trạng thái, còn dashboard hiển thị nhãn tương ứng:Failure Reasons
Khi email không đến nơi, hàng tương ứng sẽ hiển thị lý do để bạn biết có cần thực hiện hành động hay không. Trỏ vào trạng thái trên hàng để đọc lý do. API trả về cùng lý do trongfailure_reason và mã ổn định trong failure_code:
Năm lý do trong số này yêu cầu sử dụng địa chỉ khác khi gửi lại vì cùng địa chỉ sẽ tiếp tục thất bại: hộp thư không tồn tại, địa chỉ bị máy chủ email từ chối, địa chỉ bị chặn sau các lần thất bại trước đó, tin nhắn bị từ chối vì quá lớn và người nhận đã đánh dấu email là spam.
Đọc Email
Để đọc email, chọn Resend trên hàng tương ứng hoặc Retry trên hàng bị lỗi. Bảng điều khiển mở ra sẽ hiển thị bản sao được lưu trong Email Preview, chính xác như nội dung đã gửi. Email khôi phục và email dunning do bạn viết sẽ có nhãn Written by you.
- Email đăng nhập Customer Portal. Các email này chứa liên kết đăng nhập trực tiếp nên nội dung không bao giờ được hiển thị.
- Email bị chặn. Các email này không bao giờ đến được nhà cung cấp nên không có bản sao.
- Email không thể chuyển cho nhà cung cấp. Không có bản sao nào được lưu.
- Email cũ hơn 180 ngày. Nhà cung cấp sẽ xóa nội dung tại thời điểm đó.
Gửi lại Email
Để gửi lại email, chọn Resend trên hàng tương ứng hoặc Retry trên hàng bị lỗi, rồi xác nhận trong bảng điều khiển. Nút này hiển thị số lần gửi lại còn lại của email. Dodo Payments tạo lại email từ sự kiện ban đầu, không phải từ bản sao đã lưu, vì vậy biên lai sẽ hiển thị trạng thái hiện tại của khoản thanh toán. Email giữ ngày của sự kiện ban đầu.
Giới hạn
Các giới hạn này áp dụng cho mọi lần gửi lại:- Mỗi email có thể được gửi lại ba lần.
- Các lần gửi lại một email đến cùng địa chỉ sẽ phải chờ giữa các lần thử: năm phút kể từ lần gửi gần nhất trước lần gửi lại thứ nhất, mười phút trước lần thứ hai và mười lăm phút trước lần thứ ba.
- Gửi lại đến bất kỳ địa chỉ nào sẽ phải chờ cho đến khi đã qua năm phút kể từ lần gần nhất địa chỉ đó nhận email từ bạn.
- Lần gửi chưa bao giờ đến được nhà cung cấp không bị tính vào ba lần gửi lại. Tuy nhiên, lần gửi đó vẫn làm tăng thời gian chờ.
- Resend chỉ khả dụng trong dashboard. API chỉ cho phép đọc.
Khi Resend Không Khả Dụng
Dashboard không cung cấp tùy chọn gửi lại hoặc từ chối gửi lại trong các trường hợp sau:Email đăng nhập Customer Portal luôn được gửi đến địa chỉ đã yêu cầu email đó và mỗi lần gửi lại sẽ tạo một liên kết đăng nhập mới.
Test Mode
Test mode gửi email thật, nên có hạn mức: 100 email cho mỗi doanh nghiệp mỗi tuần. Các lần gửi lại cũng sử dụng cùng hạn mức này. Mỗi email trong test mode được gửi đến người nhận thực, với[TEST MODE] ở đầu subject.
Để dừng email của customer trong test mode, hãy tắt Test Mode Emails trong Settings → Communication → Email (xem Test Mode Emails). Khi tính năng này tắt, không có email nào được gửi cho customer trong test mode, không có dòng nào được thêm vào tab, không tốn hạn mức và dashboard sẽ từ chối yêu cầu gửi lại. Email trong live mode không bị ảnh hưởng.
Khi hạn mức đã được sử dụng hết, không có email nào khác được gửi trong test mode trong tuần đó. Email đầu tiên bị từ chối trong tuần sẽ được ghi lại dưới dạng một dòng blocked, với nội dung “Not sent: the test-mode email allowance for this week is spent”. Các lần từ chối tiếp theo trong cùng tuần sẽ không thêm dòng nào. Hạn mức được đặt lại vào đầu mỗi tuần, vào thứ Hai. Live mode không có giới hạn này.
Email đăng nhập Customer Portal không bao giờ được gửi trong test mode và không sử dụng hạn mức.
Đọc Email Qua API
Danh sách và nội dung cũng có thể được truy cập bằng API key của bạn, nhờ đó bạn có thể hiển thị trạng thái gửi trong các công cụ hỗ trợ của riêng mình. Theo mặc định, danh sách trả về 10 email trên mỗi trang. Thiết lậppage_size để trả về tối đa 100 email và page_number để chuyển qua các trang, bắt đầu từ 0.
client.customers.emails.list() và client.customers.emails.retrieveBody() (retrieve_body() trong Python).
Mỗi item chứa email_log_id, được truyền đến content endpoint, cùng với status. Item cũng chứa failure_code và failure_reason khi lần gửi không thành công, cùng với has_preview để cho biết nội dung được lưu trữ có tồn tại hay không. Content endpoint trả về 422 khi email không có nội dung để hiển thị. Mỗi item cũng chứa một object policies cho biết bạn có thể làm gì với dòng này:
Hãy đọc
policies thay vì tự xác định khả năng thực hiện. Server áp dụng các quy tắc trên.
Customer Management
Quản lý customer, lịch sử mua hàng và quyền truy cập self-service.
Communication Preferences
Chọn các email mà Dodo Payments gửi thay mặt bạn.