Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

survicate-webhooks

/survicate-webhooks

Odbiera i weryfikuje webhooki Survicate o odpowiedziach i zakończonych ankietach, sprawdzając podpis HMAC.

Repozytorium
webhook-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
25
Skrypty
8
Komentarze HTML
0
Adresy URL w SKILL.md
12
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 8 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: examples/express/src/index.js, examples/express/test/webhook.test.js, examples/fastapi/main.py, examples/fastapi/test_webhook.py, examples/nextjs/app/lib/webhook.ts, examples/nextjs/app/webhooks/survicate/route.ts, examples/nextjs/test/webhook.test.ts, examples/nextjs/vitest.config.ts

Co robi i kiedy

Odbiera i weryfikuje webhooki Survicate o odpowiedziach i zakończonych ankietach, sprawdzając podpis HMAC.

Oryginalny opis (EN)

Receive and verify Survicate webhooks. Use when configuring Survicate webhook endpoints, debugging hmac signatures, or handling questionAnswered, surveyCompleted.

Jak działa

  1. When to Use This Skill
  2. Setup
  3. Verification (core)
  4. Event Handling
  5. Local Development
  6. Resources
  7. Recommended: webhook-handler-patterns
  8. Related Skills
Sekcje z nagłówków SKILL.md, w oryginale · 68 linii, 352 słów
Podgląd SKILL.md
---
name: survicate-webhooks
description: >
  Receive and verify Survicate webhooks. Use when configuring Survicate webhook
  endpoints, debugging hmac signatures, or handling questionAnswered, surveyCompleted.
license: MIT
metadata:
  author: hookdeck
  version: "0.1.0"
  repository: https://github.com/hookdeck/webhook-skills
---

# Survicate Webhooks

Receive Survicate question answers and completed surveys.

## When to Use This Skill

- Configure a receiver for Survicate webhook deliveries.
- Diagnose `hmac` verification failures.
- Handle `questionAnswered`, `surveyCompleted`.

## Setup

Copy the workspace Signing Secret from Survicate Webhooks Settings. In the survey's Connect tab, configure the webhook URL and choose questionAnswered or surveyCompleted. Use Send sample request to test. The separate Verification Token is sent in plaintext and is not used by this HMAC verifier.

Set `SURVICATE_WEBHOOK_SECRET` in the server environment. Read [setup](references/setup.md) before enabling delivery.

## Verification (core)

`hmac` contains a bare hex digest over the raw body. Use HMAC-SHA256 with the secret's UTF-8 bytes. Verify the original bytes before parsing JSON. Validate the digest format, then compare equal-length buffers in constant time.

After extracting the documented digest and constructing `message` as described in [verification](references/verification.md), the comparison is:

```javascript
const expected = crypto.createHmac('sha256', secret).update(message).digest();
if (digest.length !== 64 || !/^[0-9a-fA-F]{64}$/.test(digest)) return false;
const received = Buffer.from(digest, 'hex');
return received.length === expected.length && crypto.timingSafeEqual(received, expected);
```

No timestamp is included in the signed message. These examples do not invent an age check from unsigned fields.

Complete handlers and tests: [Express](examples/express/), [Next.js](examples/nextjs/), [FastAPI](examples/fastapi/).

## Event Handling

The envelope is {messageId, deliveryTries, event: {questionAnswered: {...}}} or the corresponding surveyCompleted key. Dispatch on keys inside event, not on event as a string. The receiver guards each nested value before use.

Use messageId when deduplicating deliveries. Acknowledge accepted events and avoid logging survey answers or personal data.

## Local Development

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

Use port 8000 for FastAPI. The CLI provides a local tunnel and inspection UI; no account is required to start.

## Resources

- [Overview and event routing](references/overview.md)
- [Endpoint and secret setup](references/setup.md)
- [Verification and troubleshooting](references/verification.md)

## Recommended: webhook-handler-patterns

Use the patterns skill for [handler sequence](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/handler-sequence.md), [idempotency](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/idempotency.md), [error handling](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/error-handling.md) and [retry logic](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/retry-logic.md).

## Related Skills

- [stripe-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/stripe-webhooks): another HMAC receiver.
- [github-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/github-webhooks): another HMAC receiver.
- [shopify-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/shopify-webhooks): another HMAC receiver.
- [gitbook-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/gitbook-webhooks): another HMAC receiver.
- [preczn-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/preczn-webhooks): another HMAC receiver.
- [webhook-handler-patterns](https://github.com/hookdeck/webhook-skills/tree/main/skills/webhook-handler-patterns): delivery and processing patterns.
- [hookdeck-event-gateway](https://github.com/hookdeck/webhook-skills/tree/main/skills/hookdeck-event-gateway): managed delivery and inspection.
Pliki w paczce (25)
  • SKILL.md 4 KB
  • examples/express/.env.example 1 KB
  • examples/express/README.md 1 KB
  • examples/express/package.json 1 KB
  • examples/express/vector.json 1 KB
  • examples/express/src/index.js 3 KB
  • examples/express/test/webhook.test.js 6 KB
  • examples/fastapi/.env.example 1 KB
  • examples/fastapi/README.md 2 KB
  • examples/fastapi/main.py 2 KB
  • examples/fastapi/requirements.txt 1 KB
  • examples/fastapi/test_webhook.py 6 KB
  • examples/fastapi/vector.json 1 KB
  • examples/nextjs/.env.example 1 KB
  • examples/nextjs/README.md 2 KB
  • examples/nextjs/package.json 1 KB
  • examples/nextjs/tsconfig.json 1 KB
  • examples/nextjs/vector.json 1 KB
  • examples/nextjs/vitest.config.ts 1 KB
  • examples/nextjs/app/lib/webhook.ts 2 KB
  • examples/nextjs/app/webhooks/survicate/route.ts 1 KB
  • examples/nextjs/test/webhook.test.ts 6 KB
  • references/overview.md 1 KB
  • references/setup.md 2 KB
  • references/verification.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie survicate-webhooks.

Migawka bazy z 13.11.2026 · wersja paczki 38b05d266306 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100jobber-webhooks
    Odbiera i weryfikuje webhooki Jobbera, sprawdzając podpis X-Jobber-Hmac-SHA256 i zdarzenia klientów, faktur oraz połączeń aplikacji.
  • 100bugsmash-webhooks
    Odbiera i weryfikuje webhooki BugSmash, sprawdzając podpis HMAC i obsługując zdarzenia komentarzy oraz statusów.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.