垃圾邮件、通知类邮件与重要性

类别

primary

来自真人的邮件，以及对您所发邮件的回复。

updates

新闻通讯、批量邮件、通知、收据和自动回复。

spam

未通过垃圾邮件检查或身份验证检查的邮件，或您举报过的邮件。除非明确请求，否则不会出现在任何列表中。

邮件信号

SendHQ 会读取收件服务在投递之前添加的判定邮件头：垃圾邮件和病毒扫描结果，以及 SPF、DKIM 和 DMARC 结果。只有第一次出现的邮件头才被信任，因为发件方可以追加看似相同的邮件头，却无法把它们放到收件方添加的邮件头之前。以下情况会被判为垃圾邮件：含有病毒、未通过垃圾邮件扫描、DMARC 失败、SPF 和 DKIM 均失败、未经身份验证却自称来自您自己域名的邮件，或者来自您从未写信联系过的发件人且 DKIM 和 SPF 均未通过的邮件。List-Unsubscribe、List-Id、bulk 优先级、批量邮件服务的特征、自动提交标记以及 no-reply 类的发件人，会让一封邮件被归为通知类。邮件头会按真实的邮件头行读取，绝不会通过搜索邮件正文来判断。

发件人历史

一个公司域名算作一个发件人，而 Gmail 等个人邮箱按地址分别计算。如果某个发件人不断来信，而您从未给该地址写过信，也没有在其会话中回复过，那么从第二封邮件起就会被归为通知类：冷启动外联邮件和跟进序列邮件会离开“主要”收件箱。如果您曾给同一公司的其他人发过邮件，阈值会提高到三封。

重要性

当一封邮件是对您发起的会话（例如一次赢回活动）的回复，或者您已将其发件人标记为重要时，这封邮件就是重要邮件。您发过邮件的人会留在“主要”收件箱中，但不会被标记为重要。新闻通讯和垃圾邮件永远不会被标记为重要，除非您将其发件人标记为重要。分类依据的是邮件头、发件人和您自己的邮件历史。邮件正文不会发送给任何模型。

纠正

使用 {"category": "spam"}、{"category": "primary"} 或 {"important": true} 调用 PATCH /emails/:id，可以修正单封邮件，并记住针对该发件人的判定，今后该发件人的邮件将不再按自动检查结果处理。垃圾邮件举报还会覆盖该发件人的公司域名，因为批量发件人会轮换地址。传入 "learn": false 则只修改这一封邮件。当规则改进时，自动分类的邮件会被重新分类；您手动移动过的邮件永远不会被更改。

按类别读取

GET /emails?direction=in&archived=false&category=primary 即主要收件箱。使用 category=updates 或 category=spam 查看其他视图，使用 important=true 进行分拣，使用 include_spam=true 搜索所有文件夹。GET /labels 会返回未读主要邮件、未读通知类邮件、重要邮件和垃圾邮件的 mailbox 计数。