指南
线程与标签
simail 怎样把邮件归进线程、回复令牌、标签、人工接管锁,以及线程端点。
docs.simail.ai/zh/threads
线程是一个邮箱里的一段对话:你收到的信和你发出的信。
邮件怎样归组
Section titled “邮件怎样归组”simail 按这个顺序决定一封来信属于哪个线程:
- 回复令牌。 外发邮件的 Reply-To 形如
shop-helper+<token>@simail.email。回复这个地址的信,加入令牌所属的线程。令牌会过期(默认 30 天)。 - 头和参与者。
In-Reply-To或References对上某线程里的一封信,并且发件人已经参与过该线程。 - 否则开一个新线程。simail 从不按主题合并线程,因为主题容易伪造。
不是联系人发起的线程,会标成由陌生人发起。删除并重建邮箱会使旧的回复令牌失效。
| 方法与路径 | 权限 |
|---|---|
GET /v0/inboxes/{inbox_id}/threads | message_read |
GET /v0/inboxes/{inbox_id}/threads/{thread_id} | message_read |
PATCH /v0/inboxes/{inbox_id}/threads/{thread_id}(标签) | message_update |
DELETE /v0/inboxes/{inbox_id}/threads/{thread_id}(进废纸篓) | message_delete |
GET /v0/inboxes/{inbox_id}/threads/{thread_id}/attachments/{attachment_id} | message_read |
GET /v0/inboxes/{inbox_id}/threads/search?q= | message_read |
GET /v0/inboxes/{inbox_id}/threads/{thread_id}/lock | message_read |
GET /v0/threads、GET /v0/threads/search、GET /v0/threads/{thread_id} | message_read |
GET /v0/pods/{pod_id}/threads 及其变体 | message_read |
组织级 /v0/threads 覆盖 key 作用域里的全部邮箱。查询参数与邮件相同:labels、before、after、include_spam、include_blocked、include_trash、limit、page_token、ascending。
线程对象含 thread_id、subject、senders、recipients、message_count、size、preview、labels、last_message_id、received_timestamp、sent_timestamp、timestamp,以及来自 GET …/threads/{thread_id} 的 messages。
系统标签:received、sent、unread、spam、blocked、trash、held、draft、important。你可以加自己的标签。线程的标签是其邮件标签的并集。agent 可以加减自己的标签以及 unread / important;不能清掉 held、spam 或 blocked。
删除线程或邮件会把它移到 trash;废纸篓里的项目 30 天后清除。
人可以在控制台锁定一个线程来接管对话。锁定期间,该线程的发送返回 423 thread_locked,已经定时或批准的信会等待。只有人能解锁。见人工接管。