NavoChatNavoChat

Developer docs

API channel quickstart

Send your first signed customer message and receive a public reply from NavoChat.

Updated 2026-07-24For: Backend developers

An API channel has two directions:

  1. Your service calls the inbound API to deliver customer messages to NavoChat.
  2. NavoChat calls your callback with agent or AI replies and conversation events.

Minimal integration

Implement signing

For every request, calculate HMAC-SHA256(signingSecret, timestamp + "." + rawBody) and send the timestamp and signature headers.

Send a customer message

Call the inbound message endpoint with stable messageId, threadId, and customer.id values.

Receive callbacks

Expose an HTTPS POST endpoint, verify the signature first, then deduplicate by event id.

Run an end-to-end test

Send a test message, reply in NavoChat, and confirm that your system receives message.created.

Endpoints

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

Related guides

Sign and verify API channel requestsSend customer messages and identityReceive and verify API callbacks