Conversations

List conversations

Query WhatsApp conversations with filters. Results are returned by latest activity first and use cursor pagination.

get/whatsapp/conversations

Request

Query parameters

phone_number_idstring

Filter by WhatsApp phone number ID

phone_numberstring

Filter by contact phone number (partial match)

status'active' | 'ended'

Filter by conversation status

assigned_user_idstring uuid

Filter by active assignee user ID (must be a project member)

unassignedboolean

Filter conversations with no active assignment. Cannot be combined with assigned_user_id.

created_afterstring date-time

Filter conversations created after this timestamp

created_beforestring date-time

Filter conversations created before this timestamp

last_active_afterstring date-time

Filter conversations active after this timestamp

last_active_beforestring date-time

Filter conversations active before this timestamp

limitinteger

Maximum number of results per cursor-paginated page (default 20, max 100).

beforestring

Cursor for the previous page (Base64 encoded).

afterstring

Cursor for the next page (Base64 encoded).

Response

List of conversations

Changes

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