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.
GET
/workspaces/{workspaceId}/channels/{channelId}/messages/{messageId}/interactions
List message interactions
Cuerpo de la respuesta
results
array of object
Mostrar atributos secundarios
results.bodyTemplateProjectId
string
results.channelId
string
obligatorio
results.context
object
obligatorio
Mostrar atributos secundarios
results.context.id
string
results.context.tagIds
array of string
results.context.type
string
results.createdAt
string
obligatorio
results.details
string
results.id
string
obligatorio
results.isFirstInteraction
boolean
results.isFirstInteractionIncludingBots
boolean
results.journey
object
Mostrar atributos secundarios
results.journey.id
string
results.journey.name
string
results.journey.runId
string
results.journey.scheduleExecutionId
string
results.journey.stepId
string
results.messageCreatedAt
string
results.messageId
string
obligatorio
results.messagePartsCount
integer
obligatorio
results.messageReference
string
obligatorio
results.messageTags
array of string
results.metadata
object
Mostrar atributos secundarios
results.metadata.button
object
Mostrar atributos secundarios
results.metadata.button.payload
string
obligatorio
results.metadata.conversion
object
Mostrar atributos secundarios
results.metadata.conversion.method
string
Method of entering the code
Possible values: unknown, manual, auto
results.metadata.conversion.status
string
Status of the conversion
Possible values: converted, canceled, not_converted, incorrect_code, resent, received_after_expiration
results.metadata.conversion.timestamp
string
Timestamp of when the conversion was recorded
results.metadata.conversion.type
string
Type of conversion
Possible values: otp, url, promo_code
results.metadata.extraInformation
object
results.metadata.link
object
Mostrar atributos secundarios
results.metadata.link.clickType
string
Possible values: link, button
results.metadata.link.name
string
obligatorio
results.metadata.link.url
string
obligatorio
results.metadata.prefetched
boolean
results.metadata.reaction
object
Mostrar atributos secundarios
results.metadata.reaction.action
string
obligatorio
Possible values: react, unreact
results.metadata.reaction.emoji
string
obligatorio
results.metadata.renderedContentBlocks
array of string
results.metadata.subscriptionList
object
Mostrar atributos secundarios
results.metadata.subscriptionList.subscriptionListId
string
obligatorio
results.notification
object
Mostrar atributos secundarios
results.notification.template
string
results.notification.url
string
obligatorio
results.platformId
string
obligatorio
results.platformReferenceId
string
results.receiver
object
obligatorio
Mostrar atributos secundarios
results.receiver.connector
object
Mostrar atributos secundarios
results.receiver.connector.annotations
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Mostrar atributos secundarios
results.receiver.connector.annotations.name
string
results.receiver.connector.id
string
obligatorio
results.receiver.connector.identifierValue
string
The identifier value of the sender or receiver connector (e.g. email address or phone number).
results.receiver.connector.types
array of string
results.receiver.contacts
array of object
Mostrar atributos secundarios
results.receiver.contacts.contactAnnotation
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Mostrar atributos secundarios
results.receiver.contacts.contactAnnotation.name
string
results.receiver.contacts.countryCode
string
results.receiver.contacts.id
string
The ID of the contact.
results.receiver.contacts.identifierKey
string
The identifier key for finding the contact (e.g. emailaddress, phonenumber). For WhatsApp channels with BSUID support, use whatsappbsuid to send to a contact by their Business-Scoped User ID.
results.receiver.contacts.identifierValue
string
The identifier value for finding the contact.
results.receiver.contacts.identifiers
array of object
Additional identifiers to augment the contact during resolution.
Mostrar atributos secundarios
results.receiver.contacts.identifiers.identifierKey
string
obligatorio
The identifier key for finding the contact (e.g. emailaddress, phonenumber).
results.receiver.contacts.identifiers.identifierValue
string
obligatorio
The identifier value for finding the contact.
results.receiver.contacts.platformAddress
string
The resolved platform address used to deliver the message (e.g. phone number or email address).
results.receiver.contacts.platformAddressSelector
string
An expression that defines how we resolve the platform address from a contact. Optional override for the default resolution logic.
results.receiver.contacts.receiverExpression
string
results.receiver.contacts.receiverValue
string
results.receiver.contacts.type
string
The type of the receiver (e.g. to, cc, bcc for email).
results.receiver.device
object
Mostrar atributos secundarios
results.receiver.device.gateway
string
obligatorio
Possible values: firebase, apns, web
results.receiver.device.id
string
obligatorio
results.receiver.device.identifierValue
string
obligatorio
results.receiver.inbox
object
Mostrar atributos secundarios
results.receiver.inbox.emailRecipientType
string
results.receiver.inbox.id
string
obligatorio
results.receiver.inbox.identifierKey
string
obligatorio
results.receiver.inbox.identifierValue
string
obligatorio
results.receiver.inbox.type
string
obligatorio
Possible values: user, group
results.receiver.userContacts
array of object
Mostrar atributos secundarios
results.receiver.userContacts.id
string
obligatorio
results.receiver.userContacts.identifierKey
string
obligatorio
results.receiver.userContacts.identifierValue
string
obligatorio
results.receiver.userContacts.type
string
results.type
string
obligatorio
Possible values: invalid, read, opened, clicked, reported-as-spam, unsubscribe-request, delete, reaction, subscribe-request, subscribe-consent, conversion
results.useCaseType
string
Possible values: unspecified, marketing, otp, transactional, conversation, test
Ejemplo de código
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/channels/{channelId}/messages/{messageId}/interactions' \
-H 'Authorization: AccessKey YOUR_ACCESS_KEY'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 |
| Recipient clicked a quick reply button. N = the position of the item in the actions array of the associated message |