Вебхуки 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.
AIclerk
official
Данные
Что делает навык
Навык генерирует полные и рабочие обработчики вебхуков Clerk с обязательной верификацией подписи через verifyWebhook(req). Он предназначен для асинхронной синхронизации данных, отправки уведомлений и запуска интеграций по событиям Clerk.
Когда применять
- Синхронизация базы данных (создание отдельных таблиц пользователей или организаций, следующих за Clerk).
- Отправка уведомлений (приветственные письма, сообщения в Slack, внутренние оповещения).
- Запуск интеграций, триггерящихся событиями жизненного цикла.
- Получение данных о других пользователях или событиях, которые не передаются в токене сессии.
Как работает
- Создать маршрут вебхука и сделать его публичным.
- Импортировать verifyWebhook(req) из соответствующего пакета фреймворка (например, @clerk/nextjs/webhooks).
- Обернуть логику обработчика в вызов verifyWebhook(req), который автоматически читает CLERK_WEBHOOK_SIGNING_SECRET.
- Обработать событие (синхронизация БД, уведомления или интеграция).
- Убедиться, что верификация выполняется в каждом обработчике, даже для уведомлений, чтобы избежать подделки событий.
Примеры запросов агенту
Создай обработчик вебхука 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 и совместимые) подхватывает его по описанию и следует шагам.