DocumentationEngagement 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.
Paramètres de chemin
conversationId
string
The conversation ID
Paramètres de requête
limit
integer
pageToken
string
reverse
boolean
dateFrom
string
Filter by created date after this date.
Corps de la réponse
results
array of object
List of messages in the conversation.
Afficher les attributs enfants
results.body
object
Afficher les attributs enfants
results.body.text
object
obligatoire
Afficher les attributs enfants
results.body.text.actions
array of object
Afficher les attributs enfants
results.body.text.actions.link
object
obligatoire
Afficher les attributs enfants
results.body.text.actions.link.metadata
object
Afficher les attributs enfants
results.body.text.actions.link.metadata.description
object
Afficher les attributs enfants
results.body.text.actions.link.metadata.description.label
string
obligatoire
results.body.text.actions.link.text
string
obligatoire
results.body.text.actions.link.url
string
obligatoire
results.body.text.actions.type
string
obligatoire
Possible values: link
results.body.text.attachments
array of object
Afficher les attributs enfants
results.body.text.attachments.content
string
results.body.text.attachments.contentId
string
results.body.text.attachments.contentType
string
results.body.text.attachments.filename
string
obligatoire
results.body.text.attachments.inline
boolean
results.body.text.attachments.mediaUrl
string
obligatoire
results.body.text.metadata
object
Afficher les attributs enfants
results.body.text.metadata.apple
object
Afficher les attributs enfants
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
Afficher les attributs enfants
results.body.text.metadata.line.emoji
object
Afficher les attributs enfants
results.body.text.metadata.line.emoji.items
array of object
Afficher les attributs enfants
results.body.text.metadata.line.emoji.items.emojiId
string
obligatoire
results.body.text.metadata.line.emoji.items.index
integer
obligatoire
results.body.text.metadata.line.emoji.items.length
integer
results.body.text.metadata.line.emoji.items.productId
string
obligatoire
results.body.text.metadata.paymentDetails
object
Afficher les attributs enfants
results.body.text.metadata.paymentDetails.amount
string
obligatoire
results.body.text.metadata.paymentDetails.currency
string
obligatoire
results.body.text.metadata.paymentDetails.sessionIdentifier
string
results.body.text.metadata.paymentDetails.state
string
obligatoire
results.body.text.metadata.subject
string
results.body.text.metadata.telegram
object
Afficher les attributs enfants
results.body.text.metadata.telegram.parseMode
string
results.body.text.metadata.whatsapp
object
Afficher les attributs enfants
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
obligatoire
results.body.text.metadata.whatsapp.sharedContacts
array of object
Afficher les attributs enfants
results.body.text.metadata.whatsapp.sharedContacts.origin
string
obligatoire
results.body.text.metadata.whatsapp.sharedContacts.phones
array of object
Afficher les attributs enfants
results.body.text.metadata.whatsapp.sharedContacts.phones.phone
string
obligatoire
results.body.text.metadata.whatsapp.sharedContacts.phones.type
string
obligatoire
results.body.text.metadata.whatsapp.sharedContacts.phones.waId
string
obligatoire
results.body.text.metadata.whatsapp.sharedContacts.vcard
string
results.body.text.text
string
obligatoire
results.body.type
string
obligatoire
Possible values: text
results.channelId
string
results.conversationCreatedAt
string
results.conversationId
string
obligatoire
results.createdAt
string
obligatoire
results.draft
boolean
obligatoire
Whether this message is a draft.
results.draftMeta
object
Metadata for draft messages.
Afficher les attributs enfants
results.draftMeta.creatorType
string
obligatoire
Possible values: user, bot
results.id
string
obligatoire
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).
Afficher les attributs enfants
results.interactions.bodyTemplateProjectId
string
results.interactions.channelId
string
obligatoire
results.interactions.context
object
obligatoire
Afficher les attributs enfants
results.interactions.context.id
string
results.interactions.context.tagIds
array of string
results.interactions.context.type
string
results.interactions.createdAt
string
obligatoire
results.interactions.details
string
results.interactions.id
string
obligatoire
results.interactions.isFirstInteraction
boolean
results.interactions.isFirstInteractionIncludingBots
boolean
results.interactions.journey
object
Afficher les attributs enfants
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
obligatoire
results.interactions.messagePartsCount
integer
obligatoire
results.interactions.messageReference
string
obligatoire
results.interactions.messageTags
array of string
results.interactions.metadata
object
Afficher les attributs enfants
results.interactions.metadata.button
object
Afficher les attributs enfants
results.interactions.metadata.button.payload
string
obligatoire
results.interactions.metadata.conversion
object
Afficher les attributs enfants
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
Afficher les attributs enfants
results.interactions.metadata.link.clickType
string
Possible values: link, button
results.interactions.metadata.link.name
string
obligatoire
results.interactions.metadata.link.url
string
obligatoire
results.interactions.metadata.prefetched
boolean
results.interactions.metadata.reaction
object
Afficher les attributs enfants
results.interactions.metadata.reaction.action
string
obligatoire
Possible values: react, unreact
results.interactions.metadata.reaction.emoji
string
obligatoire
results.interactions.metadata.renderedContentBlocks
array of string
results.interactions.metadata.subscriptionList
object
Afficher les attributs enfants
results.interactions.metadata.subscriptionList.subscriptionListId
string
obligatoire
results.interactions.notification
object
Afficher les attributs enfants
results.interactions.notification.template
string
results.interactions.notification.url
string
obligatoire
results.interactions.platformId
string
obligatoire
results.interactions.platformReferenceId
string
results.interactions.receiver
object
obligatoire
Afficher les attributs enfants
results.interactions.receiver.connector
object
Afficher les attributs enfants
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.
Afficher les attributs enfants
results.interactions.receiver.connector.annotations.name
string
results.interactions.receiver.connector.id
string
obligatoire
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
Afficher les attributs enfants
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.
Afficher les attributs enfants
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.
Afficher les attributs enfants
results.interactions.receiver.contacts.identifiers.identifierKey
string
obligatoire
The identifier key for finding the contact (e.g. emailaddress, phonenumber).
results.interactions.receiver.contacts.identifiers.identifierValue
string
obligatoire
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
Afficher les attributs enfants
results.interactions.receiver.device.gateway
string
obligatoire
Possible values: firebase, apns, web
results.interactions.receiver.device.id
string
obligatoire
results.interactions.receiver.device.identifierValue
string
obligatoire
results.interactions.receiver.inbox
object
Afficher les attributs enfants
results.interactions.receiver.inbox.emailRecipientType
string
results.interactions.receiver.inbox.id
string
obligatoire
results.interactions.receiver.inbox.identifierKey
string
obligatoire
results.interactions.receiver.inbox.identifierValue
string
obligatoire
results.interactions.receiver.inbox.type
string
obligatoire
Possible values: user, group
results.interactions.receiver.userContacts
array of object
Afficher les attributs enfants
results.interactions.receiver.userContacts.id
string
obligatoire
results.interactions.receiver.userContacts.identifierKey
string
obligatoire
results.interactions.receiver.userContacts.identifierValue
string
obligatoire
results.interactions.receiver.userContacts.type
string
results.interactions.type
string
obligatoire
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
Afficher les attributs enfants
results.meta.campaign
object
Afficher les attributs enfants
results.meta.campaign.id
string
results.meta.campaign.name
string
results.meta.campaignId
string
results.meta.chargeOnceDelivered
boolean
results.meta.email
object
Afficher les attributs enfants
results.meta.email.from
object
Afficher les attributs enfants
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
Afficher les attributs enfants
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
Afficher les attributs enfants
results.meta.formResponse.id
string
obligatoire
results.meta.formResponse.jsonResponse
string
obligatoire
results.meta.formResponse.requestIdentifier
string
obligatoire
results.meta.formResponse.selections
array of object
Afficher les attributs enfants
results.meta.formResponse.selections.items
array of object
Afficher les attributs enfants
results.meta.formResponse.selections.items.identifier
string
obligatoire
results.meta.formResponse.selections.items.title
string
obligatoire
results.meta.formResponse.selections.items.type
string
obligatoire
results.meta.formResponse.selections.items.value
string
obligatoire
results.meta.formResponse.selections.pageIdentifier
string
obligatoire
results.meta.formResponse.selections.subtitle
string
obligatoire
results.meta.formResponse.selections.title
string
obligatoire
results.meta.formResponse.sessionIdentifier
string
obligatoire
results.meta.formResponse.template
string
obligatoire
results.meta.formResponse.version
string
obligatoire
results.meta.ignoreGlobalHoldout
boolean
results.meta.ignoreQuietHours
boolean
results.meta.journey
object
Afficher les attributs enfants
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.
Afficher les attributs enfants
results.meta.order.products
array of object
Afficher les attributs enfants
results.meta.order.products.externalCatalogId
string
The platform-specific catalog ID of the product.
results.meta.order.products.externalProductId
string
obligatoire
The platform-specific product ID.
results.meta.order.products.price
object
obligatoire
Afficher les attributs enfants
results.meta.order.products.price.amount
integer
obligatoire
results.meta.order.products.price.currencyCode
string
obligatoire
results.meta.order.products.price.exponent
integer
obligatoire
results.meta.order.products.quantity
integer
obligatoire
The number of items purchased.
results.meta.pushNotifications
object
Afficher les attributs enfants
results.meta.pushNotifications.gatewayTypeOverride
string
Possible values: firebase, apns, web
results.meta.referral
object
Afficher les attributs enfants
results.meta.referral.group
string
results.meta.referral.metadata
object
Afficher les attributs enfants
results.meta.referral.metadata.caption
string
results.meta.referral.metadata.mediaType
string
results.meta.referral.metadata.mediaUrl
string
results.meta.referral.metadata.sourceId
string
obligatoire
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
obligatoire
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).
Afficher les attributs enfants
results.meta.referredProduct.externalCatalogId
string
The platform-specific catalog ID of the product.
results.meta.referredProduct.externalProductId
string
obligatoire
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
Afficher les attributs enfants
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
Afficher les attributs enfants
results.meta.sms.smpp.segments
array of object
Afficher les attributs enfants
results.meta.sms.smpp.segments.id
string
obligatoire
results.meta.sms.smpp.segments.registeredDelivery
string
obligatoire
Possible values: final, intermediate, all, noDlr
results.meta.sms.smpp.userId
string
obligatoire
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
Afficher les attributs enfants
results.receiver.connector
object
Afficher les attributs enfants
results.receiver.connector.annotations
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Afficher les attributs enfants
results.receiver.connector.annotations.name
string
results.receiver.connector.id
string
obligatoire
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
Afficher les attributs enfants
results.receiver.contacts.contactAnnotation
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Afficher les attributs enfants
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.
Afficher les attributs enfants
results.receiver.contacts.identifiers.identifierKey
string
obligatoire
The identifier key for finding the contact (e.g. emailaddress, phonenumber).
results.receiver.contacts.identifiers.identifierValue
string
obligatoire
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
Afficher les attributs enfants
results.receiver.device.gateway
string
obligatoire
Possible values: firebase, apns, web
results.receiver.device.id
string
obligatoire
results.receiver.device.identifierValue
string
obligatoire
results.receiver.inbox
object
Afficher les attributs enfants
results.receiver.inbox.emailRecipientType
string
results.receiver.inbox.id
string
obligatoire
results.receiver.inbox.identifierKey
string
obligatoire
results.receiver.inbox.identifierValue
string
obligatoire
results.receiver.inbox.type
string
obligatoire
Possible values: user, group
results.receiver.userContacts
array of object
Afficher les attributs enfants
results.receiver.userContacts.id
string
obligatoire
results.receiver.userContacts.identifierKey
string
obligatoire
results.receiver.userContacts.identifierValue
string
obligatoire
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
Afficher les attributs enfants
results.recipients.contactAnnotation
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Afficher les attributs enfants
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.
Afficher les attributs enfants
results.recipients.identifiers.identifierKey
string
obligatoire
The identifier key for finding the contact (e.g. emailaddress, phonenumber).
results.recipients.identifiers.identifierValue
string
obligatoire
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
obligatoire
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
Afficher les attributs enfants
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
obligatoire
Afficher les attributs enfants
results.sender.email
string
results.sender.name
string
results.sender.avatarUrl
string
results.sender.contact
object
Afficher les attributs enfants
results.sender.contact.identifierKey
string
obligatoire
results.sender.contact.identifierValue
string
obligatoire
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
obligatoire
results.sender.resourceUri
string
results.sender.status
string
Possible values: invited, pending, active, inactive
results.sender.type
string
obligatoire
Possible values: user, contact, agent, flow, bot, accessKey, channel, connector, collaborationAutomation
results.sender.updatedAt
string
results.source
string
obligatoire
Possible values: conversations, channels, bots, external
results.status
string
obligatoire
Possible values: accepted, processing, sent, sending_failed, delivered, delivery_failed, deleted
results.template
object
Afficher les attributs enfants
results.template.attachments
array of object
Afficher les attributs enfants
results.template.attachments.content
string
results.template.attachments.contentType
string
results.template.attachments.filename
string
obligatoire
results.template.attachments.inline
boolean
obligatoire
results.template.attachments.mediaUrl
string
obligatoire
results.template.deployment
object
results.template.locale
string
obligatoire
results.template.name
string
The platform name of the template.
results.template.parameters
array of object
Afficher les attributs enfants
results.template.parameters.key
string
obligatoire
results.template.parameters.sourceUrl
object
Afficher les attributs enfants
results.template.parameters.sourceUrl.fullyReplaced
boolean
obligatoire
results.template.parameters.sourceUrl.value
string
obligatoire
results.template.parameters.type
string
obligatoire
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
obligatoire
results.template.projectId
string
obligatoire
The ID of the project from Studio.
results.template.settings
object
Afficher les attributs enfants
results.template.settings.disallowMmLite
boolean
results.template.shortLinks
object
Afficher les attributs enfants
results.template.shortLinks.domain
string
obligatoire
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
obligatoire
Enables link shortening for SMS messages.
results.template.templateBody
object
Afficher les attributs enfants
results.template.templateBody.text
object
obligatoire
Afficher les attributs enfants
results.template.templateBody.text.actions
array of object
Afficher les attributs enfants
results.template.templateBody.text.actions.link
object
obligatoire
Afficher les attributs enfants
results.template.templateBody.text.actions.link.metadata
object
Afficher les attributs enfants
results.template.templateBody.text.actions.link.metadata.description
object
Afficher les attributs enfants
results.template.templateBody.text.actions.link.metadata.description.label
string
obligatoire
results.template.templateBody.text.actions.link.text
string
obligatoire
results.template.templateBody.text.actions.link.url
string
obligatoire
results.template.templateBody.text.actions.type
string
obligatoire
Possible values: link
results.template.templateBody.text.attachments
array of object
Afficher les attributs enfants
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
obligatoire
results.template.templateBody.text.attachments.inline
boolean
results.template.templateBody.text.attachments.mediaUrl
string
obligatoire
results.template.templateBody.text.metadata
object
Afficher les attributs enfants
results.template.templateBody.text.metadata.apple
object
Afficher les attributs enfants
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
Afficher les attributs enfants
results.template.templateBody.text.metadata.line.emoji
object
Afficher les attributs enfants
results.template.templateBody.text.metadata.line.emoji.items
array of object
Afficher les attributs enfants
results.template.templateBody.text.metadata.line.emoji.items.emojiId
string
obligatoire
results.template.templateBody.text.metadata.line.emoji.items.index
integer
obligatoire
results.template.templateBody.text.metadata.line.emoji.items.length
integer
results.template.templateBody.text.metadata.line.emoji.items.productId
string
obligatoire
results.template.templateBody.text.metadata.paymentDetails
object
Afficher les attributs enfants
results.template.templateBody.text.metadata.paymentDetails.amount
string
obligatoire
results.template.templateBody.text.metadata.paymentDetails.currency
string
obligatoire
results.template.templateBody.text.metadata.paymentDetails.sessionIdentifier
string
results.template.templateBody.text.metadata.paymentDetails.state
string
obligatoire
results.template.templateBody.text.metadata.subject
string
results.template.templateBody.text.metadata.telegram
object
Afficher les attributs enfants
results.template.templateBody.text.metadata.telegram.parseMode
string
results.template.templateBody.text.metadata.whatsapp
object
Afficher les attributs enfants
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
obligatoire
results.template.templateBody.text.metadata.whatsapp.sharedContacts
array of object
Afficher les attributs enfants
results.template.templateBody.text.metadata.whatsapp.sharedContacts.origin
string
obligatoire
results.template.templateBody.text.metadata.whatsapp.sharedContacts.phones
array of object
Afficher les attributs enfants
results.template.templateBody.text.metadata.whatsapp.sharedContacts.phones.phone
string
obligatoire
results.template.templateBody.text.metadata.whatsapp.sharedContacts.phones.type
string
obligatoire
results.template.templateBody.text.metadata.whatsapp.sharedContacts.phones.waId
string
obligatoire
results.template.templateBody.text.metadata.whatsapp.sharedContacts.vcard
string
results.template.templateBody.text.text
string
obligatoire
results.template.templateBody.type
string
obligatoire
Possible values: text
results.template.utmParameters
array of object
Afficher les attributs enfants
results.template.utmParameters.key
string
obligatoire
results.template.utmParameters.value
string
obligatoire
results.template.variables
object
results.template.version
string
obligatoire
The version of the template.
results.type
string
Possible values: text, html, image, file, gif, location, carousel, list, section, authentication, action
results.updatedAt
string
obligatoire
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
Exemple de code
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/conversations/{conversationId}/messages' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'

Examples

Exemple de code
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.