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

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

Скилл fireflies-webhooks-events проводит агента по сборке приёмника Fireflies Webhooks V2: проверка HMAC по сырому телу, белый список событий, дедупликация и быстрый ответ 2xx.

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

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

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

Скилл разбирает приёмную сторону Fireflies Webhooks V2: что проверять до парсинга JSON, как отсекать неизвестные события и не выполнять работу дважды при повторной доставке. Внутри — порядок из семи шагов, начиная с подписки на одобренные типы событий на HTTPS-эндпоинте и проверки X-Hub-Signature в формате sha256=<hex HMAC> по сырым байтам.

Подпись считается по сырому телу, поэтому читать поток как JSON раньше времени нельзя. Документированы события meeting.transcribed и meeting.summarized; в payload есть event, timestamp, meeting_id и необязательный client_reference_id. Fireflies ждёт 2xx в течение 10 секунд, поэтому скилл советует сначала подтвердить приём, а данные забрать асинхронно.

Ключи идут отдельным блоком: FIREFLIES_API_KEY берётся из хранилища секретов и уходит только в заголовке Authorization: Bearer на https://api.fireflies.ai/graphql. Секрет подписи вебхука хранится отдельно и не заменяет API-ключ. Живая работа требует сетевого доступа. Операции вроде подписки на события всей команды или выгрузки транскрипта после события скилл останавливает до подтверждения.

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

  • Проверить подпись X-Hub-Signature по сырому телу до парсинга JSON
  • Отсеять неизвестные события в карантин, не достраивая схему
  • Сделать обработчик идемпотентным при повторной доставке
  • Пережить приход meeting.summarized раньше meeting.transcribed
  • Уложить ответ 2xx в 10 секунд и вынести обработку в фон

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

  • Разбери приёмник вебхуков Fireflies V2 в apps/webhooks, начни с проверки подписи и дедупликации.
  • Проверь, как у нас валидируется X-Hub-Signature, и покажи, где JSON парсится раньше проверки.
  • Добавь обработку meeting.summarized с идемпотентностью по meeting_id, scope — только этот обработчик.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

Выполните npx skills add jeremylongshore/tons-of-skills-marketplace --skill fireflies-webhooks-events -a claude-code. Скилл появится по пути ~/.claude/skills/fireflies-webhooks-events/SKILL.md.

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

Проводит агента по сборке приёмника Fireflies Webhooks V2: проверка HMAC по сырым байтам, белый список событий, дедупликация, терпимость к порядку доставки и быстрый ответ 2xx.

Нужен ли ключ Fireflies для работы скилла?

Для живых запросов нужен FIREFLIES_API_KEY из хранилища секретов: он уходит только в заголовке Authorization: Bearer на https://api.fireflies.ai/graphql. Секрет подписи вебхука — отдельный креденшел, и сетевой доступ обязателен.

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

SKILL.md · MIT
---
name: fireflies-webhooks-events
description: >-
  Implement a current Fireflies Webhooks V2 consumer with raw-body HMAC verification, event allowlisting, idempotency, ordering tolerance, and fast acknowledgement. Use when performing meeting lifecycle automation. Trigger with "Fireflies webhook v2", "meeting.transcribed event", or "verify Fireflies signature".
allowed-tools: Read,Glob,Grep,Write,Edit
argument-hint: "<repository-path> <workflow-scope>"
version: 1.12.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags: [saas, fireflies, webhooks, events]
model: inherit
effort: high
compatibility: "Designed for Claude Code; live Fireflies work requires network access"
---
# Fireflies Webhooks V2 Consumer

## Overview

Implement a current Fireflies Webhooks V2 consumer with raw-body HMAC verification, event allowlisting, idempotency, ordering tolerance, and fast acknowledgement.

## Prerequisites

- The target repository or integration path and the requested operator outcome.
- The Fireflies principal, team, environment, and data classification for the work.
- Current Fireflies documentation, credentials only when needed, and an accountable approver.

## Current Contract

V2 payloads contain event, timestamp, meeting_id, and optional client_reference_id. Documented events include meeting.transcribed and meeting.summarized. X-Hub-Signature is sha256=<hex HMAC> over the raw body; valid deliveries need a 2xx response within 10 seconds.

## Authentication

For authenticated operations, inject `FIREFLIES_API_KEY` from an approved secret manager and send it only as `Authorization: Bearer REDACTED_KEY` to `https://api.fireflies.ai/graphql`. Never print, commit, place in a URL, forward to a browser, or include the key in evidence. Webhook signing secrets are separate credentials and must not be reused as API keys.

