breakcold-webhooks
/breakcold-webhooks
Odbiera i weryfikuje webhooki z CRM sprzedaży Breakcold, w tym podpis X-Webhook-Signature i zdarzenia rekordów, notatek i plików.
- Autor
- hookdeck ↗
- Repozytorium
- webhook-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 22
- Skrypty
- 8
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 14
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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/webhooks/breakcold/route.ts, examples/nextjs/lib/breakcold.ts, examples/nextjs/test/webhook.test.ts, examples/nextjs/vitest.config.ts
Co robi i kiedy
Odbiera i weryfikuje webhooki z CRM sprzedaży Breakcold, w tym podpis X-Webhook-Signature i zdarzenia rekordów, notatek i plików.
Oryginalny opis (EN)
Receive and verify Breakcold webhooks (the sales CRM at breakcold.com). Use when setting up a Breakcold outbound webhook handler, debugging X-Webhook-Signature verification, or handling record.created, record.updated, note.created, task.completed, relation.added, call.linked or file.uploaded events.
Jak działa
- When to Use This Skill
- Resources
- Verification (core)
- Common Event Types
- Environment Variables
- Local Development
- Recommended: webhook-handler-patterns
- Related Skills
Podgląd SKILL.md
---
name: breakcold-webhooks
description: >
Receive and verify Breakcold webhooks (the sales CRM at breakcold.com). Use when
setting up a Breakcold outbound webhook handler, debugging X-Webhook-Signature
verification, or handling record.created, record.updated, note.created,
task.completed, relation.added, call.linked or file.uploaded events.
license: MIT
metadata:
author: hookdeck
version: "0.1.0"
repository: https://github.com/hookdeck/webhook-skills
---
# Breakcold Webhooks
Breakcold (breakcold.com) is a sales CRM. Its outbound webhooks send an HTTPS `POST` with a JSON body whenever records, notes, tasks, relations, calls or files change in a workspace.
## When to Use This Skill
- How do I receive Breakcold webhooks?
- How do I verify the Breakcold `X-Webhook-Signature` header?
- Why does my Breakcold webhook signature verification fail?
- How do I handle `record.created`, `note.created` or `task.completed` events?
## Resources
- `references/overview.md` - events, headers, payload envelope, delivery behaviour
- `references/setup.md` - create the outbound webhook and copy the signing secret
- `references/verification.md` - signature details, gotchas, debugging
- `examples/` - runnable Express, Next.js and FastAPI handlers with tests
## Verification (core)
Breakcold signs `{X-Webhook-Timestamp}.{raw body}` with HMAC-SHA256 (lowercase hex) keyed with the endpoint's signing secret, and sends it as `X-Webhook-Signature: sha256=<hex>`.
```javascript
const crypto = require('crypto');
function verifyBreakcoldSignature(rawBody, signatureHeader, timestampHeader, secret) {
if (!signatureHeader || !timestampHeader || !secret) return false;
const digest = signatureHeader.replace(/^sha256=/i, ''); // prefix optional
if (!/^[0-9a-f]{64}$/i.test(digest)) return false; // validate before decoding
const signed = Buffer.concat([
Buffer.from(timestampHeader, 'latin1'), Buffer.from('.'), rawBody, // rawBody is a Buffer
]);
const expected = crypto.createHmac('sha256', secret).update(signed).digest();
return crypto.timingSafeEqual(Buffer.from(digest, 'hex'), expected);
}
```
- Use the **raw body bytes** (`express.raw({ type: '*/*' })`, `await request.arrayBuffer()`, `await request.body()`). Never `JSON.parse` and re-serialize before verifying.
- The secret is a string used as UTF-8 bytes as-is (no hex or base64 decoding).
- Reject with **401** when the signature or timestamp header is missing, malformed or does not match.
- **No timestamp window by default.** Hookdeck retries and replays resend the original `X-Webhook-Timestamp`, so a fixed window rejects legitimate retries. The examples offer an opt-in `BREAKCOLD_WEBHOOK_TOLERANCE_SECONDS` (Unix seconds; unset or `0` = off).
> **For complete handlers with tests**, see [examples/express/](examples/express/), [examples/nextjs/](examples/nextjs/), [examples/fastapi/](examples/fastapi/).
## Common Event Types
Dispatch on the body's `event` field (also sent as `X-Webhook-Event`).
| Event | Fires when |
|-------|------------|
| `record.created` / `record.updated` / `record.deleted` | A record is created, a field changes, or it is deleted |
| `note.created` / `note.updated` / `note.deleted` | A note is added to, edited on, or removed from a record |
| `task.created` / `task.completed` | A task is linked to a record, or marked complete |
| `relation.added` / `relation.removed` | A relation between records is added or removed |
| `call.linked` / `call.unlinked` | A call recording is linked to or unlinked from a record |
| `file.uploaded` / `file.deleted` | A file is added to or removed from a record |
| `webhook.test` | You press the endpoint's test button |
Use `X-Webhook-Delivery-Id` for idempotency. Any `2xx` accepts a delivery; Breakcold makes up to 3 attempts (retries after about 5 s and 30 s), times out after 10 s, and disables an endpoint after 50 consecutive failures.
## Environment Variables
```bash
BREAKCOLD_WEBHOOK_SECRET=your_breakcold_signing_secret
# Optional. Unset or 0 = no timestamp check.
BREAKCOLD_WEBHOOK_TOLERANCE_SECONDS=300
```
## Local Development
```bash
npx hookdeck-cli listen 3000 breakcold --path /webhooks/breakcold
```
No account required. Use `8000` instead of `3000` for FastAPI.
## Recommended: webhook-handler-patterns
Install [webhook-handler-patterns](https://github.com/hookdeck/webhook-skills/tree/main/skills/webhook-handler-patterns) alongside this skill:
- [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)
- [Retry logic](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/retry-logic.md)
## Related Skills
- [hubspot-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/hubspot-webhooks) - HubSpot CRM webhooks
- [pipedrive-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/pipedrive-webhooks) - Pipedrive CRM webhooks
- [salesforce-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/salesforce-webhooks) - Salesforce outbound events
- [attio-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/attio-webhooks) - Attio CRM webhooks
- [instantly-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/instantly-webhooks) - Sales outreach webhooks
- [cronofy-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/cronofy-webhooks) - Scheduling webhooks
- [webhook-handler-patterns](https://github.com/hookdeck/webhook-skills/tree/main/skills/webhook-handler-patterns) - Idempotency, error handling, retry logic
- [hookdeck-event-gateway](https://github.com/hookdeck/webhook-skills/tree/main/skills/hookdeck-event-gateway) - Production webhook infrastructure
Pliki w paczce (22)
- SKILL.md 6 KB
- examples/express/.env.example 1 KB
- examples/express/README.md 2 KB
- examples/express/package.json 1 KB
- examples/express/src/index.js 6 KB
- examples/express/test/webhook.test.js 8 KB
- examples/fastapi/.env.example 1 KB
- examples/fastapi/README.md 2 KB
- examples/fastapi/main.py 6 KB
- examples/fastapi/requirements.txt 1 KB
- examples/fastapi/test_webhook.py 7 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/vitest.config.ts 1 KB
- examples/nextjs/app/webhooks/breakcold/route.ts 4 KB
- examples/nextjs/lib/breakcold.ts 2 KB
- examples/nextjs/test/webhook.test.ts 8 KB
- references/overview.md 4 KB
- references/setup.md 1 KB
- references/verification.md 4 KB
Wersje
W bazie nie ma innych skilli o nazwie breakcold-webhooks.
Migawka bazy z 13.11.2026 · wersja paczki 5ae5613af25b (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
- 100outreach-webhooks
Odbiera i weryfikuje webhooki Outreach, w tym podpis Outreach-Webhook-Signature oraz zdarzenia prospect.created, sequenceState.created, call.created i task.completed. - 100seatable-webhooks
Odbiera i weryfikuje webhooki SeaTable, w tym podpis X-Seatable-Signature i zdarzenia zmian bazy (insert_row, modify_row, delete_row).