Local Webhook Testing with ngrok

brew install ngrok

curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
  | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null \
  && echo "deb https://ngrok-agent.s3.amazonaws.com buster main" \
  | sudo tee /etc/apt/sources.list.d/ngrok.list \
  && sudo apt update \
  && sudo apt install ngrok

choco install ngrok

# Visit https://ngrok.com/download and download for your platform

from flask import Flask, request
import hmac
import hashlib

app = Flask(__name__)
WEBHOOK_SECRET = "whsec_your_secret_here"

@app.route("/webhooks/docintel", methods=["POST"])
def handle_webhook():
    # Verify signature
    signature = request.headers.get("X-DocIntell-Signature")
    payload = request.get_data()

    expected = "sha256=" + hmac.new(
        WEBHOOK_SECRET.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(signature, expected):
        print("⚠️  Invalid signature!")
        return {"error": "Invalid signature"}, 401

    event = request.get_json()
    print(f"✅ Received event: {event['event']}")
    print(f"   Document ID: {event['data']['document_id']}")

    return {"status": "ok"}, 200

if __name__ == "__main__":
    app.run(port=3000, debug=True)

import express from 'express';
import crypto from 'crypto';

const app = express();
const WEBHOOK_SECRET = 'whsec_your_secret_here';

app.post('/webhooks/docintel', express.raw({type: '*/*'}), (req, res) => {
  const signature = req.headers['x-docintel-signature'] as string;
  const payload = req.body;

  const expected = 'sha256=' + crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(payload)
    .digest('hex');

  if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
    console.log('⚠️  Invalid signature!');
    return res.status(401).json({ error: 'Invalid signature' });
  }

  const event = JSON.parse(payload.toString());
  console.log(`✅ Received event: ${event.event}`);
  console.log(`   Document ID: ${event.data.document_id}`);

  res.json({ status: 'ok' });
});

app.listen(3000, () => {
  console.log('Webhook server running on port 3000');
});