К основному содержанию
скилл CX Codex

webflow-webhooks — скилл для Claude Code: вебхуки и установка

Скилл webflow-webhooks помогает принимать события Webflow, проверять подписи и разбирать ошибки обработчиков. Нужен при настройке форм, заказов и CMS-вебхуков.

MIT 190 установок ★ 103 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a claude-code
Открыть на GitHub

Что делает webflow-webhooks

Скилл показывает, как принять Webflow webhook через HTTP-обработчик, сохранить исходное тело запроса и проверить заголовки x-webflow-signature и x-webflow-timestamp. Подпись считается через HMAC-SHA256, а метка времени ограничивает повторную отправку запроса окном в 5 минут.

Внутри есть пример для Express с обработкой form_submission, ecomm_new_order и событий CMS. Также описаны переменная WEBFLOW_WEBHOOK_SECRET, варианты секрета для OAuth и API, а для локальной проверки предложен туннель npx hookdeck-cli listen 3000 webflow --path /webhooks/webflow.

Вебхуки, созданные через панель Webflow, не содержат заголовки подписи. Проверка сломается, если передать в неё распарсенный JSON вместо исходного тела запроса.

Какие задачи решает

  • принять события Webflow на HTTP-эндпоинте
  • проверить HMAC-подпись входящего запроса
  • обработать отправку формы и новый заказ
  • разобрать изменения элементов Webflow CMS
  • протестировать webhook локально через туннель

Примеры запросов агенту

  • Настрой обработчик Webflow webhook в Express с проверкой x-webflow-signature и x-webflow-timestamp.
  • Разбери события form_submission, ecomm_new_order и collection_item_changed в моём обработчике.
  • Проверь, почему проверка подписи Webflow не проходит, и используй исходное тело запроса.

Как установить webflow-webhooks

1Через Skills CLI (Vercel)

npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a claude-code

2Вручную: положить файлы

~/.claude/skills/webflow-webhooks/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/webflow-webhooks/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о webflow-webhooks

Как установить webflow-webhooks в Claude Code?

Выполните npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a claude-code. Файл появится по пути ~/.claude/skills/webflow-webhooks/SKILL.md.

Что делает webflow-webhooks?

Скилл помогает принимать Webflow webhooks, проверять их HMAC-SHA256 подписи и обрабатывать события форм, заказов, публикации сайта и CMS.

Какие Webflow webhooks поддерживают проверку подписи?

Заголовки x-webflow-signature и x-webflow-timestamp есть у вебхуков, созданных через OAuth-приложения или API. Вебхуки из панели Webflow этих заголовков не содержат.

Исходный текст

SKILL.md · MIT
---
name: webflow-webhooks
description: Receive and verify Webflow webhooks. Use when setting up Webflow webhook handlers, debugging signature verification, or handling Webflow events like form_submission, site_publish, ecomm_new_order, or collection item changes.
license: MIT
metadata:
  author: hookdeck
  version: "0.1.0"
  repository: https://github.com/hookdeck/webhook-skills
---

# Webflow Webhooks

## When to Use This Skill

- How do I receive Webflow webhooks?
- How do I verify Webflow webhook signatures?
- How do I handle form_submission events from Webflow?
- How do I process Webflow ecommerce order events?
- Why is my Webflow webhook signature verification failing?
- Setting up Webflow CMS collection item webhooks

## Essential Code

### Signature Verification (Manual)

```javascript
const crypto = require('crypto');

function verifyWebflowSignature(rawBody, signature, timestamp, secret) {
  // Check timestamp to prevent replay attacks (5 minute window - 300000 milliseconds)
  const currentTime = Date.now();
  if (Math.abs(currentTime - parseInt(timestamp)) > 300000) {
    return false;
  }

  // Generate HMAC signature
  const signedContent = `${timestamp}:${rawBody}`;
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(signedContent)
    .digest('hex');

  // Timing-safe comparison
  try {
    return crypto.timingSafeEqual(
      Buffer.from(signature),
      Buffer.from(expectedSignature)
    );
  } catch {
    return false; // Different lengths = invalid
  }
}
```

