Message interactions

You can list message interactions on a specific message using the following endpoint. In order to get a WhatsApp message, you must have an active WhatsApp channel and perform a HTTP request with a valid access key

List message interactions

List message interactions

get

/workspaces/{workspaceId}/channels/{channelId}/messages/{messageId}/interactions

Authorizations

useraccessKey

Path parameters

workspaceIdstring · uuidrequired

The ID of the workspace

messageIdstring · uuidrequired

The ID for a message

channelIdstring · uuidrequired

The ID for a channel

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/workspaces/{workspaceId}/channels/{channelId}/messages/{messageId}/interactions' \
  --header 'Authorization: Bearer jwt'

200

404

200

{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "messageId": "123e4567-e89b-12d3-a456-426614174000",
      "channelId": "123e4567-e89b-12d3-a456-426614174000",
      "platformId": "text",
      "messagePartId": "123e4567-e89b-12d3-a456-426614174000",
      "messageReference": "text",
      "messagePartsCount": 1,
      "createdAt": "2025-02-21T18:14:27.424Z",
      "details": "text",
      "type": "clicked",
      "messageTags": [
        "text"
      ],
      "receiver": {
        "connector": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "identifierValue": "text",
          "annotations": {
            "name": "text"
          },
          "types": [
            "text"
          ]
        }
      },
      "context": {
        "id": "text",
        "type": "text",
        "tags": [
          "text"
        ]
      },
      "metadata": {
        "prefetched": true,
        "link": {
          "name": "text",
          "url": "text"
        },
        "button": {
          "payload": "text"
        },
        "reaction": {
          "emoji": "text",
          "action": "text"
        },
        "conversion": {
          "type": "text",
          "status": "text",
          "method": "text",
          "timestamp": "2025-02-21T18:14:27.424Z"
        },
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}

OK

WhatsApp supports the following message interactions:

Interaction	Description
Read	A user has read a message
Clicked	A user has clicked a quick reply button

Additional information about the interactions can be found in the details field and metadata.button object as follows:

Interaction	details	metadata.button.	Description
Clicked	item_N_clicked	payload - user supplied payload sent in action button	Recipient clicked a quick reply button. N = the position of the item in the actions array of the associated message