ehsan-dashboards/dashboards/crm/lib/automation.ts

333 lines
11 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// 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: 'تکمیل دوره و عضویت رسمی در باشگاه مجموعه‌های اکیپا' },
];