DocumentazioneEngagement Platform API
Sign inGet started
Guides
API

List conversations

GET
/workspaces/{workspaceId}/conversations
List all conversations across the workspace. This will return a maximum of 100 conversations 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.
Parametri di query
limit
integer
pageToken
string
reverse
boolean
resource
string
The resource to find conversation for
Payload della risposta
results
array of object
obbligatorio
List of conversations.
Mostra attributi secondari
results.accessibility
string
obbligatorio
Possible values: open, invite-only, request-to-join, private
results.activeParticipantCount
integer
obbligatorio
results.assigneeId
string
results.attributes
object
results.category
string
results.channelId
string
obbligatorio
results.createdAt
string
obbligatorio
results.description
string
results.directory
string
results.featuredParticipants
array of object
obbligatorio
Mostra attributi secondari
results.featuredParticipants.avatarUrl
string
results.featuredParticipants.contact
object
Mostra attributi secondari
results.featuredParticipants.contact.identifierKey
string
obbligatorio
results.featuredParticipants.contact.identifierValue
string
obbligatorio
results.featuredParticipants.contact.platformAddress
string
results.featuredParticipants.contact.platformAddressSelector
string
results.featuredParticipants.conversationId
string
results.featuredParticipants.createdAt
string
results.featuredParticipants.displayName
string
results.featuredParticipants.id
string
obbligatorio
results.featuredParticipants.resourceUri
string
results.featuredParticipants.status
string
Possible values: invited, pending, active, inactive
results.featuredParticipants.type
string
obbligatorio
Possible values: user, contact, agent, flow, bot, accessKey, channel, connector, collaborationAutomation
results.featuredParticipants.updatedAt
string
results.hasDraft
boolean
results.id
string
obbligatorio
results.inbox
object
Mostra attributi secondari
results.inbox.id
string
obbligatorio
results.inbox.identifier
string
obbligatorio
results.inbox.ownerId
string
obbligatorio
results.inbox.ownerType
string
obbligatorio
Possible values: user, group
results.inbox.type
string
obbligatorio
Possible values: personal, shared, support
results.initiatingParticipant
object
Mostra attributi secondari
results.initiatingParticipant.avatarUrl
string
results.initiatingParticipant.contact
object
Mostra attributi secondari
results.initiatingParticipant.contact.identifierKey
string
obbligatorio
results.initiatingParticipant.contact.identifierValue
string
obbligatorio
results.initiatingParticipant.contact.platformAddress
string
results.initiatingParticipant.contact.platformAddressSelector
string
results.initiatingParticipant.conversationId
string
results.initiatingParticipant.createdAt
string
results.initiatingParticipant.displayName
string
results.initiatingParticipant.id
string
obbligatorio
results.initiatingParticipant.resourceUri
string
results.initiatingParticipant.status
string
Possible values: invited, pending, active, inactive
results.initiatingParticipant.type
string
obbligatorio
Possible values: user, contact, agent, flow, bot, accessKey, channel, connector, collaborationAutomation
results.initiatingParticipant.updatedAt
string
results.lastMessage
object
Mostra attributi secondari
results.lastMessage.createdAt
string
obbligatorio
results.lastMessage.draft
boolean
obbligatorio
results.lastMessage.id
string
obbligatorio
results.lastMessage.preview
object
obbligatorio
Mostra attributi secondari
results.lastMessage.preview.text
string
results.lastMessage.recipients
array of object
Mostra attributi secondari
results.lastMessage.recipients.contactAnnotation
object
Annotations add extra information to a sender or receiver. For email messages, the name annotation overrides the display name.
Mostra attributi secondari
results.lastMessage.recipients.contactAnnotation.name
string
results.lastMessage.recipients.countryCode
string
results.lastMessage.recipients.id
string
The ID of the contact.
results.lastMessage.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.lastMessage.recipients.identifierValue
string
The identifier value for finding the contact.
results.lastMessage.recipients.identifiers
array of object
Additional identifiers to augment the contact during resolution.
Mostra attributi secondari
results.lastMessage.recipients.identifiers.identifierKey
string
obbligatorio
The identifier key for finding the contact (e.g. emailaddress, phonenumber).
results.lastMessage.recipients.identifiers.identifierValue
string
obbligatorio
The identifier value for finding the contact.
results.lastMessage.recipients.platformAddress
string
The resolved platform address used to deliver the message (e.g. phone number or email address).
results.lastMessage.recipients.platformAddressSelector
string
An expression that defines how we resolve the platform address from a contact. Optional override for the default resolution logic.
results.lastMessage.recipients.receiverExpression
string
results.lastMessage.recipients.receiverValue
string
results.lastMessage.recipients.type
string
The type of the receiver (e.g. to, cc, bcc for email).
results.lastMessage.sender
object
Mostra attributi secondari
results.lastMessage.sender.email
string
results.lastMessage.sender.name
string
results.lastMessage.sender.avatarUrl
string
results.lastMessage.sender.contact
object
Mostra attributi secondari
results.lastMessage.sender.contact.identifierKey
string
obbligatorio
results.lastMessage.sender.contact.identifierValue
string
obbligatorio
results.lastMessage.sender.contact.platformAddress
string
results.lastMessage.sender.contact.platformAddressSelector
string
results.lastMessage.sender.conversationId
string
results.lastMessage.sender.createdAt
string
results.lastMessage.sender.displayName
string
results.lastMessage.sender.id
string
obbligatorio
results.lastMessage.sender.resourceUri
string
results.lastMessage.sender.status
string
Possible values: invited, pending, active, inactive
results.lastMessage.sender.type
string
obbligatorio
Possible values: user, contact, agent, flow, bot, accessKey, channel, connector, collaborationAutomation
results.lastMessage.sender.updatedAt
string
results.lastMessage.status
string
obbligatorio
Possible values: accepted, processing, sent, sending_failed, delivered, delivery_failed, deleted
results.lastMessage.type
string
obbligatorio
Possible values: text, html, image, file, gif, location, carousel, list, section, authentication, action, comment
results.lastMessageIncomingAt
string
results.lastMessageOutgoingAt
string
results.name
string
obbligatorio
results.participants
array of object
Mostra attributi secondari
results.participants.contact
object
Mostra attributi secondari
results.participants.contact.identifierKey
string
obbligatorio
results.participants.contact.identifierValue
string
obbligatorio
results.participants.contact.platformAddress
string
results.participants.contact.platformAddressSelector
string
results.participants.id
string
obbligatorio
results.participants.type
string
obbligatorio
Possible values: user, contact, agent, flow, bot, accessKey, channel, connector, collaborationAutomation
results.pendingParticipantCount
integer
results.platformStyle
string
obbligatorio
Possible values: direct, email, direct-multiple, direct-threaded, group-multiple
results.privateAttributes
string
results.read
boolean
results.referral
object
Mostra attributi secondari
results.referral.caption
string
results.referral.mediaType
string
results.referral.mediaUrl
string
results.referral.sourceId
string
obbligatorio
results.referral.sourceType
string
results.referral.sourceUrl
string
results.referral.text
string
results.referral.timestamp
string
results.referral.title
string
results.referral.username
string
results.resource
object
Mostra attributi secondari
results.resource.id
string
obbligatorio
results.resource.type
string
obbligatorio
Possible values: task, task-conversation, reimbursement, sales-lead, sales-opportunity, sales-account, expense, project
results.resourceUri
string
results.starred
boolean
results.status
string
obbligatorio
Possible values: deleted, active, closed, spam, archived
results.style
string
obbligatorio
Possible values: default, directMessage, chatChannel, personalInbox, resource, groupInbox, support
results.summary
string
results.tags
array of string
results.updatedAt
string
obbligatorio
results.visibility
string
obbligatorio
Possible values: public, private, direct, group
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
Esempio di codice
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/conversations' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'

Examples

Esempio di codice
curl "https://api.bird.com/workspaces/e58899bf-1e8d-4ff7-b9db-a60befaf90d2/conversations" \
-H "Authorization: AccessKey abcd"
Note: if there are more than 10 conversations, the results may be paginated. Please refer to Pagination on how to use nextPageToken.