API referencia, beágyazási útmutató és fejlesztői segédletek a ChatAutomata platformhoz.
3 lépésben élesítheted az első chatbotodat:
Hozz létre egy fiókot az app.chatautomata.hu oldalon. Az ingyenes csomag is elég a kezdéshez.
A dashboardon kattints az „Új chatbot" gombra. Adj nevet, válassz AI modellt, és töltsd fel a tudásbázisodat (FAQ-k, PDF-ek, vagy webcímek).
Másold be az alábbi kódot a weboldalad </body> tagje elé — és kész!
Egyetlen script-tag hozzáadásával megjelenik a chatbot-widget az oldaladon:
<script src="https://embed.chatautomata.hu/w.js?id=CHATBOT_ID" async></script>A CHATBOT_ID-t a dashboard chatbot-szerkesztő oldalán találod.
Kizárt oldalak: A chatbot szerkesztőben megadhatsz URL-mintákat, ahol a widget NEM jelenik meg.
Automatikus megnyitás: Beállítható külön desktopra és mobilra, hogy a widget automatikusan nyíljon-e meg betöltés után.
Proaktív megszólítás: Az AI néhány másodperc után automatikusan üdvözli a látogatót, ha még nem írt üzenetet.
Alap URL: https://api.chatautomata.hu — minden végpont JSON-t fogad és ad vissza, kivéve az SSE stream-eket.
| Módszer | Végpont | Leírás | Auth |
|---|---|---|---|
| GET | /v1/chat/sse | SSE stream — EventSource-kompatibilis | Opcionális |
| POST | /v1/chat | Üzenet küldése (SSE stream válasz) | Opcionális |
| GET | /v1/chat/messages | Session üzenetek lekérése | Nem |
| Módszer | Végpont | Leírás | Auth |
|---|---|---|---|
| GET | /v1/chatbots | Chatbotok listázása | Bearer JWT |
| POST | /v1/chatbots | Új chatbot létrehozása | Bearer JWT |
| PATCH | /v1/chatbots/:id | Chatbot szerkesztése (60+ mező) | Bearer JWT |
| DELETE | /v1/chatbots/:id | Chatbot törlése | Bearer JWT |
| Módszer | Végpont | Leírás | Auth |
|---|---|---|---|
| GET | /v1/faqs?chatbotId=xxx | FAQ-k lekérése | Bearer JWT |
| POST | /v1/faqs | FAQ létrehozása (auto-embedding) | Bearer JWT |
| PATCH | /v1/faqs/:id | FAQ szerkesztése | Bearer JWT |
| DELETE | /v1/faqs/:id | FAQ törlése | Bearer JWT |
| POST | /v1/faqs/import | Tömeges import (JSON/CSV, max 500) | Bearer JWT |
| Módszer | Végpont | Leírás | Auth |
|---|---|---|---|
| GET | /v1/conversations | Beszélgetések listázása | Bearer JWT |
| GET | /v1/conversations/:id | Beszélgetés részletei + üzenetek | Bearer JWT |
| GET | /v1/leads | Lead-ek listázása | Bearer JWT |
| PATCH | /v1/leads/:id | Lead státusz frissítése | Bearer JWT |
| Módszer | Végpont | Leírás | Auth |
|---|---|---|---|
| GET | /v1/webhooks | Regisztrált webhook-ok | Bearer JWT |
| POST | /v1/webhooks | Webhook regisztrálása | Bearer JWT |
| POST | /v1/webhooks/:id/test | Tesztpayload küldése | Bearer JWT |
| Módszer | Végpont | Leírás | Auth |
|---|---|---|---|
| GET | /health | Konténer healthcheck | Nem |
| GET | /v1/status | Részletes rendszer-státusz (JSON) | Nem |
A legtöbb API végpont Bearer JWT tokent vár az Authorization headerben:
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...A tokent a POST /v1/auth/login végponttól kapod:
POST /v1/auth/login
Content-Type: application/json
{
"email": "pelda@ceg.hu",
"password": "jelszo123"
}
// Válasz:
{
"accessToken": "eyJhbG...",
"refreshToken": "eyJhbG...",
"user": { "id": "...", "email": "pelda@ceg.hu" }
}Az access token 15 percig érvényes. A refresh token 7 napig — a POST /v1/auth/refresh végponttal megújítható.
BYOK (Bring Your Own Key): A chatbot-konfiguráció saját AI kulcsokat is elfogad (OpenAI, Anthropic, Gemini, stb.). Ezek AES-256-GCM titkosítással tárolódnak a platformon.
Minden kimenő webhook HMAC-SHA256 aláírást kap:
X-ChatAutomata-Signature: sha256=a1b2c3d4e5f6...
X-ChatAutomata-Event: new_conversation
X-ChatAutomata-Timestamp: 1716652800Ellenőrzés: számítsd ki a HMAC-SHA256(webhook_secret, timestamp + "." + body) értéket és hasonlítsd össze az aláírással.
new_conversation — Új beszélgetés indultnew_lead — Lead rögzítvenegative_rating — Negatív értékelés érkezettkeyword_match — Kulcsszó-egyezés a beszélgetésbenlong_conversation — Beszélgetés elérte a küszöbértéketA chatbot megjelenése 60+ beállítással finomhangolható a PATCH /v1/chatbots/:id végponton vagy a dashboard szerkesztőben: