Webhook integration dla deweloperów

SpeedNetworking wysyła outbound webhooks gdy zachodzą zdarzenia w workspace - integracja z Zapier, n8n, custom backendem.

Event types

• event.finished - gdy event zakończony
• mutual_match.created - gdy powstaje mutual match
• subscription.updated - zmiana planu / statusu

Konfiguracja

POST do /api/v1/webhooks/ z payload:

{
  "url": "https://twoja-firma.pl/webhook",
  "events": ["event.finished", "mutual_match.created"]
}

Otrzymasz secret - zachowaj, użyjesz do weryfikacji podpisu.

Format payload

{
  "event": "event.finished",
  "data": {
    "event_id": 42,
    "title": "Networking Q1",
    "mutual_matches_count": 17,
    "...": "..."
  }
}

Signature verification

Każdy POST ma headers:

• X-SpeedNetworking-Event: event.finished
• X-SpeedNetworking-Signature: <hmac-sha256 hex>

Weryfikacja:

import hmac, hashlib
expected = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
if expected != request.headers['X-SpeedNetworking-Signature']:
    return 401

Retry

3 próby z exponential backoff. Wymagamy 2xx odpowiedzi. Po 3 fail status: last_error_message.

Wyłączenie

Przełącznik is_active=false wstrzymuje dostarczenie. Wyłączony webhook nie odbiera zdarzeń.