Conversation

object

idrequired: Id
Opaque record id.
channelrequired: string
channel_account_idrequired: Id
Opaque record id.
contactrequired: object
contact.idrequired: Id
Opaque record id.
contact.namerequired: string
contact.addressrequired: string or null
lead_idrequired: Id or null
Opaque record id.
assignee_idrequired: Id or null
Opaque record id.
statusrequired: string
labelsrequired: array of string
unread_countrequired: integer
unread_for_merequired: boolean
News for the viewer: the unread count for the assignee (or on an unassigned chat); for anyone else, a customer message after their own last look.
last_message_atrequired: DateTime or null
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
last_inbound_atrequired: DateTime or null
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
last_message_previewrequired: string or null
windowrequired: object or null
WhatsApp 24-hour customer-service window (null for other channels).
window.openrequired: boolean
window.expires_atrequired: DateTime or null
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
is_archivedrequired: boolean
is_pinnedrequired: boolean
snoozed_untilrequired: DateTime or null
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
created_atrequired: DateTime
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
can_noterequired: boolean
Whether the caller may add a note here: edit access to the lead, or to the contact when there is none.
airequired: object or null
What the WhatsApp AI agent recorded (state, latest intent) read as one label, and the lead score; null when the AI never handled the chat.
ai.labelrequired: "needs_attention" | "site_visit" | "qualified" | "price_enquiry" or null
ai.staterequired: string or null
ai.intentrequired: string or null
ai.scorerequired: integer or null

Example

{
  "id": "cmusrceel0000q7kaafxqi1om",
  "channel": "string",
  "channel_account_id": "cmusrceel0000q7kaafxqi1om",
  "contact": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "name": "string",
    "address": "string"
  },
  "lead_id": "cmusrceel0000q7kaafxqi1om",
  "assignee_id": "cmusrceel0000q7kaafxqi1om",
  "status": "string",
  "labels": [
    "string"
  ],
  "unread_count": 0,
  "unread_for_me": true,
  "last_message_at": "2026-10-06T05:30:00.000Z",
  "last_inbound_at": "2026-10-06T05:30:00.000Z",
  "last_message_preview": "string",
  "window": {
    "open": true,
    "expires_at": "2026-10-06T05:30:00.000Z"
  },
  "is_archived": true,
  "is_pinned": true,
  "snoozed_until": "2026-10-06T05:30:00.000Z",
  "created_at": "2026-10-06T05:30:00.000Z",
  "can_note": true,
  "ai": {
    "label": "needs_attention",
    "state": "string",
    "intent": "string",
    "score": 0
  }
}

{ "id": "cmusrceel0000q7kaafxqi1om", "channel": "string", "channel_account_id": "cmusrceel0000q7kaafxqi1om", "contact": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string", "address": "string" }, "lead_id": "cmusrceel0000q7kaafxqi1om", "assignee_id": "cmusrceel0000q7kaafxqi1om", "status": "string", "labels": [ "string" ], "unread_count": 0, "unread_for_me": true, "last_message_at": "2026-10-06T05:30:00.000Z", "last_inbound_at": "2026-10-06T05:30:00.000Z", "last_message_preview": "string", "window": { "open": true, "expires_at": "2026-10-06T05:30:00.000Z" }, "is_archived": true, "is_pinned": true, "snoozed_until": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "can_note": true, "ai": { "label": "needs_attention", "state": "string", "intent": "string", "score": 0 } }