How SalesFlow CRM Boosted Customer Acquisition by 85% with Intelligent Phone-Based Lead Scoring

// Phone-Based Lead Scoring Algorithm
async function calculatePhoneLeadScore(phoneNumber, leadData) {
  try {
    const response = await fetch(`https://api.phone-check.app/v1-get-phone-details?phone=${phoneNumber}`, {
      method: 'GET',
      headers: {
        'accept': 'application/json',
        'x-api-key': process.env.PHONE_CHECK_API_KEY
      }
    });

    const phoneData = await response.json();

    // Base score starts at 50
    let leadScore = 50;
    let confidenceFactors = [];

    // Phone Validation Scoring
    if (phoneData.valid && phoneData.type === 'FIXED_LINE_OR_MOBILE') {
      leadScore += 20;
      confidenceFactors.push('verified_business_number');
    } else if (phoneData.type === 'VOIP') {
      leadScore -= 15;
      confidenceFactors.push('voip_number_risk');
    }

    // Line Type Scoring
    if (phoneData.type === 'MOBILE') {
      leadScore += 10; // Mobile numbers are 45% more likely to convert
      confidenceFactors.push('mobile_preferred');
    }

    // Carrier Intelligence
    const businessCarriers = ['verizon', 'at&t', 't-mobile', 'sprint', 'comcast', 'charter'];
    if (phoneData.carrier && businessCarriers.includes(phoneData.carrier.toLowerCase())) {
      leadScore += 8;
      confidenceFactors.push('business_carrier');
    }

    // Geographic Validation
    const targetMarkets = ['US', 'CA', 'GB', 'AU', 'DE'];
    if (targetMarkets.includes(phoneData.country)) {
      leadScore += 5;
      confidenceFactors.push('target_market');
    }

    // Risk Assessment
    if (phoneData.isDisposable || phoneData.isTollFree) {
      leadScore -= 25;
      confidenceFactors.push('high_risk_number');
    }

    // Activity Score (if available)
    if (phoneData.activityScore > 0.7) {
      leadScore += 12;
      confidenceFactors.push('high_activity');
    }

    // Combine with traditional lead data
    const combinedScore = Math.round(
      (leadScore * 0.6) +
      (traditionalLeadScore(leadData) * 0.4)
    );

    return {
      score: Math.max(0, Math.min(100, combinedScore)),
      phoneSignals: {
        valid: phoneData.valid,
        type: phoneData.type,
        carrier: phoneData.carrier,
        country: phoneData.country,
        confidenceFactors
      },
      recommendation: getScoreRecommendation(combinedScore),
      insights: generateLeadInsights(phoneData, leadData)
    };

  } catch (error) {
    console.error('Phone scoring error:', error);
    return {
      score: traditionalLeadScore(leadData),
      phoneSignals: { error: 'validation_unavailable' },
      recommendation: 'manual_review'
    };
  }
}

function getScoreRecommendation(score) {
  if (score >= 85) return 'immediate_follow_up';
  if (score >= 70) return 'high_priority';
  if (score >= 55) return 'standard_priority';
  if (score >= 40) return 'nurture_sequence';
  return 'low_priority_disqualify';
}

function generateLeadInsights(phoneData, leadData) {
  const insights = [];

  if (phoneData.type === 'MOBILE') {
    insights.push('Mobile contact preferred - 45% faster response rates');
  }

  if (phoneData.carrier && ['verizon', 'at&t', 't-mobile'].includes(phoneData.carrier.toLowerCase())) {
    insights.push('Premium carrier - higher business probability');
  }

  if (phoneData.country === 'US' && leadData.companySize > 100) {
    insights.push('US enterprise prospect - high value target');
  }

  return insights;
}