Zapier-like trigger via webhooks

Budowa prostego workflow trigger -> filter -> action na eventach DarhimLabs.

Kiedy tego uzyc

Uzyj tego przepisu, gdy chcesz: Odebrac event, przefiltrowac go i wywolac akcje w zewnetrznym systemie.

Endpoint referencyjny: POST /webhooks/endpoints.

Implementacja

Node.js

import { DarhimLabs } from "@darhimlabs/node";

const client = new DarhimLabs(process.env.DARHIMLABS_API_KEY!);
if (event.type === 'lead.created' && event.data.score > 70) await pushToCrm(event.data);

Python

import os
from darhimlabs import DarhimLabs

client = DarhimLabs(api_key=os.environ["DARHIMLABS_API_KEY"])
if event['type'] == 'lead.created' and event['data']['score'] > 70:
    push_to_crm(event['data'])

PHP

<?php

$client = new DarhimLabs\Client(["api_key" => $_ENV["DARHIMLABS_API_KEY"]]);
if ($event['type'] === 'lead.created' && $event['data']['score'] > 70) { pushToCrm($event['data']); }

Ruby

client = DarhimLabs::Client.new(api_key: ENV["DARHIMLABS_API_KEY"])
push_to_crm(event.data) if event.type == 'lead.created' && event.data.score > 70

Test it

Wykonaj request w sandboxie z kluczem dl_test_....
Sprawdz X-Request-ID w odpowiedzi.
Dla webhookow uzyj Webhook Playground, zeby zobaczyc payload live.

Common pitfalls

Zawsze zapisuj event_id. To pozwala bezpiecznie ignorowac duplikaty.
Loguj request_id i event_id, zeby support mogl odtworzyc problem.
Dla mutacji dodawaj Idempotency-Key, szczegolnie jesli request moze byc retryowany.

Production checklist

Dodaj retry z exponential backoff i jitterem.
Ogranicz scopes API key do minimalnego zestawu.
Monitoruj rate limit headers i latency P95.
Przetestuj bledy 401, 409, 422 i 429.