> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Własny Webhook

> Wysyłaj dane o leadach do dowolnego CRM lub zewnętrznego systemu przez HTTP

## Przegląd

Własny Webhook to najprostsza integracja — wysyła żądania HTTP na dowolny podany URL. Użyj go, aby przesyłać dane o leadach do CRM, uruchamiać automatyzacje w Zapier/Make lub łączyć się z dowolnym systemem posiadającym API.

Bez OAuth, bez SDK — wystarczy docelowy URL i opcjonalne nagłówki.

## Konfiguracja

<Steps>
  <Step title="Dodaj integrację">
    Przejdź do **Integracje** → **Dodaj integrację** → wybierz **Własny Webhook** z kategorii CRM.
  </Step>

  <Step title="Konfiguracja">
    | Pole               | Wymagane | Opis                                                                        |
    | ------------------ | -------- | --------------------------------------------------------------------------- |
    | **Webhook URL**    | Tak      | Endpoint, na który mają być wysyłane dane                                   |
    | **Webhook Secret** | Nie      | Sekret do podpisywania żądań HMAC-SHA256                                    |
    | **Headers**        | Nie      | Niestandardowe nagłówki HTTP (format JSON, np. `Authorization: Bearer ...`) |
  </Step>

  <Step title="Test">
    Kliknij **Testuj połączenie**. Revol wysyła testowy payload i weryfikuje, czy URL odpowiada statusem 2xx.
  </Step>
</Steps>

## Narzędzia agenta

| Narzędzie         | Opis                                                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `send_payload`    | Wyślij strukturalne dane JSON (informacje o leadzie, dane formularza) na URL webhooka. Podpisane HMAC-SHA256, jeśli skonfigurowano sekret. |
| `test_connection` | Sprawdź, czy URL webhooka jest osiągalny i odpowiada poprawnie                                                                             |

## Format payloadu

Gdy agent wywołuje `send_payload`, Revol wysyła żądanie POST z treścią JSON. Zawartość jest określana przez agenta AI na podstawie informacji zebranych podczas rozmowy:

```json theme={null}
{
  "event": "lead_captured",
  "timestamp": "2026-03-07T14:30:00Z",
  "company_id": 5,
  "agent_id": 12,
  "conversation_id": "conv_abc123",
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+380501234567",
    "message": "Interested in Enterprise plan",
    "source": "website_widget",
    "utm_campaign": "spring_promo"
  }
}
```

## Podpisywanie żądań

Jeśli podasz **Webhook Secret**, każde żądanie jest podpisywane HMAC-SHA256:

* Podpis jest dołączany w nagłówku `X-Webhook-Signature`
* Zweryfikuj go na swoim serwerze, obliczając `HMAC-SHA256(request_body, your_secret)` i porównując wynik

## Używanie w węzłach workflow

Narzędzia webhooka działają jak każde inne narzędzie agenta:

1. Połącz integrację webhooka i przetestuj URL
2. Narzędzia pojawią się w zakładce **Narzędzia** agenta
3. Dodaj `send_payload` do **węzła niestandardowego** w edytorze workflow
4. LLM decyduje, kiedy wysłać dane na podstawie kontekstu rozmowy

**Przykładowy workflow:** Agent zbiera informacje o leadzie (imię, e-mail, telefon, zainteresowanie) → po zakończeniu rozmowy używa `send_payload`, aby przesłać dane do Twojego CRM.

## Przypadki użycia

* **Integracja z CRM** — Przesyłaj kwalifikowane leady do Pipedrive, HubSpot, Salesforce lub dowolnego CRM z endpointem webhook/API
* **Zapier / Make** — Uruchamiaj wieloetapowe automatyzacje na podstawie zdarzeń z rozmów
* **Slack / Discord** — Wysyłaj powiadomienia, gdy przechwycone zostaną wartościowe leady
* **Własny backend** — Wywołuj własne API, aby tworzyć zamówienia, aktualizować rekordy lub uruchamiać wewnętrzne procesy
* **Analityka** — Wysyłaj wyniki rozmów do hurtowni danych