← zurück

API-Dokumentation

Alle öffentlichen Endpunkte werden per Public Site-Key (pk_live_…) authentifiziert — denselben Key nutzt auch das Widget. Der Key ist read-only, auf eine Site beschränkt sowie quota- und ratelimitiert; er darf im Browser stehen. Basis-URL: https://app.zalu.ai

POST/api/v1/chatalle Pläne
Gestreamte, geerdete Chat-Antwort (Server-Sent Events). Antwortet nur aus den Inhalten der Site; ohne Treffer eine ehrliche „weiß ich nicht"-Antwort.
curl -N https://app.zalu.ai/api/v1/chat \
  -H "content-type: application/json" \
  -d '{"siteKey":"pk_live_…","message":"Was kostet der Versand?"}'

# SSE-Stream:
# data: {"type":"meta","conversationId":"…"}
# data: {"type":"citations","items":[{"url":"…","title":"…"}]}
# data: {"type":"delta","text":"Der "}
# data: {"type":"done"}
POST/api/v1/searchab Starter
Suche ohne Generierung — gerankte Treffer (URL, Titel, Snippet, Score).
curl https://app.zalu.ai/api/v1/search \
  -H "content-type: application/json" \
  -d '{"siteKey":"pk_live_…","query":"Versandkosten","limit":5}'

# { "results": [ { "url": "…", "title": "…", "snippet": "…", "score": 0.71 } ] }
POST/api/v1/navigatorab Pro
Intent-Routing: kurze Antwort + relevante Links + erkannter Intent + optionale Aktion aus den konfigurierten Routen.
curl https://app.zalu.ai/api/v1/navigator \
  -H "content-type: application/json" \
  -d '{"siteKey":"pk_live_…","query":"Wie erreiche ich den Support?"}'

# { "reply": "…", "links": [...], "intent": "contact", "action": { "label": "Kontakt", "url": "…" } }
POST/api/v1/formab Pro
KI-Formular: beantwortet Routine-Fragen selbst (mode: "answer") oder liefert die zu sammelnden Felder (mode: "collect").
curl https://app.zalu.ai/api/v1/form \
  -H "content-type: application/json" \
  -d '{"siteKey":"pk_live_…","message":"Ich brauche ein individuelles Angebot"}'

# { "mode": "collect", "intro": "…", "collectFields": [ { "name": "email", "label": "E-Mail" } ] }
POST/api/v1/form/submitab Pro
Formular-Einsendung speichern (Lead). Erscheint im Dashboard unter „Leads".
curl https://app.zalu.ai/api/v1/form/submit \
  -H "content-type: application/json" \
  -d '{"siteKey":"pk_live_…","data":{"name":"Erika","email":"e@x.de","message":"…"}}'

# { "ok": true }
GET/api/widget/config?key=pk_live_…alle Pläne
Öffentliche Widget-Konfiguration (Theme, Sprache, aktive Features). Wird vom Loader genutzt.

Hinweise