// lib/automation.ts /** * قوانین اتوماسیون پیگیری، محاسبه دما، و مراحل آنبوردینگ CRM اکیپا */ export interface FollowupRule { currentStage: string; nextStage: string; delayDays: number; channel: 'تماس' | 'پیامک'; action: string; smsTag: string; } export const FOLLOWUP_RULES: FollowupRule[] = [ { currentStage: 'ارتباط اولیه', nextStage: 'ارسال پرپوزال', delayDays: 0, channel: 'پیامک', action: 'ارسال پرپوزال اکیپا', smsTag: 'خوش آمدگویی', }, { currentStage: 'ارسال پرپوزال', nextStage: 'پیگیری سرد ۱', delayDays: 1, channel: 'پیامک', action: 'پیامک راه‌حل اکیپا برای نقطه درد + دعوت به اقدام', smsTag: 'خوش آمدگویی', }, { currentStage: 'مشاهده پرپوزال', nextStage: 'پیگیری گرم ۱', delayDays: 2, channel: 'تماس', action: 'رفع ابهام + پیشنهاد دو هفته‌ی رایگان اکیپا', smsTag: 'اطلاع از آپدیت‌ها', }, { currentStage: 'پیگیری سرد ۱', nextStage: 'پیگیری گرم ۱', delayDays: 2, channel: 'تماس', action: 'پیگیری سوالات، مشاهده‌ی اطلاعات ارسالی، پیشنهاد دو هفته‌ی رایگان', smsTag: 'اطلاع از آپدیت‌ها', }, { currentStage: 'پیگیری گرم ۱', nextStage: 'پیگیری سرد ۲', delayDays: 3, channel: 'پیامک', action: 'ارسال آمار موفقیت اکیپا و آمار لاین مجموعه با لینک', smsTag: 'آمار موفقیت‌های اکیپا', }, { currentStage: 'پیگیری سرد ۲', nextStage: 'پیگیری گرم ۲', delayDays: 3, channel: 'تماس', action: 'جویا شدن علت عدم همکاری و رفع موانع اتصال', smsTag: 'آمار موفقیت‌های اکیپا', }, { currentStage: 'پیگیری گرم ۲', nextStage: 'لوپ پیامکی', delayDays: 10, channel: 'پیامک', action: 'ورود به لوپ پیامکی خودکار اکیپا', smsTag: 'آمار موفقیت‌های اکیپا', }, { currentStage: 'لوپ پیامکی', nextStage: 'لوپ پیامکی', delayDays: 10, channel: 'پیامک', action: 'پیامک لوپ دوره‌ای (ارسال آمار و نکات افزایش رزرو)', smsTag: 'طبق جدول لوپ', }, ]; export const STAGES_ORDER = [ 'ارتباط اولیه', 'ارسال پرپوزال', 'مشاهده پرپوزال', 'پیگیری سرد ۱', 'پیگیری گرم ۱', 'پیگیری سرد ۲', 'پیگیری گرم ۲', 'لوپ پیامکی', 'بسته شد / موفق', 'بایگانی / ناموفق', ]; export const PIPELINE_STAGES = STAGES_ORDER.map((stage) => ({ stage, name: stage, })); export const OBJECTIONS_BANK = [ { objection: 'درصدی کار نمی‌کنیم / کمیسیون بالاست', rebuttal: 'اکیپا کمیسیون را از افزایش فروش سانس‌های خالی پوشش می‌دهد؛ دو هفته اول بدون هیچ ریسک و هزینه‌ای تست کنید.', action: 'ارسال ماشین‌حساب سودآوری اکیپا', }, { objection: 'خودمون سایت داریم و فروش کافیه', rebuttal: 'سایت شما مخاطب ثابت شماست؛ اکیپا مسافران و کاربران جدید کشف‌نشده را به سانس‌های خالی وسط هفته شما می‌آورد.', action: 'ارسال نمونه کیس‌استادی افزایش ۳۰٪ رزروهای خالی', }, { objection: 'نیاز به هماهنگی با شریک دارم', rebuttal: 'کاملاً درسته؛ پرپوزال خلاصه تک‌صفحه‌ای اختصاصی برای ارائه به شریک برایتان ارسال شد، کی برای جلسه مشترک مناسب است؟', action: 'تنظیم جلسه آنلاین ۵ دقیقه‌ای با شرکا', }, { objection: 'وقت پر کردن سانس و کار با پنل رو نداریم', rebuttal: 'مدیریت و همگام‌سازی سانس‌ها از طریق وب‌هوک و پشتیبانی اکیپا کاملاً اتوماتیک انجام می‌شود، صفر بار کاری برای پرسنل شما.', action: 'توضیح سیستم سینک خودکار سانس‌ها', }, ]; export const OBJECTION_PLAYBOOK = OBJECTIONS_BANK; export function advanceStage(params: { stage: string; loopIndex?: number; objectionStatus?: string | null; tempOverridden?: boolean; temperatureOverridden?: boolean; } | string) { const currentStage = typeof params === 'string' ? params : params.stage; const loopIndex = typeof params === 'string' ? 0 : (params.loopIndex || 0); const objectionStatus = typeof params === 'string' ? null : params.objectionStatus; let nextStage = currentStage; let nextLoopIndex = loopIndex; const currentIndex = STAGES_ORDER.indexOf(currentStage); if (currentIndex === -1 || currentIndex >= STAGES_ORDER.length - 2) { nextStage = 'بسته شد / موفق'; } else { nextStage = STAGES_ORDER[currentIndex + 1]; if (nextStage === 'لوپ پیامکی') { nextLoopIndex = loopIndex + 1; } } const followup = calculateNextFollowup(nextStage); const temperature = calculateTemperature({ stage: nextStage, objectionStatus, }); return { nextStage, followup, temperature, nextLoopIndex, isWon: nextStage === 'بسته شد / موفق', }; } export interface NextFollowupResult { nextStage: string; nextFollowupAt: Date | null; nextAction: string | null; nextChannel: 'تماس' | 'پیامک' | null; smsTag: string | null; } /** * محاسبه گام و تاریخ پیگیری بعدی بر اساس مرحله فعلی */ export function calculateNextFollowup(stage: string, baseDate: Date = new Date()): NextFollowupResult { if (stage === 'بایگانی / ناموفق') { return { nextStage: 'بایگانی / ناموفق', nextFollowupAt: null, nextAction: 'مجموعه بایگانی شده است', nextChannel: null, smsTag: null, }; } if (stage === 'بسته شد / موفق') { const nextDate = new Date(baseDate.getTime() + 1 * 24 * 60 * 60 * 1000); return { nextStage: 'بسته شد / موفق', nextFollowupAt: nextDate, nextAction: 'شروع آنبوردینگ هفته ۱ (ارسال قرارداد و دریافت اطلاعات اولیه)', nextChannel: 'تماس', smsTag: 'شروع آنبوردینگ', }; } const rule = FOLLOWUP_RULES.find((r) => r.currentStage === stage); if (!rule) { return { nextStage: stage, nextFollowupAt: new Date(baseDate.getTime() + 3 * 24 * 60 * 60 * 1000), nextAction: 'پیگیری وضعیت', nextChannel: 'تماس', smsTag: 'پیگیری عمومی', }; } const nextDate = new Date(baseDate.getTime() + rule.delayDays * 24 * 60 * 60 * 1000); return { nextStage: rule.nextStage, nextFollowupAt: nextDate, nextAction: rule.action, nextChannel: rule.channel, smsTag: rule.smsTag, }; } export interface TemperatureResult { score: number; label: 'گرم' | 'خنثی' | 'سرد'; } /** * محاسبه نمره و سطح دمای لید بر اساس فرمول جامع اکیپا */ export function calculateTemperature(params: { stage: string; lastContactAt?: Date | null; objectionStatus?: string | null; sentiment?: 'positive' | 'neutral' | 'negative' | null; manualOverrideScore?: number | null; }): TemperatureResult { if (params.manualOverrideScore !== undefined && params.manualOverrideScore !== null) { const s = Math.max(0, Math.min(100, params.manualOverrideScore)); return { score: s, label: s >= 62 ? 'گرم' : s >= 40 ? 'خنثی' : 'سرد', }; } let score = 50; // مرحله if (params.stage === 'بسته شد / موفق') { return { score: 100, label: 'گرم' }; } if (params.stage === 'مشاهده پرپوزال') { score += 15; } if (params.stage === 'پیگیری گرم ۱') { score += 10; } if (params.stage === 'پیگیری سرد ۲') { score -= 10; } if (params.stage === 'پیگیری گرم ۲') { score -= 15; } if (params.stage === 'لوپ پیامکی') { score -= 20; } if (params.stage === 'بایگانی / ناموفق') { score = 15; } // وضعیت اعتراض if (params.objectionStatus === 'حل شده') { score += 20; } else if (params.objectionStatus === 'نیاز به پیگیری مجدد') { score -= 12; } // احساسات کارشناس / تحلیل AI if (params.sentiment === 'positive') { score += 20; } else if (params.sentiment === 'negative') { score -= 15; } // فاصله زمانی از آخرین تماس if (params.lastContactAt) { const daysSince = Math.floor((Date.now() - new Date(params.lastContactAt).getTime()) / (1000 * 60 * 60 * 24)); if (daysSince > 10) { score -= 15; } else if (daysSince > 5) { score -= 5; } } score = Math.max(0, Math.min(100, score)); const label: 'گرم' | 'خنثی' | 'سرد' = score >= 62 ? 'گرم' : score >= 40 ? 'خنثی' : 'سرد'; return { score, label }; } /** * بررسی عقب‌افتادگی تسک */ export function isOverdue(date: Date | string | null | undefined): { overdue: boolean; days: number } { if (!date) return { overdue: false, days: 0 }; const target = new Date(date); const now = new Date(); // مقایسه بر اساس روز target.setHours(0, 0, 0, 0); now.setHours(0, 0, 0, 0); const diffMs = now.getTime() - target.getTime(); const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24)); return { overdue: diffDays > 0, days: diffDays > 0 ? diffDays : 0, }; } /** * وظایف پیش‌فرض ۴ هفته آنبوردینگ */ export const DEFAULT_ONBOARDING_TASKS = [ { week: 1, title: 'ارسال قرارداد رسمی و دریافت امضا' }, { week: 1, title: 'دریافت مشخصات اتاق‌ها، سانس‌ها و تصاویر باکیفیت' }, { week: 1, title: 'ایجاد پروفایل مجموعه در پنل اکیپا' }, { week: 2, title: 'اتصال تقویم و وب‌هوک رزرو آنلاین' }, { week: 2, title: 'تست رزرو آزمایشی و تایید پیامک رزرو' }, { week: 2, title: 'آموزش پرسنل و لیدر برای استفاده از پنل' }, { week: 3, title: 'بررسی اولین رزروهای ورودی از اکیپا' }, { week: 3, title: 'تنظیم تخفیف یا آفر سانس‌های خالی وسط هفته' }, { week: 3, title: 'رفع مشکلات و فیدبک هفته اول فعالیت' }, { week: 4, title: 'ارزیابی نرخ رزرو و رضایت پلیرها' }, { week: 4, title: 'تسویه حساب ماهانه اول و گزارش درآمدی' }, { week: 4, title: 'تکمیل دوره و عضویت رسمی در باشگاه مجموعه‌های اکیپا' }, ];