List conversations
Threads from Messaging > Conversations, filterable by state, topic and sentiment.
GET https://cotlet.dev/api/v1/postscript/conversations
read
Returns subscriber threads with the last message, the topic Postscript assigned (for example Shipping or Payment) and the sentiment. Filters match the dashboard's Thread State, Last Response Topic and Last Response Sentiment and can be combined. Two-way messaging works for US and Canadian subscribers.
Parameters
| Name | Type | Description |
|---|---|---|
| thread_state enum | enum | all, unresolved or resolved. Default: all. |
| topic string | string | Last Response Topic, for example Shipping or Payment. |
| sentiment enum | enum | negative or positive. |
Request
curl https://cotlet.dev/api/v1/postscript/conversations \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("postscript", "list_conversations")const result = await cotlet.call('postscript', 'list_conversations');cotlet call postscript list_conversationsExample response
{
"conversations": [
{
"conversation_id": "c_90412",
"subscriber_id": "7740215",
"subscriber_name": "Dana R.",
"last_message": "Where is my order?",
"topic": "Shipping",
"sentiment": null,
"thread_state": "unresolved"
},
{
"conversation_id": "c_90377",
"subscriber_id": "7712968",
"subscriber_name": "Chris M.",
"last_message": "I want a refund",
"topic": "Payment",
"sentiment": "negative",
"thread_state": "unresolved"
}
]
}