پرش به مطلب اصلی

لیست گفت‌وگوها

لیست گفت‌وگوها​

این سرویس برای دریافت لیست تمام گفت‌وگوهای یک کاربر استفاده می‌شود. پارامتر user الزامی است و باید شناسه کاربری (username یا uuid) را مشخص کند. می‌توانید گفت‌وگوها را بر اساس شناسه یک دستیار (Agent) فیلتر کرده و با پارامترهای limit و offset صفحه‌بندی انجام دهید.

مسیر سرویس​

GET /api/v1/b2b/conversations-list/

پارامترهای مسیر (Query Parameters)​

نامنوعمکاناجباریتوضیح
userرشتهqueryبلهشناسه یا نام کاربری کاربر
agentرشتهqueryخیرفیلتر کردن گفت‌وگوها بر اساس شناسه دستیار
limitعدد صحیحqueryخیرتعداد نتایج در هر صفحه
offsetعدد صحیحqueryخیرایندکس شروع برای نتایج

هدرها (Headers)​

هدرمقدارتوضیح
AuthorizationToken api-tokenتوکن احراز هویت

نمونه فراخوانی​

curl --location 'https://app.houshyar24.ir/api/v1/b2b/conversations-list?user=ali&limit=10&agent=1' \
--header 'Authorization: Token <your-token>'

پاسخ موفق (200)​

{
"count": 3,
"next": "https://app.houshyar24.ir/api/v1/b2b/conversations-list/?user=ali&agent=1&limit=1&offset=1",
"previous": null,
"results": [
{
"conversation_id": "ab798ead-6054-4a69-89d4-5f1956f27d52",
"agent_id": 1,
"is_deleted": false,
"name": "سوال در مورد رنگ ها",
"inputs": {},
"created_at": "2026-06-05T19:56:10.502284+03:30"
}
]
}