← All release notes
View Converse docs
Converse Reporting API: queue and status filters, corrected field reference
Get conversations data can now be narrowed by queue and by conversation status, and the Reporting API reference has been corrected to match the API's actual behaviour.
New optional filters
| Property | Accepts |
|---|---|
queues |
A queue UUID, or an array of up to 50. Matches the conversation's current queue. |
conversationStatus |
A status, or an array of initialized, open, assigned, read, responded, closed. |
Send both to match conversations that satisfy both. Requests without them return the same report as before.
Clarified behaviour
fromandtofilter on the conversation's creation time, and the range must be within 30 days.- Results are returned oldest first.
- Errors are returned with HTTP 200 and
status: "Failed"; the reference now lists each error message.
Corrected field reference
- Conversation
typeisinboundoroutbound_conversation;queue,agentandcontact.keyare UUIDs. - Message records now document attachments,
conversationKey,hasAttachmentsand the contact. - Agent
managerandsupervisorare booleans.
Read more
This is the release entry. For the full feature documentation, use the docs link above.