Lead Research Command

POST /api/agents/sales/leadResearch

{
  "site_id": "site_456",
  "lead_id": "lead_789",
  "userId": "user_123",
  "agent_id": "agent_sales_123",
  "researchDepth": "comprehensive",
  "researchAreas": ["company_background", "decision_makers", "recent_news", "pain_points"],
  "includeSocialMedia": true,
  "includeCompetitorAnalysis": true,
  "includeFinancialInfo": false
}

{
  "targets": [
    {
      "title": "Company Background Research",
      "message": "Comprehensive analysis of ABC Corp including industry positioning, business model, revenue streams, and key offerings. The company operates in the enterprise software sector with a focus on HR management solutions. Founded in 2015, they've grown to 200+ employees and serve mid-market companies across North America.",
      "channel": "research",
      "type": "company_analysis"
    },
    {
      "title": "Key Personnel Analysis",
      "message": "Decision maker profile: Jane Smith, Chief Technology Officer. 8+ years experience in HR tech, previously at TalentMax Solutions. Recently posted about challenges with employee data integration and scalability. Direct reports include VP of Engineering and VP of Product.",
      "channel": "research",
      "type": "personnel_analysis"
    },
    {
      "title": "Recent Company News & Updates",
      "message": "Recent developments: Series B funding round of $15M completed 3 months ago, led by TechVentures. New product launch announced for Q2 2024. Partnership with CloudCorp for infrastructure scaling. Company blog mentions expansion into Canadian market.",
      "channel": "research",
      "type": "news_analysis"
    },
    {
      "title": "Pain Points & Challenges Identification",
      "message": "Identified challenges: 1) Data integration issues across multiple HR systems, 2) Scalability concerns with current infrastructure, 3) Need for advanced analytics and reporting, 4) Integration with payroll systems, 5) Mobile accessibility for remote workforce.",
      "channel": "research",
      "type": "pain_point_analysis"
    },
    {
      "title": "Competitive Landscape Analysis",
      "message": "Primary competitors: BambooHR, Workday, Zenefits. Competitive positioning: Mid-market focus with strong customization capabilities. Differentiation: Advanced workflow automation and API-first architecture. Market opportunity: Growing demand for integrated HR solutions.",
      "channel": "research",
      "type": "competitive_analysis"
    },
    {
      "title": "Engagement Recommendations",
      "message": "Recommended approach: 1) Lead with data integration capabilities, 2) Emphasize scalability and performance, 3) Showcase analytics dashboard, 4) Offer technical demo focusing on API integrations, 5) Connect with CTO and VP of Engineering, 6) Timing: Best to reach out Tuesday-Thursday, 10-11 AM EST.",
      "channel": "recommendations",
      "type": "engagement_strategy"
    }
  ],
  "context": "Lead research for enterprise software prospect showing interest in HR management solutions, with focus on technical decision makers and integration capabilities",
  "supervisors": [
    {
      "agent_role": "sales_manager",
      "status": "not_initialized"
    },
    {
      "agent_role": "research_analyst",
      "status": "not_initialized"
    }
  ],
  "task": "conduct comprehensive lead research",
  "description": "Conduct comprehensive research on a lead to gather valuable insights for sales and marketing strategies. Include company background, key personnel, recent news, competitive landscape, and potential pain points."
}

{
  "success": true,
  "data": {
    "command_id": "cmd_123456",
    "site_id": "site_456",
    "lead_id": "lead_789",
    "research_results": [
      {
        "id": "research_abc123",
        "title": "Company Background Research",
        "content": "Comprehensive analysis of ABC Corp including industry positioning...",
        "category": "research",
        "research_type": "comprehensive",
        "status": "completed",
        "generated_at": "2024-04-23T10:00:00Z",
        "metadata": {
          "include_social_media": true,
          "include_competitor_analysis": true,
          "include_financial_info": false,
          "research_areas": ["company_background", "decision_makers"],
          "confidence_score": 0.85
        }
      }
    ],
    "saved_to_database": true,
    "research_configuration": {
      "depth": "comprehensive",
      "include_social_media": true,
      "include_competitor_analysis": true,
      "include_financial_info": false,
      "research_areas": ["company_background", "decision_makers", "recent_news", "pain_points"]
    }
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request parameters"
  }
}