CallRail and ClickFlare Integration Guide

Ad click
  → https://trk.yourdomain.com/cf/r/CAMPAIGN?...
     (ClickFlare records the click and generates the click ID)
  → https://your-lander.com/?cf_click_id=CF_CLICK_ID
     (CallRail's website code swaps in a session tracking number)
  → Visitor calls. CallRail saves landing_page_url with the call.
  → Call ends → CallRail Post-Call webhook (POST, JSON) → your relay
  → Relay reads cf_click_id from landing_page_url, plus id, value, lead_status
  → Relay calls:
     https://trk.yourdomain.com/cf/cv?click_id=CF_CLICK_ID&payout=40&txid=CALLRAIL_ID&ct=call
     (ClickFlare matches the call to the original click)

https://trk.yourdomain.com/cf/cv?click_id=CF_CLICK_ID&payout=40&txid=CALLRAIL_ID&ct=good_lead_call

// Receives CallRail's Post-Call and Call Modified webhooks
app.post('/callrail', express.json(), async (req, res) => {
  res.sendStatus(200); // answer CallRail first

  const call = req.body;
  if (!call.landing_page_url) return; // not a session-tracked call

  const clickId = new URL(call.landing_page_url).searchParams.get('cf_click_id');
  if (!clickId) return; // visit didn't come through ClickFlare

  if (call.lead_status !== 'good_lead') return; // optional: qualified calls only

  const payout = parseFloat(String(call.value || '0').replace(/[$,]/g, '')) || 0;

  const postback = new URL('https://trk.yourdomain.com/cf/cv');
  postback.search = new URLSearchParams({
    click_id: clickId,
    payout: String(payout),
    txid: String(call.id),
    ct: 'good_lead_call',
  });
  await fetch(postback);
});