Egyéni akciók (CRM)

A chatbot valós adatokat kérdezhet le és írhat bármilyen külső rendszerbe.

Az egyéni akciók lehetővé teszik, hogy a chatbot a párbeszéd során valós adatokat kérdezzen le és írjon külső rendszerekbe — CRM-ekbe, foglalási rendszerekbe, rendeléskövető platformokba. Ehhez nincs szükség fejlesztésre az ügyfél oldalán: elegendő egy HTTP végpont.

Mi az az egyéni akció?

Egy akció egy HTTP API végpont hívása, amelyet az AI automatikusan indít el, ha a párbeszéd kontextusa megkívánja. Az AI dönt arról, hogy az akciót el kell-e hívni, és ha igen, milyen paraméterekkel.

Read vs Write akciók

Read akció: Adatokat kérdez le (pl. rendelés állapota, szabad időpontok). Az eredményt az AI azonnal beépíti a válaszba. Nincs megerősítési lépés.
Write akció: Adatokat módosít (pl. foglalás, rendelés lemondása). Mindig megerősítési lépéssel jár — az AI összefoglalja a látogatónak, mit akar csinálni, és megkérdezi, hogy valóban folytatja-e.

Konfigurálás

Az akciók a dashboard chatbot beállítások oldalán, az Akciók fülön konfigurálhatók:

Név: Emberi olvasható cím (pl. "Rendelés állapot lekérdezése")
Leírás: Természetes nyelvi leírás az AI számára — ebből dönt az AI, mikor hívja meg az akciót.
URL: A külső API végpont teljes URL-je.
HTTP metódus: GET, POST, PUT vagy DELETE.
Paraméter séma: JSON Schema formátumban megadott paraméterek, amelyeket az AI tölt ki a párbeszédből (pl. rendelésszám, email).
Típus: Read vagy Write.

Authentikáció

Módszer	Mezők	Tipikus használat
API kulcs / Bearer	`api_key`	Legtöbb CRM, SaaS API
Basic Auth	`username`, `password`	Örökölt rendszerek, ERP-k
Egyéni fejlécek	Kulcs-érték párok	Nem szabványos auth megoldások

Az API hitelesítő adatok titkosítva tárolódnak az adatbázisban, és soha nem kerülnek ki a chatbot válaszaiban.

Hogyan dönt az AI?

Az AI a Function Calling mechanizmust használja (amely elsősorban az OpenAI esetében érhető el stabilan). Az akció leírása és paraméter sémája automatikusan eszközdefinícióvá (tool) alakul, amelyet az AI a rendszer promptjával együtt kap meg. Az AI a párbeszéd alapján dönt, hogy és mikor hívja meg az akciót — automatikusan kinyerve a szükséges paramétereket (pl. rendelésszámot) a látogató üzeneteiből.

A function calling (eszközhasználat) jelenleg csak OpenAI modell esetén támogatott teljeskörűen. Gemini és Ollama szolgáltatások esetében az akciók megbízhatóan nem aktiválódnak.

Write megerősítés

Ha a chatbot Write akciót akar végrehajtani, előbb összefoglalja a tervezett műveletet és megkérdezi a látogatót:

Chatbot: "Átütemezem az időpontodat péntek 15:00-ra. Folytathatom?"
Látogató: "Igen"
Chatbot: [API hívás] "Kész! Az időpontod átkerült péntek 15:00-ra."

Ha a látogató nem fogadja el, az akció nem hajtódik végre.

Példák

Rendszer	Read akció	Write akció
CRM (HubSpot, Minicrm)	Kapcsolat adatok lekérdezése	Kapcsolat frissítése, deal létrehozása
Foglalási rendszer	Szabad időpontok lekérdezése	Foglalás / átütemezés
Rendeléskövető	Rendelés állapota rendelésszám alapján	Rendelés lemondása
Termék / Készlet	Elérhetőség ellenőrzése	Rendelés leadása

Lead rögzítés Webhookok