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