Conversations
The threads between a contact and the business, across every channel.
Scope: conversations
A conversation belongs to an inbox (the channel it arrived on) and a
contact (the person on the other end). Its status moves between
open, pending, on_hold and resolved; on_hold additionally
carries a deadline and is set through its own endpoint.
List conversations
Conversations in one status bucket, filtered and paginated.
Create a conversation
Open a conversation in an inbox.
Queue counts
The numbers behind the inbox sidebar badges, in one call.
Get a conversation
Everything stored about one conversation, including its custom attributes.
Update a conversation
Change assignment, routing, priority, flag, labels, subject or status. Only the
Delete a conversation (email inboxes only)
Permanently delete a conversation, its messages, notes and stored attachments.
Put a conversation on hold
Park a conversation until a deadline. It leaves the active queues and comes back
Release a hold
Release a hold early and return the conversation to its queue.
Move the conversation to a different customer
Re-parent this conversation's contact under a different customer.
Read a conversation's custom attributes
The attribute values stored on this conversation, with their definitions resolved.
Set custom attribute values
A partial merge: attributes you do not mention keep their value. Send `null` for
List inboxes
Every inbox in the account, with the id you pass as `inbox_id`.