List Customer Emails
阅读客户已发送的邮件及其送达结果。
Get Email Content
阅读一封邮件发送时的原文。
概览
Dodo Payments 代表您向客户发送事务性邮件：收据、退款通知、订阅通知、催收和恢复邮件、权益授予邮件，以及 Customer Portal 登录链接。 客户记录中的 Sent Emails 标签页会记录每封邮件。对于每封邮件，您可以看到发送的内容、邮件送达到了哪一步，以及失败时未送达的原因。您可以打开客户收到的邮件，也可以再次发送。
邮件会保留 180 天。送达状态来自邮件服务提供商，通常会在每次送达事件发生后的几秒内更新。
查看客户的邮件
1
Open the Customer
在控制面板中转到 Sales → Customers，然后选择客户。
2
Open the Sent Emails Tab
该标签页会列出过去 180 天内发送给此客户的每封邮件，最新的邮件排在最前面。
3
Read a Row
每一行显示主题，主题下方显示发件人和收件人地址。其他列显示 Category、Date & Time、Delivery Status 以及您可以执行的 Actions。
Delivery Status
每封邮件都有五种状态之一。API 返回状态值，控制面板显示其标签：Failure Reasons
邮件未送达时，该行会显示原因，以便您了解是否需要采取措施。将鼠标指针移到该行的状态上即可查看原因。API 会在failure_reason 中返回相同的原因，并在 failure_code 中返回稳定代码：
其中五种原因在重新发送时需要使用其他地址，因为使用相同地址会再次失败：邮箱不存在、地址被邮件服务器拒绝、地址在此前失败后被阻止、邮件大小过大而被拒绝，以及收件人将邮件标记为垃圾邮件。
Reading an Email
要阅读邮件，请在其所在行选择 Resend，或者在失败的行中选择 Retry。打开的面板会在 Email Preview 下显示已存储的副本，与发送时完全一致。您编写的恢复和催收邮件会带有 Written by you 标签。
- Customer Portal login emails. 这些邮件包含实时登录链接，因此不会显示内容。
- Blocked emails. 这些邮件从未到达服务提供商，因此不存在副本。
- Emails that could not be handed to the provider. 未存储副本。
- Emails older than 180 days. 服务提供商会在此时清除邮件内容。
Sending an Email Again
要再次发送邮件，请在其所在行选择 Resend，或者在失败的行中选择 Retry，然后在面板中确认。按钮会显示该邮件还可以重发多少次。Dodo Payments 会根据原始事件重新构建邮件，而不是使用已存储的副本，因此收据会显示付款的当前状态。邮件会保留原始事件的日期。
Limits
以下限制适用于每次重发：- 每封邮件最多可以再次发送 三次。
- 向同一地址重发同一封邮件时，两次尝试之间需要等待：首次重发需在最近一次发送后等待五分钟，第二次等待十分钟，第三次等待十五分钟。
- 向任何地址重发时，都必须等到该地址上次收到您发送的邮件五分钟后才能发送。
- 未到达服务提供商的发送不会计入三次限制，但仍会增加等待时间。
- 只能在控制面板中使用 Resend。API 仅支持读取。
When Resend Is Not Available
在以下情况下，控制面板不会提供重发选项，或会拒绝重发：Customer Portal 登录邮件始终会发送到请求该邮件的地址，每次重发都会创建新的登录链接。
Test Mode
测试模式会发送真实邮件，因此设有额度：每个企业每周 100 封邮件。重新发送也会消耗同一额度。每封测试模式邮件都会发送给真实收件人，主题开头包含[TEST MODE]。
要停止测试模式客户邮件，请在 Settings → Communication → Email 中关闭 Test Mode Emails（请参阅 Test Mode Emails）。关闭期间，测试模式不会发送任何客户邮件、不会向该标签页添加任何行、不会消耗额度，并且 dashboard 会拒绝重新发送。Live mode 邮件不受影响。
额度用完后，该周内测试模式不会再发送任何邮件。该周第一封被拒绝的邮件会记录为一个 blocked 行，其内容为“未发送：本周的测试模式邮件额度已用完”。同一周内后续被拒绝的邮件不会添加任何行。额度会在每周开始时（星期一）重置。Live mode 没有此限制。
Customer Portal 登录邮件在测试模式下永远不会发送，也不会消耗额度。
通过 API 读取邮件
您也可以使用 API key 获取列表和内容，从而在自己的支持工具中显示投递状态。列表默认每页返回 10 封邮件。设置page_size 可返回最多 100 封邮件，并设置 page_number 进行分页，起始值为 0。
client.customers.emails.list() 和 client.customers.emails.retrieveBody()（Python 中为 retrieve_body()）。
每个项目都包含其 email_log_id，您需要将其传递给内容 endpoint；同时还包含其 status。如果发送失败，项目还会包含 failure_code 和 failure_reason，并包含 has_preview，用于表示是否存在已存储的内容。当邮件没有可显示的内容时，内容 endpoint 会返回 422。每个项目还包含一个 policies 对象，用于说明您可以对该行执行哪些操作：
请读取
policies，而不要自行推导是否符合条件。服务器会应用上述规则。
Customer Management
管理客户、购买历史记录和自助服务访问权限。
Communication Preferences
选择由 Dodo Payments 代表您发送哪些邮件。