DokumentationEngagement Platform API
Sign inGet started
Guides
API

List conversation messages

GET
/workspaces/{workspaceId}/conversations/{conversationId}/messages
Lists conversation messages. This will return a maximum of 100 messages per page, with 10 as default. You can use the limit and pageToken query parameters to paginate the results. Learn more about pagination in the Common API Usage pagination section.
Pfadparameter
conversationId
string
The conversation ID
Abfrageparameter
limit
integer
pageToken
string
reverse
boolean
dateFrom
string
Filter by created date after this date.
Antwort-Payload
results
array of object
List of messages in the conversation.
Untergeordnete Attribute anzeigen
results.body
object
Untergeordnete Attribute anzeigen
results.body.text
object
erforderlich
Untergeordnete Attribute anzeigen
results.body.text.actions
array of object
Untergeordnete Attribute anzeigen
results.body.text.actions.link
object
erforderlich
Untergeordnete Attribute anzeigen
results.body.text.actions.link.metadata
object
Untergeordnete Attribute anzeigen
results.body.text.actions.link.metadata.description
object
Untergeordnete Attribute anzeigen
results.body.text.actions.link.metadata.description.label
string
erforderlich
results.body.text.actions.link.text
string
erforderlich
results.body.text.actions.link.url
string
erforderlich
results.body.text.actions.type
string
erforderlich
Possible values: link
results.body.text.attachments
array of object
Untergeordnete Attribute anzeigen
results.body.text.attachments.content
string
results.body.text.attachments.contentId
string
results.body.text.attachments.contentType
string
results.body.text.attachments.filename
string
erforderlich
results.body.text.attachments.inline
boolean
results.body.text.attachments.mediaUrl
string
erforderlich
results.body.text.metadata
object
Untergeordnete Attribute anzeigen
results.body.text.metadata.apple
object
Untergeordnete Attribute anzeigen
results.body.text.metadata.apple.appClipPreview
boolean
results.body.text.metadata.apple.appClipRegion
string
results.body.text.metadata.apple.summaryText
string
results.body.text.metadata.headers
object
results.body.text.metadata.line
object
Untergeordnete Attribute anzeigen
results.body.text.metadata.line.emoji
object
Untergeordnete Attribute anzeigen
results.body.text.metadata.line.emoji.items
array of object
Untergeordnete Attribute anzeigen
results.body.text.metadata.line.emoji.items.emojiId
string
erforderlich
results.body.text.metadata.line.emoji.items.index
integer
erforderlich
results.body.text.metadata.line.emoji.items.length
integer
results.body.text.metadata.line.emoji.items.productId
string
erforderlich
results.body.text.metadata.paymentDetails
object
Untergeordnete Attribute anzeigen
results.body.text.metadata.paymentDetails.amount
string
erforderlich
results.body.text.metadata.paymentDetails.currency
string
erforderlich
results.body.text.metadata.paymentDetails.sessionIdentifier
string
results.body.text.metadata.paymentDetails.state
string
erforderlich
results.body.text.metadata.subject
string
results.body.text.metadata.telegram
object
Untergeordnete Attribute anzeigen
results.body.text.metadata.telegram.parseMode
string
results.body.text.metadata.whatsapp
object
Untergeordnete Attribute anzeigen
results.body.text.metadata.whatsapp.callPermissionExpiration
string
results.body.text.metadata.whatsapp.callPermissionResponse
string
Possible values: accept, reject
results.body.text.metadata.whatsapp.previewUrl
boolean
erforderlich
results.body.text.metadata.whatsapp.sharedContacts
array of object
Untergeordnete Attribute anzeigen
results.body.text.metadata.whatsapp.sharedContacts.origin
string
erforderlich
results.body.text.metadata.whatsapp.sharedContacts.phones
array of object
Untergeordnete Attribute anzeigen
results.body.text.metadata.whatsapp.sharedContacts.phones.phone
string
erforderlich
results.body.text.metadata.whatsapp.sharedContacts.phones.type
string
erforderlich
results.body.text.metadata.whatsapp.sharedContacts.phones.waId
string
erforderlich
results.body.text.metadata.whatsapp.sharedContacts.vcard
string
results.body.text.text
string
erforderlich
results.body.type
string
erforderlich
Possible values: text
results.channelId
string
results.conversationCreatedAt
string
results.conversationId
string
erforderlich
results.createdAt
string
erforderlich
results.draft
boolean
erforderlich
Whether this message is a draft.
results.draftMeta
object
Metadata for draft messages.
Untergeordnete Attribute anzeigen
results.draftMeta.creatorType
string
erforderlich
Possible values: user, bot
results.id
string
erforderlich
A unique identifier for this message.
results.interactions
array of object
A list of interactions associated with the message (e.g. read receipts, clicks, reactions).
Untergeordnete Attribute anzeigen
results.interactions.bodyTemplateProjectId
string
results.interactions.channelId
string
erforderlich
results.interactions.context
object
erforderlich
Untergeordnete Attribute anzeigen
results.interactions.context.id
string
results.interactions.context.tagIds
array of string
results.interactions.context.type
string
results.interactions.createdAt
string
erforderlich
results.interactions.details
string
results.interactions.id
string
erforderlich
results.interactions.isFirstInteraction
boolean
results.interactions.isFirstInteractionIncludingBots
boolean
results.interactions.journey
object
Untergeordnete Attribute anzeigen
results.interactions.journey.id
string
results.interactions.journey.name
string
results.interactions.journey.runId
string
results.interactions.journey.scheduleExecutionId
string
results.interactions.journey.stepId
string
results.interactions.messageCreatedAt
string
results.interactions.messageId
string
erforderlich
results.interactions.messagePartsCount
integer
erforderlich
results.interactions.messageReference
string
erforderlich
results.interactions.messageTags
array of string
results.interactions.metadata
object
Untergeordnete Attribute anzeigen
results.interactions.metadata.button
object
Untergeordnete Attribute anzeigen
results.interactions.metadata.button.payload
string
erforderlich
results.interactions.metadata.conversion
object
Untergeordnete Attribute anzeigen
results.interactions.metadata.conversion.method
string
Method of entering the code
Possible values: unknown, manual, auto
results.interactions.metadata.conversion.status
string
Status of the conversion
Possible values: converted, canceled, not_converted, incorrect_code, resent, received_after_expiration
results.interactions.metadata.conversion.timestamp
string
Timestamp of when the conversion was recorded
results.interactions.metadata.conversion.type
string
Type of conversion
Possible values: otp, url, promo_code
results.interactions.metadata.extraInformation
object
results.interactions.metadata.link
object
Untergeordnete Attribute anzeigen
results.interactions.metadata.link.clickType
string
Possible values: link, button
results.interactions.metadata.link.name
string
erforderlich
results.interactions.metadata.link.url
string
erforderlich
results.interactions.metadata.prefetched
boolean
results.interactions.metadata.reaction
object
Untergeordnete Attribute anzeigen
results.interactions.metadata.reaction.action
string
erforderlich
Possible values: react, unreact
results.interactions.metadata.reaction.emoji
string
erforderlich
results.interactions.metadata.renderedContentBlocks
array of string
results.interactions.metadata.subscriptionList
object
Untergeordnete Attribute anzeigen
results.interactions.metadata.subscriptionList.subscriptionListId
string
erforderlich
results.interactions.notification
object
Untergeordnete Attribute anzeigen
results.interactions.notification.template
string
results.interactions.notification.url
string
erforderlich
results.interactions.platformId
string
erforderlich
results.interactions.platformReferenceId
string
results.interactions.receiver
object
erforderlich
Untergeordnete Attribute anzeigen
results.interactions.receiver.connector
object
Untergeordnete Attribute anzeigen
results.interactions.receiver.connector.annotations
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Untergeordnete Attribute anzeigen
results.interactions.receiver.connector.annotations.name
string
results.interactions.receiver.connector.id
string
erforderlich
results.interactions.receiver.connector.identifierValue
string
The identifier value of the sender or receiver connector (e.g. email address or phone number).
results.interactions.receiver.connector.types
array of string
results.interactions.receiver.contacts
array of object
Untergeordnete Attribute anzeigen
results.interactions.receiver.contacts.contactAnnotation
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Untergeordnete Attribute anzeigen
results.interactions.receiver.contacts.contactAnnotation.name
string
results.interactions.receiver.contacts.countryCode
string
results.interactions.receiver.contacts.id
string
The ID of the contact.
results.interactions.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.interactions.receiver.contacts.identifierValue
string
The identifier value for finding the contact.
results.interactions.receiver.contacts.identifiers
array of object
Additional identifiers to augment the contact during resolution.
Untergeordnete Attribute anzeigen
results.interactions.receiver.contacts.identifiers.identifierKey
string
erforderlich
The identifier key for finding the contact (e.g. emailaddress, phonenumber).
results.interactions.receiver.contacts.identifiers.identifierValue
string
erforderlich
The identifier value for finding the contact.
results.interactions.receiver.contacts.platformAddress
string
The resolved platform address used to deliver the message (e.g. phone number or email address).
results.interactions.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.interactions.receiver.contacts.receiverExpression
string
results.interactions.receiver.contacts.receiverValue
string
results.interactions.receiver.contacts.type
string
The type of the receiver (e.g. to, cc, bcc for email).
results.interactions.receiver.device
object
Untergeordnete Attribute anzeigen
results.interactions.receiver.device.gateway
string
erforderlich
Possible values: firebase, apns, web
results.interactions.receiver.device.id
string
erforderlich
results.interactions.receiver.device.identifierValue
string
erforderlich
results.interactions.receiver.inbox
object
Untergeordnete Attribute anzeigen
results.interactions.receiver.inbox.emailRecipientType
string
results.interactions.receiver.inbox.id
string
erforderlich
results.interactions.receiver.inbox.identifierKey
string
erforderlich
results.interactions.receiver.inbox.identifierValue
string
erforderlich
results.interactions.receiver.inbox.type
string
erforderlich
Possible values: user, group
results.interactions.receiver.userContacts
array of object
Untergeordnete Attribute anzeigen
results.interactions.receiver.userContacts.id
string
erforderlich
results.interactions.receiver.userContacts.identifierKey
string
erforderlich
results.interactions.receiver.userContacts.identifierValue
string
erforderlich
results.interactions.receiver.userContacts.type
string
results.interactions.type
string
erforderlich
Possible values: invalid, read, opened, clicked, reported-as-spam, unsubscribe-request, delete, reaction, subscribe-request, subscribe-consent, conversion
results.interactions.useCaseType
string
Possible values: unspecified, marketing, otp, transactional, conversation, test
results.meta
object
Untergeordnete Attribute anzeigen
results.meta.campaign
object
Untergeordnete Attribute anzeigen
results.meta.campaign.id
string
results.meta.campaign.name
string
results.meta.campaignId
string
results.meta.chargeOnceDelivered
boolean
results.meta.email
object
Untergeordnete Attribute anzeigen
results.meta.email.from
object
Untergeordnete Attribute anzeigen
results.meta.email.from.displayName
string
results.meta.email.from.username
string
results.meta.email.headers
object
results.meta.email.subject
string
results.meta.extraInformation
object
results.meta.flow
object
Untergeordnete Attribute anzeigen
results.meta.flow.id
string
results.meta.flow.name
string
results.meta.flow.runId
string
results.meta.flow.scheduleExecutionId
string
results.meta.flow.stepId
string
results.meta.formResponse
object
Untergeordnete Attribute anzeigen
results.meta.formResponse.id
string
erforderlich
results.meta.formResponse.jsonResponse
string
erforderlich
results.meta.formResponse.requestIdentifier
string
erforderlich
results.meta.formResponse.selections
array of object
Untergeordnete Attribute anzeigen
results.meta.formResponse.selections.items
array of object
Untergeordnete Attribute anzeigen
results.meta.formResponse.selections.items.identifier
string
erforderlich
results.meta.formResponse.selections.items.title
string
erforderlich
results.meta.formResponse.selections.items.type
string
erforderlich
results.meta.formResponse.selections.items.value
string
erforderlich
results.meta.formResponse.selections.pageIdentifier
string
erforderlich
results.meta.formResponse.selections.subtitle
string
erforderlich
results.meta.formResponse.selections.title
string
erforderlich
results.meta.formResponse.sessionIdentifier
string
erforderlich
results.meta.formResponse.template
string
erforderlich
results.meta.formResponse.version
string
erforderlich
results.meta.ignoreGlobalHoldout
boolean
results.meta.ignoreQuietHours
boolean
results.meta.journey
object
Untergeordnete Attribute anzeigen
results.meta.journey.id
string
results.meta.journey.name
string
results.meta.journey.runId
string
results.meta.journey.scheduleExecutionId
string
results.meta.journey.stepId
string
results.meta.longToShortLinks
object
results.meta.metaThreadId
string
results.meta.navigatorId
string
results.meta.navigatorMessageId
string
results.meta.order
object
The order object contains information about the purchase order associated with the message.
Untergeordnete Attribute anzeigen
results.meta.order.products
array of object
Untergeordnete Attribute anzeigen
results.meta.order.products.externalCatalogId
string
The platform-specific catalog ID of the product.
results.meta.order.products.externalProductId
string
erforderlich
The platform-specific product ID.
results.meta.order.products.price
object
erforderlich
Untergeordnete Attribute anzeigen
results.meta.order.products.price.amount
integer
erforderlich
results.meta.order.products.price.currencyCode
string
erforderlich
results.meta.order.products.price.exponent
integer
erforderlich
results.meta.order.products.quantity
integer
erforderlich
The number of items purchased.
results.meta.pushNotifications
object
Untergeordnete Attribute anzeigen
results.meta.pushNotifications.gatewayTypeOverride
string
Possible values: firebase, apns, web
results.meta.referral
object
Untergeordnete Attribute anzeigen
results.meta.referral.group
string
results.meta.referral.metadata
object
Untergeordnete Attribute anzeigen
results.meta.referral.metadata.caption
string
results.meta.referral.metadata.mediaType
string
results.meta.referral.metadata.mediaUrl
string
results.meta.referral.metadata.sourceId
string
erforderlich
results.meta.referral.metadata.sourceUrl
string
results.meta.referral.metadata.timestamp
string
results.meta.referral.metadata.trackingId
string
results.meta.referral.metadata.username
string
results.meta.referral.source
string
erforderlich
results.meta.referral.text
string
results.meta.referral.title
string
results.meta.referredProduct
object
Referred product in an incoming message (e.g. a product shared in a WhatsApp catalog message).
Untergeordnete Attribute anzeigen
results.meta.referredProduct.externalCatalogId
string
The platform-specific catalog ID of the product.
results.meta.referredProduct.externalProductId
string
erforderlich
The platform-specific product ID.
results.meta.renderedContentBlocks
array of string
results.meta.shortToLongLinks
object
results.meta.skipThisMessage
string
Possible values: campaignHoldout, globalHoldout, journeyHoldout
results.meta.sms
object
Untergeordnete Attribute anzeigen
results.meta.sms.gatewayId
integer
results.meta.sms.registeredDelivery
string
Possible values: final, intermediate, all, noDlr
results.meta.sms.smartEncoding
boolean
When enabled, attempts to transliterate Unicode characters to GSM-7 equivalents. If the resulting text is fully GSM-7 compatible, fewer message segments may be required. The original message body is preserved; transliteration is only applied when sending.
results.meta.sms.smpp
object
Untergeordnete Attribute anzeigen
results.meta.sms.smpp.segments
array of object
Untergeordnete Attribute anzeigen
results.meta.sms.smpp.segments.id
string
erforderlich
results.meta.sms.smpp.segments.registeredDelivery
string
erforderlich
Possible values: final, intermediate, all, noDlr
results.meta.sms.smpp.userId
string
erforderlich
results.meta.sms.validity
string
results.meta.useFallback
boolean
results.reason
string
Failure reason. Populated when status is sending_failed or delivery_failed.
results.receiver
object
Untergeordnete Attribute anzeigen
results.receiver.connector
object
Untergeordnete Attribute anzeigen
results.receiver.connector.annotations
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Untergeordnete Attribute anzeigen
results.receiver.connector.annotations.name
string
results.receiver.connector.id
string
erforderlich
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
Untergeordnete Attribute anzeigen
results.receiver.contacts.contactAnnotation
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Untergeordnete Attribute anzeigen
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.
Untergeordnete Attribute anzeigen
results.receiver.contacts.identifiers.identifierKey
string
erforderlich
The identifier key for finding the contact (e.g. emailaddress, phonenumber).
results.receiver.contacts.identifiers.identifierValue
string
erforderlich
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
Untergeordnete Attribute anzeigen
results.receiver.device.gateway
string
erforderlich
Possible values: firebase, apns, web
results.receiver.device.id
string
erforderlich
results.receiver.device.identifierValue
string
erforderlich
results.receiver.inbox
object
Untergeordnete Attribute anzeigen
results.receiver.inbox.emailRecipientType
string
results.receiver.inbox.id
string
erforderlich
results.receiver.inbox.identifierKey
string
erforderlich
results.receiver.inbox.identifierValue
string
erforderlich
results.receiver.inbox.type
string
erforderlich
Possible values: user, group
results.receiver.userContacts
array of object
Untergeordnete Attribute anzeigen
results.receiver.userContacts.id
string
erforderlich
results.receiver.userContacts.identifierKey
string
erforderlich
results.receiver.userContacts.identifierValue
string
erforderlich
results.receiver.userContacts.type
string
results.receiverTypes
array of string
Receiver types for the message (to/cc/bcc). Currently only used for inbound email messages.
results.recipients
array of object
Untergeordnete Attribute anzeigen
results.recipients.contactAnnotation
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Untergeordnete Attribute anzeigen
results.recipients.contactAnnotation.name
string
results.recipients.countryCode
string
results.recipients.id
string
The ID of the contact.
results.recipients.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.recipients.identifierValue
string
The identifier value for finding the contact.
results.recipients.identifiers
array of object
Additional identifiers to augment the contact during resolution.
Untergeordnete Attribute anzeigen
results.recipients.identifiers.identifierKey
string
erforderlich
The identifier key for finding the contact (e.g. emailaddress, phonenumber).
results.recipients.identifiers.identifierValue
string
erforderlich
The identifier value for finding the contact.
results.recipients.platformAddress
string
The resolved platform address used to deliver the message (e.g. phone number or email address).
results.recipients.platformAddressSelector
string
An expression that defines how we resolve the platform address from a contact. Optional override for the default resolution logic.
results.recipients.receiverExpression
string
results.recipients.receiverValue
string
results.recipients.type
string
The type of the receiver (e.g. to, cc, bcc for email).
results.reference
string
erforderlich
A customizable ID assigned to messages you send. Can be used to correlate messages with data from your own services. Must be globally unique within a workspace.
results.replyTo
object
Untergeordnete Attribute anzeigen
results.replyTo.id
string
The ID of the message that is being replied to.
results.replyTo.order
integer
The order of the message part in the conversation.
results.replyTo.platformReference
string
results.replyTo.type
string
Possible values: message, click
results.resourceUri
string
results.sender
object
erforderlich
Untergeordnete Attribute anzeigen
results.sender.email
string
results.sender.name
string
results.sender.avatarUrl
string
results.sender.contact
object
Untergeordnete Attribute anzeigen
results.sender.contact.identifierKey
string
erforderlich
results.sender.contact.identifierValue
string
erforderlich
results.sender.contact.platformAddress
string
results.sender.contact.platformAddressSelector
string
results.sender.conversationId
string
results.sender.createdAt
string
results.sender.displayName
string
results.sender.id
string
erforderlich
results.sender.resourceUri
string
results.sender.status
string
Possible values: invited, pending, active, inactive
results.sender.type
string
erforderlich
Possible values: user, contact, agent, flow, bot, accessKey, channel, connector, collaborationAutomation
results.sender.updatedAt
string
results.source
string
erforderlich
Possible values: conversations, channels, bots, external
results.status
string
erforderlich
Possible values: accepted, processing, sent, sending_failed, delivered, delivery_failed, deleted
results.template
object
Untergeordnete Attribute anzeigen
results.template.attachments
array of object
Untergeordnete Attribute anzeigen
results.template.attachments.content
string
results.template.attachments.contentType
string
results.template.attachments.filename
string
erforderlich
results.template.attachments.inline
boolean
erforderlich
results.template.attachments.mediaUrl
string
erforderlich
results.template.deployment
object
results.template.locale
string
erforderlich
results.template.name
string
The platform name of the template.
results.template.parameters
array of object
Untergeordnete Attribute anzeigen
results.template.parameters.key
string
erforderlich
results.template.parameters.sourceUrl
object
Untergeordnete Attribute anzeigen
results.template.parameters.sourceUrl.fullyReplaced
boolean
erforderlich
results.template.parameters.sourceUrl.value
string
erforderlich
results.template.parameters.type
string
erforderlich
Possible values: string, timeslotList, productSections, productList, number, boolean, sectionList, shippingMethodList, lineItemList, whatsappProductSections, whatsappProductItems, shortLink, object, carouselCards, appleFormPageItems
results.template.parameters.value
object or array or string or number or boolean
erforderlich
results.template.projectId
string
erforderlich
The ID of the project from Studio.
results.template.settings
object
Untergeordnete Attribute anzeigen
results.template.settings.disallowMmLite
boolean
results.template.shortLinks
object
Untergeordnete Attribute anzeigen
results.template.shortLinks.domain
string
erforderlich
The domain to use when shortening links. When set to default, uses the default link shortening domain for the workspace.
results.template.shortLinks.enabled
boolean
erforderlich
Enables link shortening for SMS messages.
results.template.templateBody
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text
object
erforderlich
Untergeordnete Attribute anzeigen
results.template.templateBody.text.actions
array of object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.actions.link
object
erforderlich
Untergeordnete Attribute anzeigen
results.template.templateBody.text.actions.link.metadata
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.actions.link.metadata.description
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.actions.link.metadata.description.label
string
erforderlich
results.template.templateBody.text.actions.link.text
string
erforderlich
results.template.templateBody.text.actions.link.url
string
erforderlich
results.template.templateBody.text.actions.type
string
erforderlich
Possible values: link
results.template.templateBody.text.attachments
array of object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.attachments.content
string
results.template.templateBody.text.attachments.contentId
string
results.template.templateBody.text.attachments.contentType
string
results.template.templateBody.text.attachments.filename
string
erforderlich
results.template.templateBody.text.attachments.inline
boolean
results.template.templateBody.text.attachments.mediaUrl
string
erforderlich
results.template.templateBody.text.metadata
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.apple
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.apple.appClipPreview
boolean
results.template.templateBody.text.metadata.apple.appClipRegion
string
results.template.templateBody.text.metadata.apple.summaryText
string
results.template.templateBody.text.metadata.headers
object
results.template.templateBody.text.metadata.line
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.line.emoji
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.line.emoji.items
array of object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.line.emoji.items.emojiId
string
erforderlich
results.template.templateBody.text.metadata.line.emoji.items.index
integer
erforderlich
results.template.templateBody.text.metadata.line.emoji.items.length
integer
results.template.templateBody.text.metadata.line.emoji.items.productId
string
erforderlich
results.template.templateBody.text.metadata.paymentDetails
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.paymentDetails.amount
string
erforderlich
results.template.templateBody.text.metadata.paymentDetails.currency
string
erforderlich
results.template.templateBody.text.metadata.paymentDetails.sessionIdentifier
string
results.template.templateBody.text.metadata.paymentDetails.state
string
erforderlich
results.template.templateBody.text.metadata.subject
string
results.template.templateBody.text.metadata.telegram
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.telegram.parseMode
string
results.template.templateBody.text.metadata.whatsapp
object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.whatsapp.callPermissionExpiration
string
results.template.templateBody.text.metadata.whatsapp.callPermissionResponse
string
Possible values: accept, reject
results.template.templateBody.text.metadata.whatsapp.previewUrl
boolean
erforderlich
results.template.templateBody.text.metadata.whatsapp.sharedContacts
array of object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.whatsapp.sharedContacts.origin
string
erforderlich
results.template.templateBody.text.metadata.whatsapp.sharedContacts.phones
array of object
Untergeordnete Attribute anzeigen
results.template.templateBody.text.metadata.whatsapp.sharedContacts.phones.phone
string
erforderlich
results.template.templateBody.text.metadata.whatsapp.sharedContacts.phones.type
string
erforderlich
results.template.templateBody.text.metadata.whatsapp.sharedContacts.phones.waId
string
erforderlich
results.template.templateBody.text.metadata.whatsapp.sharedContacts.vcard
string
results.template.templateBody.text.text
string
erforderlich
results.template.templateBody.type
string
erforderlich
Possible values: text
results.template.utmParameters
array of object
Untergeordnete Attribute anzeigen
results.template.utmParameters.key
string
erforderlich
results.template.utmParameters.value
string
erforderlich
results.template.variables
object
results.template.version
string
erforderlich
The version of the template.
results.type
string
Possible values: text, html, image, file, gif, location, carousel, list, section, authentication, action
results.updatedAt
string
erforderlich
nextPageToken
string
The token that can be passed as pageToken in URL to retrieve the next set of results. If missing, no more results to display.
total
integer
totalType
string
Possible values: ``, equal, greaterThanOrEqual
Codebeispiel
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/conversations/{conversationId}/messages' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'

Examples

Codebeispiel
curl "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/conversations/16e1df9e-c6ac-406b-b1ce-13f34d0dea08/messages" \
-H "Authorization: AccessKey abcd"
Note: if the conversation has more than 10 messages, the results may be paginated. Please refer to Pagination on how to use nextPageToken.