API Reference

Pełna dokumentacja OpenAPI dostępna pod /api-docs.

Autoryzacja

Wszystkie endpointy API wymagają klucza API w nagłówku:

Authorization: Bearer sk_live_xxx

Klucze API zarządzasz w Dashboard → Ustawienia → API Keys.

Podstawowy endpoint: chat

POST /api/v1/chat

Body:

{
  "bot_id": "uuid",
  "session_id": "unique-session-identifier",
  "message": "Chcę umówić wizytę",
  "metadata": { "source": "website" }
}

Response:

{
  "reply": "Chętnie pomogę. Proszę podać imię i preferowany termin.",
  "conversation_id": "uuid",
  "session_id": "...",
  "handoff_requested": false
}

Webhooki

Konfiguruj webhooks w Dashboard → Integracje → Webhooks.

Dostępne zdarzenia:

| Zdarzenie | Opis | |-----------|------| | conversation.started | Nowa rozmowa | | lead.captured | Użytkownik wypełnił formularz | | handoff.requested | Bot prosi o człowieka | | conversation.ended | Rozmowa zakończona |

Każdy webhook wysyłany jest jako POST z nagłówkiem X-DL-Signature (HMAC-SHA256).

Limity

| Plan | Requestów/min | Requestów/dzień | |------|--------------|-----------------| | Starter | 30 | 10 000 | | Pro | 100 | 100 000 | | Business | 500 | bez limitu |