Lead Follow-up Command

POST /api/agents/sales/leadFollowUp

{
  "siteId": "site_456",
  "leadId": "lead_789",
  "userId": "user_123",
  "agent_id": "agent_sales_123",
  "followUpType": "email",
  "leadStage": "qualified",
  "previousInteractions": [
    {
      "date": "2024-04-15",
      "type": "email",
      "summary": "Initial contact with product information"
    },
    {
      "date": "2024-04-20",
      "type": "call",
      "summary": "Discussed specific product features and pricing"
    }
  ],
  "leadData": {
    "name": "Jane Smith",
    "company": "Acme Inc.",
    "position": "Marketing Director",
    "pain_points": ["time-consuming content creation", "measuring ROI"],
    "budget_range": "$5000-$10000"
  },
  "productInterest": ["content automation", "analytics dashboard"],
  "followUpInterval": "3 days"
}

{
  "targets": [
    {
      "follow_ups": [
        {
          "type": "email",
          "subject": "Following up on our conversation about content automation",
          "content": "Hello Jane,\n\nI hope this email finds you well. I wanted to follow up on our conversation last week about the content automation solutions we discussed. I remember you mentioned that your team is spending too much time on content creation, and I think our platform could help significantly reduce that time.\n\nWould you be available for a quick 15-minute demo this week to see how our solution specifically addresses your content creation challenges? I'd be happy to focus specifically on the time-saving aspects you were most interested in.\n\nBest regards,\nSales Representative",
          "scheduled_for": "2024-04-23T10:00:00Z",
          "next_steps": [
            "If no response in 3 days, follow up with a phone call",
            "If responded positively, schedule demo",
            "If responded with concerns, address specific issues"
          ]
        },
        {
          "type": "call",
          "script": "Hello Jane, this is [Sales Rep] from [Company]. I'm calling to follow up on the email I sent about our content automation solutions. I understand your team is looking for ways to streamline content creation and better measure ROI. Do you have a few minutes to discuss how our platform might help with these challenges?",
          "scheduled_for": "2024-04-26T14:00:00Z",
          "next_steps": [
            "If call successful, send calendar invite for demo",
            "If voicemail, leave message and follow up with another email",
            "If requested more information, send case studies relevant to marketing directors"
          ]
        },
        {
          "type": "email",
          "subject": "Resources for measuring content marketing ROI",
          "content": "Hello Jane,\n\nBased on our conversations, I understand that measuring ROI is one of your key challenges. I've attached a case study that shows how companies similar to Acme Inc. have used our analytics dashboard to measure and improve their content marketing ROI.\n\nAdditionally, I've included a guide on how our platform can help with:\n\n1. Setting up custom KPIs specific to your marketing goals\n2. Tracking conversion paths from content to customer\n3. Generating automated reports for stakeholders\n\nWould you like to schedule a specific demo focused on our analytics capabilities?\n\nBest regards,\nSales Representative",
          "scheduled_for": "2024-04-29T10:00:00Z",
          "next_steps": [
            "If interested in analytics, schedule specialized demo with product expert",
            "If no response in 4 days, try reaching out on LinkedIn",
            "If responded but not ready, add to nurture campaign"
          ]
        }
      ]
    }
  ],
  "context": "Lead came from website demo request form, showing interest in content automation and analytics tools",
  "supervisors": [
    {
      "agent_role": "sales_manager",
      "status": "not_initialized"
    },
    {
      "agent_role": "customer_success",
      "status": "not_initialized"
    }
  ],
  "task": "create lead follow-up sequence",
  "description": "Generate a personalized follow-up sequence for a qualified lead interested in content automation and analytics, focusing on addressing their pain points of time-consuming content creation and measuring ROI, with appropriate timing between touchpoints."
}

{
  "success": true,
  "data": {
    "command_id": "cmd_123456",
    "siteId": "site_456",
    "leadId": "lead_789",
    "follow_ups": [
      {
        "id": "followup_abc123",
        "type": "email",
        "subject": "Following up on our conversation about content automation",
        "content": "Hello Jane,\n\nI hope this email finds you well...",
        "scheduled_for": "2024-04-23T10:00:00Z",
        "status": "scheduled",
        "site_id": "site_456",
        "lead_id": "lead_789",
        "user_id": "user_123",
        "metadata": {
          "next_steps": ["If no response in 3 days, follow up with a phone call"],
          "lead_stage": "qualified",
          "sequence_position": 1,
          "template_used": "qualified_lead_initial_followup"
        }
      }
    ],
    "saved_to_database": true
  }
}

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