### Processing Events

```javascript
app.post('/webhooks/webflow', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-webflow-signature'];
  const timestamp = req.headers['x-webflow-timestamp'];

  if (!signature || !timestamp) {
    return res.status(400).send('Missing required headers');
  }

  // Verify signature (use OAuth client secret or webhook-specific secret)
  const isValid = verifyWebflowSignature(
    req.body.toString(),
    signature,
    timestamp,
    process.env.WEBFLOW_WEBHOOK_SECRET
  );

  if (!isValid) {
    return res.status(400).send('Invalid signature');
  }

  // Parse the verified payload
  const event = JSON.parse(req.body);

  // Handle different event types
  switch (event.triggerType) {
    case 'form_submission':
      console.log('New form submission:', event.payload.data);
      break;
    case 'ecomm_new_order':
      console.log('New order:', event.payload);
      break;
    case 'collection_item_created':
      console.log('New CMS item:', event.payload);
      break;
    // Add more event handlers as needed
  }

  // Always return 200 to acknowledge receipt
  res.status(200).send('OK');
});
```

## Common Event Types

| Event | Triggered When | Use Case |
|-------|----------------|----------|
| `form_submission` | Form submitted on site | Contact forms, lead capture |
| `site_publish` | Site is published | Clear caches, trigger builds |
| `ecomm_new_order` | New ecommerce order | Order processing, inventory |
| `ecomm_order_changed` | Order status changes | Update fulfillment systems |
| `collection_item_created` | CMS item created | Content syndication |
| `collection_item_changed` | CMS item updated | Update external systems |
| `collection_item_deleted` | CMS item deleted | Remove from external systems |
| `collection_item_published` | CMS item published | Invalidate caches, publish downstream |

