No-code docs

Message interactions

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

List message interactions

get

List message interactions

Authorizations
Path parameters
workspaceIdstring · uuidRequired

The ID of the workspace

messageIdstring · uuidRequired

The ID for a message

channelIdstring · uuidRequired

The ID for a channel

Responses
200

OK

application/json
get
/workspaces/{workspaceId}/channels/{channelId}/messages/{messageId}/interactions
GET /workspaces/{workspaceId}/channels/{channelId}/messages/{messageId}/interactions HTTP/1.1
Host: api.bird.com
Authorization: AccessKey YOUR_SECRET_TOKEN
Accept: */*

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

Telegram supports the following message interactions:

Interaction
Description

Clicked

A user has clicked a quick reply button

Reaction

A user reacting to a message using an emoji

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

Last updated

Was this helpful?