خروجی گفتگوها

خروجی‌گیری گروهی مکالمات فضای کاری خود را به‌صورت CSV یا JSON برای نگهداری، تحلیل یا تحویل انطباقی انجام دهید. فقط نقش‌های مدیر و مالک.

نحوه عملکرد

1. مدیر یک درخواست POST به /app/conversation-exports با فرمت (csv یا json) و فیلترهای اختیاری (agent_id، from، to) ارسال می‌کند.
2. یک ردیف ConversationExport با status=pending درج شده و BuildConversationExportJob در صف قرار می‌گیرد.
3. این وظیفه در پس‌زمینه اجرا شده و مکالمات را در دسته‌های ۲۰۰ تایی به یک فایل در دیسک خصوصی در storage/app/private/exports/conversations/{uuid}.{format} پخش می‌کند.
4. پس از اتمام، status=ready، حجم فایل + تعداد ردیف‌ها ثبت شده و expires_at به ۷ روز بعد تنظیم می‌شود.
5. مدیر درخواست‌دهنده از /app/conversation-exports/{id}/download دانلود می‌کند. نقطه پایانی فایل را با MIME صحیح پخش می‌کند و در صورت عدم آمادگی، انقضا یا تعلق به فضای کاری دیگر، درخواست را رد می‌کند.

محتوای خروجی

هر ردیف شامل فراداده چرخه حیات مکالمه، پروفایل مشتری بازدیدکننده (ایمیل / تلفن / نام / وضعیت) و تمام پیام‌های موجود در مکالمه است. فرمت CSV رونوشت را به first_user_message + last_assistant_message برای استفاده در صفحات گسترده ساده می‌کند؛ JSON آرایه کامل پیام‌ها را در هر مکالمه حفظ می‌کند.

نگهداری

خروجی‌ها ۷ روز پس از ایجاد منقضی می‌شوند. دستور Artisan conversations:prune-exports هر شب ساعت ۰۲:۱۵ UTC اجرا شده و هم ردیف پایگاه داده و هم فایل را حذف می‌کند. در صورت نیاز مجدد پس از انقضا، دوباره خروجی را درخواست کنید.

ایزوله‌سازی فضای کاری

وظیفه ساخت فقط مکالماتی را می‌خواند که agent_id آنها به فضای کاری درخواست‌دهنده تعلق دارد. درخواست‌های دانلود قبل از پخش، workspace_id را مطابقت می‌دهند. یک شناسه خروجی نشت‌یافته بدون نشست احراز هویت‌شده در فضای کاری مناسب بی‌ضرر است.

محدودیت‌ها

این وظیفه دارای زمان‌بندی ۶۰۰ ثانیه‌ای سخت است. فضاهای کاری با حجم مکالمه بسیار بالا باید با فیلترهای تاریخ / دستیار فروش محدود شوند؛ در صورت درخواست خریداران، زمان‌بندی را افزایش خواهیم داد. فایل خروجی در دیسک خصوصی محلی برنامه نگهداری می‌شود؛ فایل‌های بسیار بزرگ ممکن است هشدارهای آستانه مصرف دیسک را در هاست‌های اشتراکی فعال کنند.