v1

latestOpenAPI 3.0.32026-07-13201451.3 KB
Conversations

Get conversations for a chatbot

Retrieves conversation history for a specific chatbot

get/get-conversations

Query parameters

chatbotIdstring required

ID of the chatbot

filteredSourcesstring

Comma-separated list of conversation sources to filter by. Example API,WhatsApp,Messenger,Instagram,Slack,Playground,Action preview,Widget or Iframe

startDatestring date

Start date for conversation filtering (YYYY-MM-DD)

endDatestring date

End date for conversation filtering (YYYY-MM-DD)

pagestring

Page number for pagination

sizestring

Number of items per page

Response

Conversations retrieved successfully

Example response

{
  "data": [
    {
      "id": "conv_123",
      "chatbot_id": "ckl123abc456",
      "created_at": "2024-01-01T12:00:00Z",
      "updated_at": "2024-01-01T12:05:00Z",
      "source": "api",
      "messages": [
        {
          "id": "msg_123",
          "role": "user",
          "content": "Hello, I need help with my order"
        }
      ]
    }
  ]
}