Webflow documents 13 event types on
[All Events](https://developers.webflow.com/data/reference/all-events); its
official `webflow-api` SDK `TriggerType` enum carries those plus
`collection_item_published`. The `user_account_*` events are deprecated — see
[references/overview.md](references/overview.md#deprecated-event-types).

## Environment Variables

```bash
# For webhooks created via OAuth App
WEBFLOW_WEBHOOK_SECRET=your_oauth_client_secret

# For webhooks created via API (after April 2025)
WEBFLOW_WEBHOOK_SECRET=whsec_xxxxx  # Returned when creating webhook
```

## Local Development

For local webhook testing, install Hookdeck CLI:

```bash
```

Then start the tunnel:

```bash
npx hookdeck-cli listen 3000 webflow --path /webhooks/webflow
```

No account required. Provides local tunnel + web UI for inspecting requests.

## Resources

- [What Are Webflow Webhooks](references/overview.md) - Event types and payload structure
- [Setting Up Webflow Webhooks](references/setup.md) - Dashboard configuration and API setup
- [Signature Verification Details](references/verification.md) - In-depth verification guide
- [Express Example](examples/express/) - Node.js implementation with tests
- [Next.js Example](examples/nextjs/) - App Router implementation
- [FastAPI Example](examples/fastapi/) - Python implementation

## Important Notes

- Webhooks created through the Webflow dashboard do NOT include signature headers
- Only webhooks created via OAuth apps or API include `x-webflow-signature` and `x-webflow-timestamp`
- Always use raw body for signature verification, not parsed JSON
- Timestamp validation (5 minute window - 300000 milliseconds) is critical to prevent replay attacks
- Return 200 status to acknowledge receipt; other statuses trigger retries (up to 3 times)

## Recommended: webhook-handler-patterns

This skill pairs well with webhook-handler-patterns for production-ready implementations:

- [Handler sequence](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/handler-sequence.md) — Request flow and middleware order
- [Idempotency](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/idempotency.md) — Handling duplicate events
- [Error handling](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/error-handling.md) — Graceful failure and recovery
- [Retry logic](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/retry-logic.md) — Handling failed processing

## Related Skills

- [stripe-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/stripe-webhooks) - Stripe webhook handling with similar HMAC-SHA256 verification
- [shopify-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/shopify-webhooks) - Shopify webhook implementation
- [github-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/github-webhooks) - GitHub webhook handling
- [webhook-handler-patterns](https://github.com/hookdeck/webhook-skills/tree/main/skills/webhook-handler-patterns) - Production patterns for all webhooks
- [hookdeck-event-gateway](https://github.com/hookdeck/webhook-skills/tree/main/skills/hookdeck-event-gateway) - Webhook infrastructure and reliability

Sources:
- [Working with Webhooks – Webflow Docs](https://developers.webflow.com/data/docs/working-with-webhooks)
- [Webhook Signatures Changelog](https://developers.webflow.com/data/changelog/webhook-signatures)

© hookdeck · MIT · hookdeck/webhook-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
setup-zoom-webhooks официальный anthropics Скилл setup-zoom-webhooks для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI с эталонной документацией по Zoom webhooks. Включается при реализации подписок на события, проверки подписи x-zm-signature и обработки доставки. CX Codex +1 2 200установок fireflies-webhooks-events Jeremy Longshore Скилл fireflies-webhooks-events проводит агента по сборке приёмника Fireflies Webhooks V2: проверка HMAC по сырому телу, белый список событий, дедупликация и быстрый ответ 2xx. CX Codex +1 1установок firecrawl-webhooks-events Jeremy Longshore Скилл firecrawl-webhooks-events настраивает приём вебхуков Firecrawl: валидацию подписи HMAC-SHA256, дедупликацию и синхронизацию статусов. CX Codex +1 1установок webhook-receiver-hardener patricio0312rev Скилл webhook-receiver-hardener помогает проектировать защищённые эндпоинты для вебхуков. Защищает обработчики от подделки запросов, повторных доставок и сбоев сторонних сервисов. CX Codex +1 287установок webhook-integration dodopayments Скилл webhook-integration для Claude Code принимает и проверяет вебхуки Dodo Payments. Агент настраивает эндпоинт, проверяет подпись и обрабатывает события платежей, подписок и возвратов. CX Codex +1 1 100установок mercadopago Mercado Pago Developer Experience Плагин помогает собирать интеграции Mercado Pago, настраивать вебхуки и проверять безопасность. MCP подключается по запросу, а шаблоны и локальные проверки работают офлайн. ★ 33звёзд репо

Из того же набора39

Весь набор →
replicate-webhooks Скилл replicate-webhooks для Claude Code принимает и проверяет вебхуки Replicate в Express или FastAPI, обрабатывает статусы предсказаний и проверяет HMAC-подпись. CX Codex +1 198установок outpost Скилл outpost помогает спроектировать доставку событий из SaaS или API-платформы в HTTP, SQS, RabbitMQ и другие назначения. CX Codex +1 196установок fusionauth-webhooks Скилл fusionauth-webhooks учит агента принимать вебхуки FusionAuth и сверять JWT-подписи. Помогает настроить валидацию событий авторизации и пользователей в Express или FastAPI. CX Codex +1 196установок chargebee-webhooks Скилл chargebee-webhooks настраивает приём и проверку вебхуков Chargebee через Basic Auth. Помогает обрабатывать события биллинга подписок в Express, Next.js и FastAPI. CX Codex +1 195установок paypal-webhooks Скилл paypal-webhooks для Claude Code принимает и проверяет вебхуки PayPal с подписью RSA-SHA256. Обрабатывает события платежей, подписок и возвратов. CX Codex +1 133установок discord-webhooks Скилл discord-webhooks для Claude Code настраивает приём и проверку исходящих вебхуков Discord. Обрабатывает события и помогает отлаживать ошибки подписи. CX Codex +1 131установок slack-webhooks Скилл slack-webhooks помогает настроить приём вебхуков Slack Events API, пройти проверку url_verification и настроить валидацию подписи запросов. CX Codex +1 128установок twilio-webhooks Скилл twilio-webhooks помогает принимать и проверять вебхуки Twilio, разбирать SMS, звонки и статусы сообщений. Нужен при настройке обработчика или поиске ошибок подписи. CX Codex +1 127установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой