NavoChat开发者文档
发送客户消息和身份
使用稳定外部 ID 创建会话、保持线程，并更新客户资料。
更新于 2026-07-24适合: 后端开发者
向渠道入站地址发送 JSON：
{
"messageId": "msg-001",
"threadId": "thread-001",
"occurredAt": "2026-07-24T08:00:00Z",
"customer": {
"id": "customer-001",
"name": "示例客户",
"email": "[email protected]"
},
"message": {
"type": "text",
"text": "我需要帮助",
"attachmentIds": []
},
"metadata": {}
}
ID 规则
messageId：渠道内幂等 ID。相同 ID 重试会返回原结果，并标记duplicate: true。threadId：你系统中的稳定会话线程。同一 ID 会持续关联同一条 NavoChat 会话。customer.id：渠道内稳定客户 ID。同一客户跨线程复用客户记录。- 已绑定的
threadId不能更换customer.id，否则返回409。
客户资料
customer.name 必填；邮箱、电话和公司可选。只更新本次提交的非空字段，缺失或 null 不会清空已有资料。重复 messageId 不会再次更新客户。
消息限制
请求体最大 64 KB，文本最大 20,000 字符。type=text 必须包含文本；type=attachment 必须包含至少一个已完成的附件。