Algorise Autonomous API Reference

Base Endpoint & Authentication

Authenticate all private client requests by passing your API Key in the X-API-Key request header. Public defense calculation endpoints do not require authentication tokens.

Analyzes inbound social ad comments, extracts and cryptographically masks prospect phone numbers/emails in real-time, and formats an authenticated private WhatsApp handoff payload.

{
  "comment_text": "Interested in 500 pcs wholesale lot. Call me on 98254-11209",
  "buyer_name": "Kishanbhai (Rajkot Wholesaler)",
  "dispatch_telegram": false
}

{
  "shield_triggered": true,
  "latency_seconds": 0.0184,
  "detected_language": "Multi-lingual Enterprise NLP",
  "qualification_score": 99.4,
  "public_comment_reply": "Thank you! Contact info secured in 0.018s. Catalog dispatched to private WhatsApp DM.",
  "private_messenger_dm": "✨ Algorise Verified Client Atelier\\n• Quotation: Dispatched\\n• 24/7 Concierge Active"
}

Calculates pipeline leakage metrics, annual revenue recovered via sub-minute response times, and payback periods based on monthly ad spend.

{
  "monthly_ad_spend": 150000.0,
  "monthly_comments": 2500,
  "avg_order_value": 45000.0
}

{
  "annual_revenue_recovered": 3645000.0,
  "monthly_revenue_defense": 303750.0,
  "annual_roi_multiplier": 24.3,
  "payback_period_days": 14.8,
  "tier_name": "Surat Enterprise Tier"
}

Configure your Meta Developer App to deliver comment events to our redundant webhook listener. All incoming packets must include a valid X-Hub-Signature-256 header to prevent spoofing.

// Node.js Express Middleware for Signature Verification
const verifyMetaSignature = (req, res, next) => {
  const signature = req.headers['x-hub-signature-256'];
  const expected = 'sha256=' + crypto.createHmac('sha256', process.env.META_APP_SECRET).update(req.rawBody).digest('hex');
  if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
    return res.status(403).json({ error: 'Invalid HMAC signature' });
  }
  next();
};