Webhook Integration Guide

{
  "event": "publish",
  "version": "2.0",
  "timestamp": "2026-02-18T14:10:00.000Z",
  "data": {
    "title": "How to Automate SaaS SEO in 2026",
    "slug": "how-to-automate-saas-seo-2026",
    "excerpt": "A comprehensive guide on leveraging AI and webhooks...",
    "content": "<h1>How to Automate...</h1><p>The full HTML string, prepared for direct injection...</p>",
    "featured_image": {
      "url": "https://storage.googleapis.com/.../featured-image.png",
      "alt": "How to Automate SaaS SEO in 2026"
    },
    "inline_images": [
      {
        "url": "https://storage.googleapis.com/.../chart-1.png",
        "alt": "SEO metrics growth chart"
      }
    ],
    "seo": {
      "meta_title": "Automate SaaS SEO: The 2026 AI Guide",
      "meta_description": "Learn how to use webhooks and AI agents...",
      "focus_keyword": "SaaS SEO automation",
      "canonical_url": null
    },
    "published_at": "2026-02-18T14:10:00.000Z",
    "scheduled_date": null,
    "reading_time_minutes": 6,
    "word_count": 1420,
    "external_id": null,
    "source_blog_id": "abc123xyz",
    "source_platform": "webhook",
    "featuredImage": "https://storage.googleapis.com/.../featured-image.png",
    "metaDescription": "Learn how to use webhooks and AI agents...",
    "externalId": null,
    "tags": ["SaaS SEO automation"],
    "author": null
  }
}

{
  "event": "ping",
  "timestamp": "2026-02-18T14:10:00.000Z",
  "message": "Verifying connection from Better Blog AI"
}

import crypto from "crypto";

function verifySignature(rawBody, headerSignature, secret) {
  if (!headerSignature || !secret) return false;

  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");

  const provided = headerSignature.startsWith("sha256=")
    ? headerSignature.slice(7)
    : headerSignature;

  try {
    return crypto.timingSafeEqual(
      Buffer.from(expected, "hex"),
      Buffer.from(provided, "hex")
    );
  } catch {
    return false;
  }
}

app.post("/api/webhooks/betterblog", express.text({ type: "*/*" }), async (req, res) => {
  const rawBody = req.body;
  const deliveryId = req.get("X-BetterBlog-Delivery-ID");
  const signature = req.get("X-BetterBlog-Signature");
  const secret = process.env.BETTERBLOG_WEBHOOK_SECRET;

  // 1) Parse JSON
  let payload;
  try {
    payload = JSON.parse(rawBody);
  } catch {
    return res.status(400).json({ error: "Invalid JSON" });
  }

  // 2) Optional ping support (used by Test & Connect)
  if (payload.event === "ping") {
    return res.status(200).json({ status: "ok", message: "Pong!" });
  }

  // 3) Verify signature
  if (!verifySignature(rawBody, signature, secret)) {
    return res.status(401).json({ error: "Invalid signature" });
  }

  // 4) Idempotency guard
  const alreadyProcessed = await hasDeliveryId(deliveryId);
  if (alreadyProcessed) {
    return res.status(200).json({ message: "Already processed (idempotent)" });
  }

  const { event, data } = payload;
  if (!event || !data) return res.status(400).json({ error: "Missing event or data" });

  // 5) Upsert / delete content
  if (event === "publish" || event === "update") {
    const savedPost = await upsertPost({
      slug: data.slug,
      sourceBlogId: data.source_blog_id,
      title: data.title,
      html: data.content,
      seo: data.seo,
      featuredImage: data.featured_image,
      inlineImages: data.inline_images
    });

    await markDeliveryId(deliveryId);

    return res.status(200).json({
      id: savedPost.id,              // optional but recommended
      url: savedPost.publicUrl       // optional but recommended
    });
  }

  if (event === "delete") {
    await deletePostBySourceIdOrSlug(data.source_blog_id, data.slug || data.external_id);
    await markDeliveryId(deliveryId);
    return res.status(200).json({ message: "Deleted" });
  }

  return res.status(400).json({ error: "Unknown event" });
});

{
  "id": "cms-post-id-or-slug",
  "url": "https://yourdomain.com/blog/cms-post-id-or-slug"
}