discovery

List conversation previews (v3)

List the newest conversations of a campaign's results window (dated in the 30 days ending its as-of day, scope.window) as previews, at most 12, optionally narrowed to segments: each customer's name and job title or age, the assistant, when it happened, the brands it named and their role, and its first turns. Of those, the ones held in the campaign's language come first, newest first within each group: the campaign's language is its profile's, else English, and a customer who declares no language speaks it. A campaign without results answers its state and no previews. Page through and search every conversation with discovery_conversations_list_v2.

get/api/v1/discovery/conversation-previews-v3

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/conversation-previews-v3
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Query parameters

limitinteger

Number of previews to return (1–12)

cursorstring

Opaque cursor returned as nextCursor by the previous page

campaignIdstring uuid required

Discovery campaign id.

dateRangestring nullable

Result window: all, a preset id, or yyyy-MM-dd..yyyy-MM-dd. Omit for the campaign's default window.

segmentsstring[]

Narrows the read to these segments, ANDed: one axis:id per axis (any number of distinct customer: entries), in canonical axis order. Empty reads the whole dispatch.

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success.

nextCursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.