latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

whatsapp

List WhatsApp conversations

Retrieves WhatsApp conversations, optionally filtered by account UUID, with pagination support.

Permission: Access is managed by the WhatsApp service. No specific API token permission is checked.

Monitoring: No impact.

post/whatsapp/conversations

Request body

limit_countinteger
limit_offsetinteger
account_uuidstring

Example request

{
  "limit_count": 10,
  "account_uuid": "1eb09f33-348e-42e6-bfb3-361df133c82e"
}

Response

Successful operation — returns the list of conversations.

limit_offset_settedinteger
limit_count_settedinteger
total_conversation_countinteger
conversation_list_countinteger

Example response

{
  "limit_count_setted": 1,
  "total_conversation_count": 8,
  "conversation_list_count": 1,
  "conversation_list": [
    {
      "account_name": "Whatsapp Account",
      "account_namespace": "6bf15414_2a1e_4fb7_908a_e3dcba477054",
      "account_number": 123456789,
      "account_uuid": "63960521-fa29-11ed-abf8-002590bb0d88",
      "application_id": "d282b8a1-7f70-444a-8645-ec3fa6103e29",
      "creation_date": "2024-06-11T06:47:15.776738Z",
      "external_number": {
        "number": 124356789
      },
      "internal_number": {
        "alphanumeric": "Sophien RO",
        "number": 123456789
      },
      "last_message": {
        "creation_date": "2025-02-20T12:41:31.635066Z",
        "data": "Hello",
        "direction": "out",
        "status": "DELIVERED",
        "update_date": "2025-02-20T12:41:34.641784Z",
        "user_id": 1,
        "uuid": "43b319d0-d601-4c23-b0e7-6c08e7472cce"
      },
      "last_message_data": "Hello",
      "note_count": 2,
      "status": "active",
      "team_id": 1,
      "update_date": "2025-02-20T12:41:31.635066Z",
      "uuid": "a06cac2f-364b-4537-931f-f191def09587",
      "waba_id": "105771022534126",
      "window_start_date": "2025-02-19T13:00:35.517608Z"
    }
  ]
}