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

posthog-webhooks-events — скилл для Claude Code

Скилл posthog-webhooks-events создаёт вебхук-назначения PostHog через API, принимает их payload и делает ограниченные запросы к событиям через private API или HogQL.

MIT 1 установок ★ 2 935 обновлён 2026-10-29

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

Что делает posthog-webhooks-events

Скилл ведёт от настройки назначения до разбора событий. Первый шаг — curl на pipeline_destinations/ в API проекта: регистрируется Destination с URL, методом, заголовками и шаблоном тела, а фильтр перечисляет нужные события, например user_signed_up и subscription_started.

Дальше идёт приёмка. Пример обработчика сверяет секрет из заголовка, разбирает payload и раскладывает его по функциям конкретных событий. Для разбора данных скилл показывает выборку через events/ с limit и orderBy и запросы HogQL на /query/ — воронка по реферерам, использование фич в разрезе тарифов.

Заранее нужны проект PostHog с персональным ключом phx_..., HTTPS-эндпоинт и уже собираемые события. В Bash разрешён только curl, поэтому проверка идёт запросами, а не тестами: логику обработчика придётся прогонять самому.

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

  • Создать вебхук-назначение PostHog на выбранные события через API
  • Принять payload вебхука и разложить его по обработчикам
  • Выбрать последние события одного типа через private API
  • Посчитать воронку регистраций по реферерам на HogQL
  • Посмотреть, как фичи расходятся по тарифам

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

  • Настрой PostHog destination для user_signed_up: вебхук на https://your-app.com/webhooks/posthog
  • Напиши обработчик вебхука PostHog с проверкой секрета в заголовке и switch по именам событий
  • Собери HogQL-запрос: регистрации за 30 дней в разрезе рефереров

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

1Через Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill posthog-webhooks-events -a claude-code

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

~/.claude/skills/posthog-webhooks-events/SKILL.md

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

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

Вопросы о posthog-webhooks-events

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

Выполни npx skills add jeremylongshore/tons-of-skills-marketplace --skill posthog-webhooks-events -a claude-code, затем файл скилла окажется по пути ~/.claude/skills/posthog-webhooks-events/SKILL.md.

Что делает posthog-webhooks-events?

Помогает собрать PostHog Destination через API, принять и обработать входящие вебхуки, а также запросить события через private API или HogQL.

Что нужно для работы скилла?

Проект PostHog с персональным ключом phx_..., HTTPS-эндпоинт для приёма вебхуков и события, которые уже собираются в проекте.

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

SKILL.md · MIT
---
name: posthog-webhooks-events
description: |
  Build and verify PostHog realtime webhook destinations and bounded private-API or HogQL event queries. Use when delivering selected events to another system or investigating event data. Trigger with "PostHog webhook", "PostHog destination", or "PostHog HogQL query".
argument-hint: "[project] [destination-or-query]"
allowed-tools: Read, Write, Edit, Bash(curl:*)
version: 1.14.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags:
- saas
- posthog
- webhooks
compatibility: Designed for Claude Code
---
# PostHog Webhooks & Events

## Overview

PostHog sends webhooks via its CDP (Customer Data Platform) Destinations feature. You configure a Destination that fires when matching events are captured, sending an HTTP POST to your endpoint. This skill covers webhook destination setup, receiving and processing webhook payloads, querying events via the API, and using HogQL for custom event analysis.

## Prerequisites

- PostHog project with personal API key (`phx_...`)
- HTTPS endpoint to receive webhooks
- Events being captured in PostHog

## Instructions

### Tool discipline

Use `Read` to inspect the relevant configuration and implementation before proposing changes. Use `Write` only for a new, explicitly requested artifact inside the target project. Use `Edit` for minimal changes to existing project files after the evidence pass.

### Step 1: Create a Webhook Destination via API

```bash
set -euo pipefail
# Create a webhook destination that fires on specific events
curl -X POST "https://us.posthog.com/api/projects/$POSTHOG_PROJECT_ID/pipeline_destinations/" \
  -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Signup Notifications",
    "description": "Send webhook when user signs up",
    "config": {
      "url": "https://your-app.com/webhooks/posthog",
      "method": "POST",
      "headers": {
        "X-Webhook-Secret": "your-webhook-secret"
      },
      "body": {
        "event": "{event}",
        "distinct_id": "{distinct_id}",
        "person": "{person}",
        "properties": "{properties}",
        "timestamp": "{timestamp}"
      }
    },
    "filters": {
      "events": [
        {"id": "user_signed_up", "type": "events"},
        {"id": "subscription_started", "type": "events"}
      ]
    }
  }'
```

### Step 2: Receive and Process Webhooks

