Get Conversation History

In this page we show you how to get the conversation history.

The API call below is used to retrieve the conversation history of an appUser.

The URL includes placeholders for the organization ID and phone number, which need to be replaced with actual values to make the request.

cURL

curl --location 'channel360.co.za/v1.1/org/{{orgId}}/whatsapp/subscriber/{{number}}/conversation/history'

This YAML outlines an API endpoint for retrieving the chat history of a WhatsApp subscriber.

The endpoint is intended to process GET requests, allowing users to receive conversation history data.

Get conversation history

API request for subscriber history

GEThttps://www.channel360.co.za/v1.1/org/{orgId}/whatsapp/subscriber/{destinationId}/conversation/history

Path parameters

orgId*string

destinationId*string

Response

200

Successfully got subscriber history

Body

application/json

conversationobject

Request

JavaScriptCurlPython

const response = await fetch('https://www.channel360.co.za/v1.1/org/{orgId}/whatsapp/subscriber/{destinationId}/conversation/history', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "conversation": {
    "_id": "edf85dfg2h82d5f2d93s",
    "appMakers": [
      "2wm6nj7i8d09fg8h45c7"
    ],
    "appUsers": [
      "1ac7d0552c1d39677a5188d0"
    ],
    "unreadCount": 0,
    "messages": [
      {
        "source": {
          "type": "notification",
          "id": "052hbn85-8jk6-8k5l-96yu-15gh63er81qn"
        },
        "role": "appMaker",
        "authorId": "20er54fy69nm43hjtd85uo",
        "type": "text",
        "avatarUrl": "https://www.gravatar.com/avatar/00000000000000000000000000000000.png?s=200&d=mm",
        "text": "Hello World",
        "received": 17052641852,
        "_id": "253kmlj8d51520dfgvs523"
      }
    ]
  }
}