Conversations
List conversations and fetch message history via the API.
List conversations
Query parameters
| Param | Description |
|---|---|
status | Filter by status (open, done) |
unread | Set to true to show only unread conversations |
limit | Max results (default 20) |
Example
Response
Get messages in a conversation
Returns the message history for a conversation: the latest limit messages (default 50, max 200), in the order they were sent. Use offset to page back through older messages.
Query parameters
| Parameter | Description |
|---|---|
limit | How many messages, default 50, max 200. |
offset | Skip this many of the newest messages, to page back. |
source | Only campaign, drip or api messages. |
Example
Response
Files customers send
Customer files (identity documents included) are stored privately. media_url for a file the customer sent is a private link that works for 7 days from the time of your request; call the API again for a fresh link, or download the file if you need to keep it. Older messages may still show a permanent link until they are moved to private storage.