```typescript
// api/webhooks/posthog.ts
import { NextResponse } from 'next/server';
import crypto from 'crypto';

const WEBHOOK_SECRET = process.env.POSTHOG_WEBHOOK_SECRET!;

// Verify webhook authenticity
function verifySignature(payload: string, signature: string): boolean {
  const expected = crypto.createHmac('sha256', WEBHOOK_SECRET)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

interface PostHogWebhookPayload {
  event: string;
  distinct_id: string;
  properties: Record<string, any>;
  person: {
    properties: Record<string, any>;
  };
  timestamp: string;
}

export async function POST(request: Request) {
  const body = await request.text();
  const signature = request.headers.get('x-webhook-secret') || '';

  // Verify webhook is from PostHog
  if (WEBHOOK_SECRET && signature !== WEBHOOK_SECRET) {
    return NextResponse.json({ error: 'Invalid signature' }, { status: 401 });
  }

  const payload: PostHogWebhookPayload = JSON.parse(body);

  // Route to handlers based on event type
  switch (payload.event) {
    case 'user_signed_up':
      await onUserSignup(payload);
      break;
    case 'subscription_started':
      await onSubscriptionStarted(payload);
      break;
    case 'subscription_canceled':
      await onSubscriptionCanceled(payload);
      break;
    default:
      console.log(`Unhandled PostHog event: ${payload.event}`);
  }

  return NextResponse.json({ received: true });
}

async function onUserSignup(payload: PostHogWebhookPayload) {
  const { distinct_id, properties, person } = payload;
  console.log(`New signup: ${distinct_id}`);

  // Sync to CRM
  await fetch('https://api.hubspot.com/contacts/v1/contact/', {
    method: 'POST',
    headers: { Authorization: `Bearer ${process.env.HUBSPOT_KEY}` },
    body: JSON.stringify({
      properties: [
        { property: 'email', value: person.properties.email },
        { property: 'posthog_id', value: distinct_id },
      ],
    }),
  });

  // Notify Slack
  await fetch(process.env.SLACK_WEBHOOK_URL!, {
    method: 'POST',
    body: JSON.stringify({
      text: `New signup: ${person.properties.email || distinct_id} (${properties.source || 'unknown'})`,
    }),
  });
}

async function onSubscriptionStarted(payload: PostHogWebhookPayload) {
  console.log(`New subscription: ${payload.distinct_id}, plan: ${payload.properties.plan}`);
}

async function onSubscriptionCanceled(payload: PostHogWebhookPayload) {
  console.log(`Cancellation: ${payload.distinct_id}`);
}
```

### Step 3: Query Events via the API

```bash
set -euo pipefail
# List recent events by type
curl "https://us.posthog.com/api/projects/$POSTHOG_PROJECT_ID/events/?event=user_signed_up&limit=10&orderBy=-timestamp" \
  -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" | \
  jq '.results[] | {
    distinct_id,
    event,
    timestamp,
    properties: (.properties | {source, plan, referrer: ."$referrer"})
  }'

# Get events for a specific person
curl "https://us.posthog.com/api/projects/$POSTHOG_PROJECT_ID/events/?distinct_id=user-123&limit=20" \
  -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" | \
  jq '.results[] | {event, timestamp}'
```

### Step 4: Query Events with HogQL

```typescript
// Complex event analysis with HogQL (PostHog's SQL dialect)
async function queryPostHog(hogql: string) {
  const response = await fetch(
    `https://us.posthog.com/api/projects/${process.env.POSTHOG_PROJECT_ID}/query/`,
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        Authorization: `Bearer ${process.env.POSTHOG_PERSONAL_API_KEY}`,
      },
      body: JSON.stringify({
        query: { kind: 'HogQLQuery', query: hogql },
      }),
    }
  );
  return response.json();
}

// Example: Signup funnel analysis
const funnelData = await queryPostHog(`
  SELECT
    properties.$referrer AS referrer,
    count() AS signups,
    uniq(distinct_id) AS unique_users
  FROM events
  WHERE event = 'user_signed_up'
    AND timestamp > now() - interval 30 day
  GROUP BY referrer
  ORDER BY signups DESC
  LIMIT 20
`);

