AIKraft/Skills/Вебхуки Clerk

Вебхуки Clerk

Clerk webhooks for real-time events and data syncing. Verify with verifyWebhook from the framework-specific package. Handle user, session, organization, billing, and payment events. Build event-driven features like database sync, notifications, and integrations.

clerk official Данные

Что делает навык

Навык генерирует полные и рабочие обработчики вебхуков Clerk с обязательной верификацией подписи через verifyWebhook(req). Он предназначен для асинхронной синхронизации данных, отправки уведомлений и запуска интеграций по событиям Clerk.

Когда применять

  • Синхронизация базы данных (создание отдельных таблиц пользователей или организаций, следующих за Clerk).
  • Отправка уведомлений (приветственные письма, сообщения в Slack, внутренние оповещения).
  • Запуск интеграций, триггерящихся событиями жизненного цикла.
  • Получение данных о других пользователях или событиях, которые не передаются в токене сессии.

Как работает

  1. Создать маршрут вебхука и сделать его публичным.
  2. Импортировать verifyWebhook(req) из соответствующего пакета фреймворка (например, @clerk/nextjs/webhooks).
  3. Обернуть логику обработчика в вызов verifyWebhook(req), который автоматически читает CLERK_WEBHOOK_SIGNING_SECRET.
  4. Обработать событие (синхронизация БД, уведомления или интеграция).
  5. Убедиться, что верификация выполняется в каждом обработчике, даже для уведомлений, чтобы избежать подделки событий.

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

Создай обработчик вебхука Clerk для Next.js с верификацией подписи.
Напиши функцию для синхронизации пользователей с базой данных при получении вебхука Clerk.
Реализуй маршрут вебхука для отправки приветственных писем при регистрации пользователя.

Что понадобится

  • CLERK_WEBHOOK_SIGNING_SECRET
  • Пакет фреймворка (например, @clerk/nextjs/webhooks или @clerk/express/webhooks)

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «clerk-webhooks» из репозитория: # https://github.com/clerk/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r clerk-webhooks/ ~/.claude/skills/clerk-webhooks/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.