/chat/stream
Ask the shopping assistant
Answers a shopper's question against the channel's own catalogue and content, and streams the reply as server-sent events rather than returning a body. Each event is a `data:` line carrying a JSON fragment; concatenate the text fragments as they arrive and stop at the terminating event.
Show the full description
Because the response is a stream, the 200 has no schema to document — read the event format from the frames themselves. Requires a session, and is enabled per channel through the enableChatAssistant feature flag. Tool results carry only product cards (id, name, slug, image, and price and stock when the channel shows them), and an error event carries a generic message rather than the underlying one.
Headers
| Field | Type | Description |
|---|---|---|
X-Language
|
string | Language for translated content, as an ISO 639-1 code ("sv", "en"). Omitting it answers in the channel's default language, and so does a language the channel does not publish — this never fails the request. The channel decides which languages exist; read them from the session response. |
Body required
| Field | Type | Description |
|---|---|---|
content
|
string · nullable | |
currentCategory
|
string · nullable | Kod eller slug för kategorin besökaren står i. |
currentProductId
|
string · nullable | Id eller slug för produkten besökaren står på. |
currentProductName
|
string · nullable | Ignoreras. Namnet slås upp i kanalens katalog från CurrentProductId; fältet ligger kvar så att äldre klienter inte får 400. |
history
|
ChatMessageDto[] · nullable | |
pricesIncludingVat
|
boolean · nullable | Om besökaren ser priser inklusive moms. Utelämnat = kanalens standard. |
Responses
Standard errors:
400
401
429
Errors
Examples
curl -X POST "https://api.erp.fluit.cloud/ecom/chat/stream" \
-H "Authorization: Bearer $SESSION_TOKEN" \
-H "X-Tenant-Id: $FLUIT_TENANT_ID" \
-H "X-Channel: web" \
-H "X-Language: …" \
-H "Content-Type: application/json" \
-d @body.jsonBase URL https://api.erp.fluit.cloud/ecom.