// Example: Feature adoption by plan
const adoptionData = await queryPostHog(`
  SELECT
    person.properties.plan AS plan,
    properties.feature_name AS feature,
    count() AS usage_count,
    uniq(distinct_id) AS unique_users
  FROM events
  WHERE event = 'feature_used'
    AND timestamp > now() - interval 7 day
  GROUP BY plan, feature
  ORDER BY usage_count DESC
  LIMIT 50
`);
```

### Step 5: Set Up Slack Webhook Destination (UI)

PostHog has built-in Slack integration via Data Pipelines > Destinations:

1. Go to Data Pipelines > Destinations > New Destination
2. Select "Slack" or "Webhook"
3. Configure event filters (which events trigger the notification)
4. Set the webhook URL and message template
5. Test with a sample event

## Error Handling

| Issue | Cause | Solution |
|-------|-------|----------|
| Webhook not firing | No matching destination filter | Check event name matches filter exactly |
| Duplicate webhooks | Event matches multiple destinations | Narrow destination filters |
| Webhook timeout | Handler too slow | Acknowledge with 200 immediately, process async |
| HogQL query timeout | Unfiltered table scan | Add `timestamp >` filter and `LIMIT` |
| 429 on events API | Too many queries | Cache results, reduce polling frequency |

## Output

- Webhook destination configured for specific events
- Express/Next.js webhook handler with event routing
- Event queries via REST API and HogQL
- Slack/CRM integration on user lifecycle events

## Examples

For a webhook destination, define the filtered event set, minimal payload, receiver authentication, idempotency key, retry behavior, and response logging; then use the built-in test flow before enabling it. For queries, use the regional private API with a scoped credential and a bounded time range.

## Resources

See [official PostHog references](references/official-docs.md) for current authority and verification boundaries.

- [PostHog CDP Destinations](https://posthog.com/docs/cdp/destinations)
- [PostHog Webhook Destination](https://posthog.com/docs/cdp/destinations/webhook)
- [PostHog Events API](https://posthog.com/docs/api/events)
- [HogQL Documentation](https://posthog.com/docs/sql)

## Next Steps

For deployment setup, see `posthog-deploy-integration`.

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

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

Все скиллы по теме «Бэкенд и API» →
querying-posthog-data PostHog Скилл querying-posthog-data объясняет агенту, как правильно запрашивать данные PostHog: типизированные инструменты для аналитики и HogQL/SQL, когда без него не обойтись. CX Codex +1 890установок seo-posthog AgriciDaniel Скилл seo-posthog для Claude Code выгружает данные органического трафика и посадочных страниц через PostHog MCP. Запускается при запросе аналитики сайта без GA4. CX Codex +1 141установок posthog официальный PostHog Inc. Анализирует данные продукта и управляет фиче-флагами, экспериментами или трекингом ошибок в PostHog прямо из диалога с агентом. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо copying-endpoints-across-projects PostHog Скилл copying-endpoints-across-projects копирует эндпоинты PostHog между проектами одной организации или дублирует их под новым именем. Помогает переносить HogQL-запросы без ручной перепечатки. CX Codex +1 183установок posthog-analytics alinaqi Скилл posthog-analytics для Claude Code помогает добавить в продукт аналитику PostHog, события и флаги функций. Подключается при работе с отслеживанием действий пользователей. CX Codex +1 827установок posthog-automation davepoon Скилл posthog-automation для Claude Code автоматизирует работу с PostHog через Rube MCP: отправляет события и управляет feature-флагами, проектами, профилями пользователей и аннотациями. CX Codex +1 121установок

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

Весь набор →
windsurf-webhooks-events Скилл windsurf-webhooks-events для Claude Code создаёт расширения Windsurf на основе VS Code API и отправляет события рабочей области во внешнюю систему. Отслеживает сохранения, смену редактора и вывод терминала. CX Codex +1 1установок twinmind-webhooks-events Скилл twinmind-webhooks-events для обработки событий встреч TwinMind: завершение транскрипции, извлечение задач, уведомления о синхронизации календаря. CX Codex +1 1установок firecrawl-webhooks-events Скилл firecrawl-webhooks-events настраивает приём вебхуков Firecrawl: валидацию подписи HMAC-SHA256, дедупликацию и синхронизацию статусов. CX Codex +1 1установок coderabbit-webhooks-events Скилл coderabbit-webhooks-events помогает спроектировать автоматизацию вокруг событий Git-провайдера, связанных с ревью CodeRabbit. Он пригодится для проверки подписей, фильтрации событий и безопасного тестирования обработчика. CX Codex +1 1установок instantly-webhooks-events Скилл instantly-webhooks-events помогает развернуть надёжный приёмник вебхуков Instantly API v2 с валидацией схем, дедупликацией событий и защитой секретов. CX Codex +1 1установок windsurf-data-handling Скилл windsurf-data-handling помогает описать потоки данных, настроить исключения контекста и собрать подтверждения для проверок приватности и соответствия. CX Codex +1 1установок windsurf-flows-automation Скилл windsurf-flows-automation для Claude Code создаёт и сопровождает Windsurf Flows — автоматизированные сценарии повторяющихся задач разработки. Превращает рутину в команды. CX Codex +1 1установок lindy-core-workflow-b Скилл lindy-core-workflow-b для Claude Code описывает настройку триггеров, расписаний и связок агентов в Lindy. Задаёт сценарии сборки автономных рабочих процессов. CX Codex +1 1установок

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

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