Create Chat Analysis

View as Markdown
Submit chat conversations for asynchronous analysis. HTTP 200 with a nonempty processing_id acknowledges receipt; not completed analysis. conversation_time uses epoch seconds; each message timestamp uses epoch milliseconds. Receive results through your dashboard-configured callback. [Chat Analytics guide](/chat-analytics). Each record supports optional lead source, CRM stage/substage, follow-up and lead creation times, location, customer phone, campaign identifiers, and tags. The full input schema below defines these fields; reprocess defaults to 0. A null processing_id means initiation was not confirmed, even with HTTP 200. Contact support before resubmitting.

Authentication

AuthorizationBearer
Existing private account API key from Developer Hub. Keep it on your backend.

Request

This endpoint expects an object.
service_idstringRequired

Authorized project/service name from Developer Hub.

datalist of objectsRequired

Between 1 and 50 records per batch. Per-record CRM, campaign, tag fields are described below.

Response

Batch initiation result. Acceptance requires a nonempty processing_id; a null value does not confirm acceptance.

processing_idstring or null

Batch identifier for tracking processing results. Acceptance requires a nonempty identifier. The existing endpoint can return HTTP 200 with null when initiation fails; contact support before resubmitting.

timestamplong
Request receipt time in Unix epoch seconds.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error