用途：构建读取收件箱的功能，例如共享收件箱界面、客服系统同步、查看客户历史记录，或需要先读取线程再作答的智能体。GET /v1/messages 只返回扁平日志，会话才是承载消息的线程。
主要能力：一个会话是与单一联系人的线程，跨所有渠道；对方从 WhatsApp 转用邮件仍在同一会话，channels 列出已承载的渠道。字段包括 id（与消息及 Webhook 的 conversationId 相同）、contactIdentifier（线程归档键，可能是 E.164 电话、WhatsApp BSUID、数字聊天 ID 或群组 JID，不可当作电话号码解析）、contactId（群组线程中缺失）、channels、lastMessage 预览、senderId、unreadCount，以及 whatsapp 和 group 信息。
接口：列表 GET /v1/conversations（按最近活跃排序），单线程 GET /v1/conversations/{conversationId}，线程消息 GET /v1/conversations/{conversationId}/messages（最新在前），标记已读 POST /v1/conversations/{conversationId}/read。这些接口尚未进入生成的 SDK，需用 REST。请求头使用 Authorization: Bearer $ZAVUDEV_API_KEY。列表支持 senderId 和 channel 过滤；search 按对方身份（电话、邮箱、群组主题、WhatsApp 用户名或 BSUID）匹配，按相关性而非时间排序，空搜索不返回任何结果，且不搜索消息正文。分页使用不透明游标，原样回传 nextCursor，为 null 时结束；channel 过滤在取回每页后应用，短页甚至空页仍可能带有 nextCursor。
用法要点：消息的 direction 区分收发，不能用 status 判断。回复使用 POST /v1/messages，向 contactIdentifier 发送，并把 senderId 作为 Zavu-Sender 传入。WhatsApp 有 24 小时窗口限制，超时需用已批准模板；回复渠道须是发件人实际拥有的渠道。Webhook message.inbound 的 data.conversationId 在新线程时可能为 null，可改用 conversation.new 事件或 GET /v1/messages/{messageId} 恢复，不要用列会话匹配号码。
限制：API 只提供线程、消息和已读状态，不保存分配、打开/完成状态、内部备注或快捷回复，这些状态由应用自行管理；/read 只清除自己的未读数，不通知联系人。