CMS Webhook

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "event": "created",
  "title": "How to Implement Webhooks",
  "meta_title": "How to Implement Webhooks",
  "slug": "how-to-implement-webhooks",
  "meta_description": "Learn how to implement webhooks in your application with this comprehensive guide.",
  "content_markdown": "# How to Implement Webhooks\n\nWebhooks are powerful...",
  "content_html": "<h1>How to Implement Webhooks</h1><p>Webhooks are powerful...</p>",
  "keyword": "implement webhooks",
  "article_type": "Guide: How-to",
  "word_count": 1847,
  "reading_time": 9,
  "featured_image": {
    "url": "https://storage.example.com/images/webhook-guide.jpg",
    "alt": "How to Implement Webhooks"
  },
  "faq": [
    { "question": "What is a webhook?", "answer": "An HTTP callback fired when an event occurs." }
  ],
  "json_ld": {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "How to Implement Webhooks"
  },
  "created_at": "2026-01-31T12:00:00.000Z",
  "generated_at": "2026-01-31T14:30:00.000Z"
}

const express = require("express");
const app = express();

const WEBHOOK_SECRET = process.env.WEBHOOK_SECRET;

app.post("/webhook/seo-ladders", express.json(), async (req, res) => {
  // 1. Verify the request is from SEOLadders
  if (req.headers["x-webhook-secret"] !== WEBHOOK_SECRET) {
    return res.status(401).json({ error: "Invalid webhook secret" });
  }

  const article = req.body;

  // 2. Upsert by "id" — this is the key. The same article always keeps the
  //    same "id" across re-sends (an optimized version arrives with event
  //    "updated" and the SAME id), so upserting replaces the post in place
  //    instead of creating a duplicate.
  const existing = await db.posts.findOne({ seo_ladders_id: article.id });

  if (existing) {
    await db.posts.update(
      { seo_ladders_id: article.id },
      {
        title: article.title,
        slug: article.slug,
        content_markdown: article.content_markdown,
        meta_description: article.meta_description,
        featured_image: article.featured_image,
      },
    );
  } else {
    await db.posts.insert({
      seo_ladders_id: article.id, // store it so future updates match
      title: article.title,
      slug: article.slug,
      content_markdown: article.content_markdown,
      meta_description: article.meta_description,
      featured_image: article.featured_image,
    });
  }

  // Tell SEOLadders where the post lives and that it is live, so the
  // dashboard marks it Published and links to it. Send "draft" instead if
  // your endpoint saves posts unpublished.
  return res.status(200).json({
    ok: true,
    url: "https://yoursite.com/blog/" + article.slug,
    status: "published",
  });
});

app.listen(3000);

from flask import Flask, request, jsonify
import os

app = Flask(__name__)
WEBHOOK_SECRET = os.environ.get("WEBHOOK_SECRET")

@app.route("/webhook/seo-ladders", methods=["POST"])
def handle_webhook():
    # 1. Verify the request is from SEOLadders
    if request.headers.get("X-Webhook-Secret") != WEBHOOK_SECRET:
        return jsonify({"error": "Invalid webhook secret"}), 401

    article = request.json

    # 2. Upsert by "id" — this is the key. The same article always keeps the
    #    same "id" across re-sends (an optimized version arrives with event
    #    "updated" and the SAME id), so upserting replaces the post in place
    #    instead of creating a duplicate.
    fields = {
        "title": article["title"],
        "slug": article["slug"],
        "content_markdown": article["content_markdown"],
        "meta_description": article["meta_description"],
        "featured_image": article.get("featured_image"),
    }

    existing = db.posts.find_one(seo_ladders_id=article["id"])
    if existing:
        db.posts.update(seo_ladders_id=article["id"], **fields)
    else:
        # store the id so future updates match
        db.posts.insert(seo_ladders_id=article["id"], **fields)

    # Tell SEOLadders where the post lives and that it is live, so the
    # dashboard marks it Published and links to it. Send "draft" instead if
    # your endpoint saves posts unpublished.
    return jsonify({
        "ok": True,
        "url": "https://yoursite.com/blog/" + article["slug"],
        "status": "published",
    }), 200

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

function buildArticleHtml(payload) {
  let html = "";

  // 1. Featured image at the top — improves engagement and SEO
  if (payload.featured_image?.url) {
    html += '<figure class="featured-image">' +
      '<img src="' + payload.featured_image.url + '" ' +
      'alt="' + (payload.featured_image.alt || payload.title) + '" />' +
      "</figure>\n\n";
  }

  // 2. Article body
  html += payload.content_html;

  // 3. JSON-LD structured data — eligible for rich snippets
  if (payload.json_ld) {
    html += '\n\n<script type="application/ld+json">\n' +
      JSON.stringify(payload.json_ld, null, 2) +
      "\n</script>";
  }

  return html;
}

// In your <head>:
function buildMetaTags(payload) {
  return [
    `<meta name="description" content="${payload.meta_description}" />`,
    `<meta property="og:title" content="${payload.title}" />`,
    `<meta property="og:description" content="${payload.meta_description}" />`,
    `<meta property="og:image" content="${payload.featured_image?.url ?? ""}" />`,
  ].join("\n");
}

{
  "event": "seo_fix",
  "action": "apply",
  "page_url": "https://example.com/pricing",
  "fix": {
    "kind": "meta_description",
    "description": "Plans for teams of every size, billed monthly or yearly. Compare what each plan includes and pick the one that fits.",
    "reason": "The page had no meta description."
  },
  "sent_at": "2026-11-01T09:00:00.000Z"
}

// Route on "event" before treating a body as an article:
app.post("/api/seoladders", (req, res) => {
  if (req.body.event === "seo_fix") {
    applySeoFix(req.body); // "apply" or "revert" the same fix
    return res.status(200).json({ ok: true });
  }
  upsertArticle(req.body);
  res.status(200).json({ ok: true });
});