## Instructions

1. Subscribe only to approved V2 event types at an HTTPS endpoint.
2. Capture raw bytes and validate the signature format and timing-safe HMAC before JSON parsing.
3. Validate event, timestamp, meeting_id, and optional client reference against a strict schema.
4. Reject unknown events or route them to a quarantined metadata-only lane.
5. Deduplicate using delivery metadata plus event and meeting identity, and tolerate summarized arriving after transcribed.
6. Acknowledge quickly, then fetch authorized data asynchronously if needed.
7. Record signature result, event type, latency, dedupe outcome, and job ID without payload content.

## Tool Discipline

Use Read, Glob, and Grep to inspect code, configuration, tests, and evidence. Use Write/Edit only for approved implementation or documentation changes. Do not query Fireflies, retrieve meeting content, create an AskFred thread, upload media, change account state, replay an event, or deploy merely because this skill was invoked.

## Approval Boundaries

Require approval before subscribing to team-wide events, fetching transcript content after an event, replaying a delivery, or retaining payloads.

## Output

Return the exact operation or event surface, environment, authorization class, selected field groups, validation results, content-free metrics, decisions, and a concise pass/fail receipt. Keep secrets and meeting-derived content out of general output.

## Validation

Before reporting success, rerun the smallest relevant deterministic check, compare actual state with the requested outcome and current contract, verify no secret or meeting-derived content entered logs or artifacts, and record unresolved uncertainty explicitly.

## Error Handling

- Missing signature when verification is configured: return 401.
- Duplicate delivery: acknowledge without repeating side effects.
- Unknown event: quarantine metadata and do not infer a schema.

## Examples

- "Review fireflies webhooks v2 consumer" produces a bounded plan and redacted receipt.
- A request that widens access or mutates production is paused at the approval boundary.

## Resources

Read [official Fireflies.ai evidence](references/official-docs.md) before relying on a field, filter, event, permission, plan limit, mutation, or processing state.

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

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

Все скиллы по теме «Бэкенд и API» →
inngest-events inngest Скилл inngest-events помогает проектировать событийные воркфлоу Inngest: имена событий, идемпотентность по id, fan-out и системные события. CX Codex +1 4 000установок rc-webhooks RevenueCat Скилл rc-webhooks помогает подключить RevenueCat Webhooks к серверу: проверяет запросы, разбирает события и обновляет доступ через повторное чтение клиента. CX Codex +1 785установок webhook-engineer VoltAgent Community Субагент webhook-engineer проектирует приём и отправку вебхуков с проверкой HMAC-подписей, дедупликацией событий и защитой от сбоев доставки. CX Codex ★ 26 718звёзд репо vtex-io-events-and-workers vtex Скилл vtex-io-events-and-workers для Claude Code учит агента писать в VTEX IO обработчики событий и воркеры с защитой от повторной доставки. Выносит тяжёлую работу из HTTP-роутов в фоновые задачи. CX Codex +1 1 200установок github-webhooks hookdeck Скилл github-webhooks для приёма и проверки вебхуков GitHub: подсказывает, как разобрать подпись и обработать события push, pull_request, issues и release. CX Codex +1 512установок shopify-webhooks hookdeck Скилл shopify-webhooks принимает и проверяет вебхуки Shopify: подпись HMAC-SHA256 в base64, события заказов, товаров и клиентов. Нужен API-секрет приложения. CX Codex +1 291установок

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

Весь набор →
long-polling-handler Автоматически помогает разбирать задачи long polling handler в API-интеграциях, писать конфигурации и проверять результат. CX Codex +1 1установок emitting-api-events Скилл emitting-api-events для проектирования событийно-ориентированных API. Добавляет вебхуки, Server-Sent Events и интеграцию с брокерами сообщений в существующий бэкенд. CX Codex +1 1установок maintainx-webhooks-events Скилл maintainx-webhooks-events настраивает приём вебхуков MaintainX и обработку событий рабочих заказов в Express. Помогает связать обновления ТОиР с внешними сервисами. CX Codex +1 1установок lindy-webhooks-events Скилл lindy-webhooks-events для Claude Code подключает вебхук-триггеры Lindy AI и обратные вызовы приложения. Проверяет события, ставит их в очередь и обрабатывает повторные запросы. CX Codex +1 1установок documenso-webhooks-events Скилл documenso-webhooks-events помогает настроить приём вебхуков сервиса Documenso. Пригодится при отслеживании подписания документов и передаче статусов во внешние сервисы. CX Codex +1 1установок 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установок

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

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