NavoChatNavoChat

开发者文档

API 渠道快速接入

发送第一条签名客户消息，并接收 NavoChat 的公开回复。

更新于 2026-07-24适合: 后端开发者

API 渠道包含两个方向：

  1. 你的服务调用入站接口，把客户消息交给 NavoChat。
  2. NavoChat 调用你的 Callback，发送客服或 AI 回复及会话事件。

最小接入流程

实现签名

对每个请求计算 HMAC-SHA256(signingSecret, timestamp + "." + rawBody)，并发送时间戳和签名请求头。

发送客户消息

使用稳定的 messageId、threadId 和 customer.id 调用渠道入站消息接口。

接收 Callback

公开一个 HTTPS POST 地址，先验证签名，再按事件 id 去重。

完成端到端验证

发送测试消息，在 NavoChat 回复，并确认你的系统收到 message.created。

接口地址

POST /api/public/api-channels/{channelId}/messages
POST /api/public/api-channels/{channelId}/uploads
POST /api/public/api-channels/{channelId}/uploads/presign
POST /api/public/api-channels/{channelId}/uploads/complete

相关指南

验证 API 渠道签名发送客户消息和身份接收和验证 API Callback