Chat Restaurant Insights

post

https://api.getkivly.com/api/v1/restaurant-insights/chat

Conversational growth insights for the current user's location.

Integration access is restricted to the credential's location. Pagination, monetary units and response envelopes are endpoint-specific; use the schema below. Do not assume that POST/PATCH requests are safe to retry after a timeout.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

message

string

required

locationId

branchId

preset

string

enum

Defaults to LAST_7_DAYS

Preset de periodo (alineado a UI + rolling).

TODAY: día operativo en curso hasta ahora (corte 03:00 hora del local).
LAST_CLOSED_OPERATING_DAY: último día operativo ya cerrado (bloque 03:00→03:00 hora local).
La hora a la que se envía un informe por email es independiente (p. ej. job a las 09:00 Europe/Madrid).
PREVIOUS_WEEK: semana natural completa anterior (lunes–domingo) con días operativos.
PREVIOUS_MONTH: mes de calendario natural anterior (del día 1 al último día),
con ventanas operativas 03:00→03:00 en cada día.

comparePreset

SalesAnalyticsPreset | null

startDate

endDate

timezone

string

Defaults to Europe/Madrid

Responses

200Successful Response

401Authentication credentials were missing, invalid, or expired.

403The authenticated integration does not have access to this resource.

422Validation Error

429Too many requests. Retry after the period indicated by the API.

500Unexpected server error.

503Shared integration limiter unavailable. Retry after the indicated delay.