@conversionpros/aiva 1.0.0

package/meta-leads.js

@@ -0,0 +1,411 @@
+/**
+ * Meta Lead Form Integration Module
+ * Handles real-time webhook + polling for Meta lead forms,
+ * processes leads through GHL (upsert, pipeline, SMS, email),
+ * and fires CAPI events back to Meta.
+ */
+const https = require('https');
+const { sendEvent } = require('./meta-capi');
+
+// --- Config (env vars with fallbacks) ---
+const GHL_TOKEN = process.env.GHL_PIT_TOKEN || 'pit-49079755-6cc5-44b2-b4d5-5195e662ed96';
+const GHL_LOCATION_ID = process.env.GHL_LOCATION_ID || 'aZ66KgncoFQZ6kHEJXzl';
+const GHL_PIPELINE_ID = process.env.GHL_PIPELINE_ID || 'LFU6adJ5XgO6VzH7wU02';
+const GHL_STAGE_FORM_SUBMITTED = process.env.GHL_STAGE_FORM_SUBMITTED || 'e3eb0f2f-3604-4610-a4fe-58519349a7d7';
+
+const META_ACCESS_TOKEN = process.env.META_ACCESS_TOKEN;
+const META_API_VERSION = 'v21.0';
+const META_VERIFY_TOKEN = 'cmp_lead_verify_2026';
+
+const AIVA_FORM_ID = '1502539338103793';
+const SOFTWARE_FORM_ID = '1855096478341715';
+
+const BOOKING_LINK = 'https://api.leadconnectorhq.com/widget/booking/brandons-personal-calendar-1';
+
+// --- Form config map ---
+const FORM_CONFIG = {
+  [AIVA_FORM_ID]: {
+    offer: 'aiva',
+    tags: ['meta-lead', 'aiva-offer', 'facebook-ads'],
+    sms: (firstName) =>
+      `Hey ${firstName}! This is Brandon from Conversion Pros. Thanks for your interest in AIVA - your AI personal assistant. I'd love to show you a quick demo. What time works best for a 15-min call this week?`,
+    emailSubject: 'Your AI Assistant Demo - Next Steps',
+    emailBody: (firstName) =>
+      `Hey ${firstName},\n\nThanks so much for your interest in AIVA. I'm really excited to show you what your own AI personal assistant can do for your business.\n\nI'd love to hop on a quick 15-minute call to walk you through a live demo and answer any questions you have.\n\nYou can grab a time that works for you here:\n${BOOKING_LINK}\n\nLooking forward to connecting!\n\nBrandon Burgan\nConversion Marketing Pros`,
+  },
+  [SOFTWARE_FORM_ID]: {
+    offer: 'software',
+    tags: ['meta-lead', 'software-offer', 'facebook-ads'],
+    sms: (firstName) =>
+      `Hey ${firstName}! This is Brandon from Conversion Pros. Thanks for requesting your free business audit. I'd love to learn more about your business and show you what's possible. What time works best for a quick call this week?`,
+    emailSubject: 'Your Free Business Audit - Next Steps',
+    emailBody: (firstName) =>
+      `Hey ${firstName},\n\nThanks for requesting your free business audit. I'm looking forward to learning more about your business and showing you some quick wins we can get you.\n\nLet's set up a quick call so I can ask a few questions and put together a custom plan for you.\n\nYou can book a time here:\n${BOOKING_LINK}\n\nTalk soon!\n\nBrandon Burgan\nConversion Marketing Pros`,
+  },
+};
+
+// --- GHL API helpers ---
+
+function ghlRequest(method, path, body) {
+  return new Promise((resolve, reject) => {
+    const data = body ? JSON.stringify(body) : null;
+    const req = https.request(
+      {
+        hostname: 'services.leadconnectorhq.com',
+        path,
+        method,
+        headers: {
+          Authorization: `Bearer ${GHL_TOKEN}`,
+          Version: '2021-07-28',
+          'Content-Type': 'application/json',
+          ...(data ? { 'Content-Length': Buffer.byteLength(data) } : {}),
+        },
+      },
+      (res) => {
+        let raw = '';
+        res.on('data', (chunk) => (raw += chunk));
+        res.on('end', () => {
+          try {
+            const parsed = JSON.parse(raw);
+            if (res.statusCode >= 400) {
+              console.error(`[meta-leads] GHL ${method} ${path} ${res.statusCode}:`, raw);
+              return reject(new Error(`GHL ${res.statusCode}: ${raw}`));
+            }
+            resolve(parsed);
+          } catch (e) {
+            reject(new Error(`GHL parse error: ${raw}`));
+          }
+        });
+      }
+    );
+    req.on('error', reject);
+    if (data) req.write(data);
+    req.end();
+  });
+}
+
+async function upsertContact({ firstName, lastName, email, phone, tags, source }) {
+  const body = {
+    firstName,
+    lastName,
+    locationId: GHL_LOCATION_ID,
+    source: source || 'Facebook Ads',
+  };
+  if (email) body.email = email;
+  if (phone) body.phone = phone;
+  if (tags && tags.length) body.tags = tags;
+
+  const result = await ghlRequest('POST', '/contacts/upsert', body);
+  const contactId = result.contact?.id || result.id;
+  console.log(`[meta-leads] Contact upserted: ${contactId} (${firstName} ${lastName})`);
+  return { contactId, contact: result.contact || result };
+}
+
+async function createOpportunity({ contactId, firstName, lastName, offerLabel }) {
+  const body = {
+    pipelineId: GHL_PIPELINE_ID,
+    locationId: GHL_LOCATION_ID,
+    stageId: GHL_STAGE_FORM_SUBMITTED,
+    contactId,
+    name: `${offerLabel} Lead - ${firstName} ${lastName}`,
+    status: 'open',
+  };
+  const result = await ghlRequest('POST', '/opportunities/upsert', body);
+  const oppId = result.opportunity?.id || result.id;
+  console.log(`[meta-leads] Opportunity created: ${oppId}`);
+  return result;
+}
+
+async function sendSMS(contactId, message) {
+  const result = await ghlRequest('POST', '/conversations/messages', {
+    type: 'SMS',
+    contactId,
+    message,
+  });
+  console.log(`[meta-leads] SMS sent to contactId=${contactId}`);
+  return result;
+}
+
+async function sendEmail(contactId, subject, body) {
+  const result = await ghlRequest('POST', '/conversations/messages', {
+    type: 'Email',
+    contactId,
+    subject,
+    message: body,
+    emailFrom: 'brandon@conversionmarketingpros.com',
+  });
+  console.log(`[meta-leads] Email sent to contactId=${contactId}`);
+  return result;
+}
+
+// --- Lead parsing ---
+
+function parseMetaLeadData(leadData) {
+  // Meta sends field_data as array of { name, values }
+  const fields = {};
+  if (Array.isArray(leadData.field_data)) {
+    for (const f of leadData.field_data) {
+      fields[f.name] = f.values?.[0] || '';
+    }
+  }
+
+  // Split full_name if present
+  let firstName = fields.first_name || '';
+  let lastName = fields.last_name || '';
+  if (!firstName && fields.full_name) {
+    const parts = fields.full_name.trim().split(/\s+/);
+    firstName = parts[0] || '';
+    lastName = parts.slice(1).join(' ') || '';
+  }
+
+  return {
+    firstName,
+    lastName,
+    email: fields.email || '',
+    phone: fields.phone_number || fields.phone || '',
+    leadId: leadData.id,
+    createdTime: leadData.created_time,
+    rawFields: fields,
+  };
+}
+
+// --- Main processing pipeline ---
+
+async function processLead(leadData, formId) {
+  const config = FORM_CONFIG[formId];
+  if (!config) {
+    console.warn(`[meta-leads] Unknown form ID: ${formId}, using AIVA defaults`);
+  }
+  const cfg = config || FORM_CONFIG[AIVA_FORM_ID];
+  const offerLabel = cfg.offer === 'aiva' ? 'AIVA' : 'Software';
+
+  const parsed = parseMetaLeadData(leadData);
+  const { firstName, lastName, email, phone } = parsed;
+
+  console.log(`[meta-leads] Processing ${offerLabel} lead: ${firstName} ${lastName} | email=${email} | phone=${phone}`);
+
+  const results = { steps: [] };
+
+  // 1. Upsert contact in GHL
+  try {
+    const { contactId } = await upsertContact({
+      firstName,
+      lastName,
+      email,
+      phone,
+      tags: cfg.tags,
+      source: 'Facebook Ads',
+    });
+    results.contactId = contactId;
+    results.steps.push('contact_upserted');
+
+    // 2. Create opportunity
+    try {
+      await createOpportunity({ contactId, firstName, lastName, offerLabel });
+      results.steps.push('opportunity_created');
+    } catch (err) {
+      console.error(`[meta-leads] Opportunity creation failed:`, err.message);
+      results.steps.push('opportunity_failed');
+    }
+
+    // 3. Send SMS (only if phone present)
+    if (phone) {
+      try {
+        await sendSMS(contactId, cfg.sms(firstName || 'there'));
+        results.steps.push('sms_sent');
+      } catch (err) {
+        console.error(`[meta-leads] SMS failed:`, err.message);
+        results.steps.push('sms_failed');
+      }
+    } else {
+      results.steps.push('sms_skipped_no_phone');
+    }
+
+    // 4. Send email (only if email present)
+    if (email) {
+      try {
+        await sendEmail(contactId, cfg.emailSubject, cfg.emailBody(firstName || 'there'));
+        results.steps.push('email_sent');
+      } catch (err) {
+        console.error(`[meta-leads] Email failed:`, err.message);
+        results.steps.push('email_failed');
+      }
+    } else {
+      results.steps.push('email_skipped_no_email');
+    }
+
+    // 5. Fire CAPI Lead event back to Meta
+    try {
+      const capiResult = await sendEvent('Lead', {
+        sourceUrl: 'https://www.conversionmarketingpros.com',
+        actionSource: 'system_generated',
+      }, {
+        email,
+        phone,
+        firstName,
+        lastName,
+      });
+      results.capiEventId = capiResult.eventId;
+      results.steps.push('capi_fired');
+    } catch (err) {
+      console.error(`[meta-leads] CAPI event failed:`, err.message);
+      results.steps.push('capi_failed');
+    }
+  } catch (err) {
+    console.error(`[meta-leads] Contact upsert failed:`, err.message);
+    results.steps.push('contact_upsert_failed');
+    results.error = err.message;
+  }
+
+  console.log(`[meta-leads] Pipeline complete for ${firstName} ${lastName}: ${results.steps.join(', ')}`);
+  return results;
+}
+
+// --- Meta Lead Retrieval (polling) ---
+
+function metaGraphRequest(path) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(`https://graph.facebook.com/${META_API_VERSION}${path}&access_token=${encodeURIComponent(META_ACCESS_TOKEN)}`, (res) => {
+        let data = '';
+        res.on('data', (chunk) => (data += chunk));
+        res.on('end', () => {
+          try {
+            const parsed = JSON.parse(data);
+            if (parsed.error) {
+              console.error(`[meta-leads] Graph API error:`, parsed.error);
+              return reject(new Error(parsed.error.message));
+            }
+            resolve(parsed);
+          } catch (e) {
+            reject(new Error(`Meta Graph parse error: ${data}`));
+          }
+        });
+      })
+      .on('error', reject);
+  });
+}
+
+async function pollFormLeads(formId) {
+  console.log(`[meta-leads] Polling form ${formId} for leads...`);
+  const result = await metaGraphRequest(`/${formId}/leads?`);
+  return result.data || [];
+}
+
+// --- Express Router ---
+
+function createRouter(express) {
+  const router = express.Router();
+
+  // GET - Meta webhook verification
+  router.get('/webhook', (req, res) => {
+    const mode = req.query['hub.mode'];
+    const token = req.query['hub.verify_token'];
+    const challenge = req.query['hub.challenge'];
+
+    if (mode === 'subscribe' && token === META_VERIFY_TOKEN) {
+      console.log('[meta-leads] Webhook verified');
+      return res.status(200).send(challenge);
+    }
+    console.warn('[meta-leads] Webhook verification failed');
+    return res.status(403).send('Forbidden');
+  });
+
+  // POST - Meta sends lead data here
+  router.post('/webhook', async (req, res) => {
+    // Respond immediately to Meta (they require fast 200)
+    res.status(200).json({ status: 'received' });
+
+    try {
+      const body = req.body;
+      console.log('[meta-leads] Webhook received:', JSON.stringify(body).slice(0, 500));
+
+      // Meta sends: { object: "page", entry: [{ id, time, changes: [{ field: "leadgen", value: { ... } }] }] }
+      if (body.object === 'page' && Array.isArray(body.entry)) {
+        for (const entry of body.entry) {
+          const changes = entry.changes || [];
+          for (const change of changes) {
+            if (change.field === 'leadgen') {
+              const leadgenData = change.value;
+              const formId = String(leadgenData.form_id || '');
+              const leadgenId = leadgenData.leadgen_id;
+
+              // Fetch full lead data from Meta
+              try {
+                const leadDetail = await metaGraphRequest(`/${leadgenId}?`);
+                await processLead(leadDetail, formId);
+              } catch (err) {
+                console.error(`[meta-leads] Failed to fetch/process lead ${leadgenId}:`, err.message);
+              }
+            }
+          }
+        }
+      }
+    } catch (err) {
+      console.error('[meta-leads] Webhook processing error:', err.message);
+    }
+  });
+
+  // GET - Poll both forms for recent leads
+  router.get('/poll', async (req, res) => {
+    try {
+      if (!META_ACCESS_TOKEN) {
+        return res.status(500).json({ error: 'META_ACCESS_TOKEN not configured' });
+      }
+
+      const [aivaLeads, softwareLeads] = await Promise.all([
+        pollFormLeads(AIVA_FORM_ID).catch((e) => { console.error('[meta-leads] AIVA poll error:', e.message); return []; }),
+        pollFormLeads(SOFTWARE_FORM_ID).catch((e) => { console.error('[meta-leads] Software poll error:', e.message); return []; }),
+      ]);
+
+      // Process toggle - only process if ?process=true (safety)
+      const shouldProcess = req.query.process === 'true';
+      const results = { aiva: { count: aivaLeads.length, leads: aivaLeads }, software: { count: softwareLeads.length, leads: softwareLeads }, processed: [] };
+
+      if (shouldProcess) {
+        for (const lead of aivaLeads) {
+          try {
+            const r = await processLead(lead, AIVA_FORM_ID);
+            results.processed.push({ leadId: lead.id, formId: AIVA_FORM_ID, ...r });
+          } catch (err) {
+            results.processed.push({ leadId: lead.id, formId: AIVA_FORM_ID, error: err.message });
+          }
+        }
+        for (const lead of softwareLeads) {
+          try {
+            const r = await processLead(lead, SOFTWARE_FORM_ID);
+            results.processed.push({ leadId: lead.id, formId: SOFTWARE_FORM_ID, ...r });
+          } catch (err) {
+            results.processed.push({ leadId: lead.id, formId: SOFTWARE_FORM_ID, error: err.message });
+          }
+        }
+      }
+
+      res.json(results);
+    } catch (err) {
+      console.error('[meta-leads] Poll error:', err.message);
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // GET - Health/status check
+  router.get('/status', (req, res) => {
+    res.json({
+      ok: true,
+      forms: {
+        aiva: AIVA_FORM_ID,
+        software: SOFTWARE_FORM_ID,
+      },
+      pipeline: {
+        id: GHL_PIPELINE_ID,
+        stageId: GHL_STAGE_FORM_SUBMITTED,
+      },
+      verifyToken: META_VERIFY_TOKEN,
+      metaTokenConfigured: !!META_ACCESS_TOKEN,
+    });
+  });
+
+  return router;
+}
+
+module.exports = { createRouter, processLead, parseMetaLeadData, upsertContact, createOpportunity };