A különbség a tudás és az utánanézés között
Kétféle ügyfélkérdés létezik. Az első típus általános: Mi a visszaküldési szabályzatuk? Mennyi ideig tart a szállítás? Szállítanak Németországba? Egy jól feltöltött tudásbázis kezeli ezeket.
A második típus konkrét: Hol van a #4521-es rendelésem? Van még készleten a kék változatból? Mennyi van még hátra a csomagomból ebben a hónapban? Ezek nem a tudásbázisban élnek. A rendszereidben élnek — rendeléskezelés, készlet, számlázás — és másodpercenként változnak.
Egy chatbot, amely csak az első típust tudja kezelni, egy felöltöztetett GYIK. Egy chatbot, amely a másodikat is, az asszisztens. A kettő közti különbség az API-hozzáférés.
Miért kerül ügyfeleidbe ez a hézag
A mai „AI-chatek” többsége csak tudásbázisra épül. El tudják mondani a szállítási szabályzatot tizenhét nyelven, de nem mondják meg az ügyfélnek, hogy hol van valójában a csomagja most. Tehát az ügyfél kérdez, a bot kitér, az ügyfél pedig vagy feladja, vagy egy operátorra vár, aki ugyanazokat az adatokat fogja megnézni, amelyeket a bot ezredmásodpercek alatt lekérhetett volna.
Ez a chatbot plafonja. Minden „máris megnézem” elvesztett alkalom arra, hogy másodpercek alatt válaszolj, az első üzenetnél, amíg az ügyfél szándéka még friss.
Mit csinálnak valójában az API-kapcsolatok
Az enuchat-ben az API-kapcsolat egy beállított kötés a chat és valamelyik backend szolgáltatásod között. Egyszer adod meg: a bázis URL-t, a hitelesítési módot, és néhány végpontot a paramétereikkel és a válasz leképezésével.
Ettől kezdve az AI hívhatja ezeket a végpontokat egy beszélgetés közben. Amikor egy látogató rendelésről kérdez, az AI kinyeri a rendelési számot, meghívja a rendelési végpontodat, kiolvassa az élő státuszt, és beleszövi a válaszba. A látogató egy mondatot lát: „A #4521-es rendelésed tegnap elindult, várhatóan csütörtökön érkezik.” A mondat mögött valódi API-hívás történt.
Az ügyfél nem látja a vízvezetéket. Csak azt látja, hogy a chat tényleg tudja.
Öt hitelesítési módszer, saját kód nélkül
A legtöbb API, amit be akarnál kötni, már szabványos hitelesítést használ. Az enuchat ötöt támogat dobozból:
- Nincs — nyilvános, hitelesítést nem igénylő API-khoz
- API kulcs — fejlécként vagy lekérdezési paraméterként küldve
- Bearer Token — egyszerű, tokennel végzett hitelesítés
- Basic Auth — örökölt rendszerekhez
- OAuth 2.0 client credentials — modern szolgáltatókhoz, mint a Salesforce, HubSpot vagy a saját OAuth-szervered
OAuth 2.0 esetén az enuchat automatikusan kezeli a token életciklusát — első híváskor lekéri, lejáratig cache-eli, szükség esetén megújítja. Egyszer beállítod a hitelesítő adatokat, aztán elfelejted. Minden hitelesítő adat libsodiummal nyugalmi állapotban titkosítva van, és soha nem jelenik meg az API-válaszokban.
Változók, sablonok és válaszleképezés
A végpontok sablonként vannak meghatározva. Egy útvonal, mint a /orders/{orderId}, vagy egy {customerId}-re hivatkozó JSON-törzs, értékeket interpolál a munkamenet-változókból — olyan változókból, amelyeket az AI vagy egy statikus szabály a beszélgetés során állít be.
Amikor az API válaszol, a JSON-válasz mezőit pontjelöléssel képezed le munkamenet-változókra. A data.status order_status lesz. A data.shipping.eta delivery_eta lesz. Az AI ezt követően ezeket az értékeket szövi bele a természetes nyelvű válaszba — a látogató saját nyelvén.
Három minta, ami a legtöbb felhasználási esetet lefedi
A gyakorlatban a legtöbb API-integráció három forma egyikébe esik.
Lekérdez és válaszol
A látogató olyan kérdést tesz fel, amelyre egy API-hívással válaszolható. A szabály CALL_API-t indít, majd REPLY_AI-t. Az AI a lekért adatokból összerakja a megalapozott, kontextusba illeszkedő választ. Rendelési státusz, számlaegyenleg, szabad szoba, aktuális ár, csomagkövetés — mind ide tartozik.
Lekérdez és továbbít
Az API-hívás elég információt ad ahhoz, hogy eldöntsd, mi a következő lépés. Egy prémium fiók egy senior ügyintézőhöz eszkalálódik. Egy lejárt előfizetés a számlázáshoz kerül. Az AI CALL_API-t majd ASSIGN_TO_OPERATOR-t használ, hogy valódi ügyféladatok alapján döntsön az útvonalról, ne találgatás alapján.
Többlépéses folyamatok
Az első üzenet SET_VARIABLE-vel megcímkézi a beszélgetést, a második kiváltja az API-hívást, ha már elég a kontextus, a harmadik pedig összerakja a választ. Hasznos, ha meg akarod erősíteni a szándékot, mielőtt a backendhez nyúlnál, vagy ha a lekérdezés attól függ, amit a látogató két üzenettel korábban mondott.
Beépített biztonság
Backendeket egy chatwidgethez kötni egyes csapatokat idegesít — és joggal. Az enuchat alapból több védelmi réteget kínál:
- SSRF-megelőzés blokkolja a localhost, privát IP-k és belső hosztnevek hívását
- 5 másodperces időtúllépés megakadályozza, hogy egy lassú API megakassza a beszélgetést
- Tenantonkénti elkülönítés azt jelenti, hogy nincs adatszivárgás tenantok között — a végpontjaid csak a saját widgetjeid számára láthatók
- Tesztgombok külön ellenőrzik a kapcsolatot és minden végpontot, mielőtt szabályokba kötnéd
- Titkosított hitelesítő adatok sosem kerülnek vissza tisztán a felületre
Mi változik az ügyfeleid szempontjából
A chat „keresek valakit, aki ezt megnézi”-ből „megnéztem, itt a válasz”-zé alakul — a 60+ nyelv bármelyikén, vasárnap hajnali 3-kor is, miközben a támogatás alszik. Azok az ügyfelek, akik egyébként elhagyták volna a kosarat, a rendelést vagy a csomagot, maradnak, mert a válasz akkor érkezik, amikor még kérdeznek.
Ez a különbség egy chatbot és egy asszisztens között. És ez az a különbség, amit az ügyfeleid valóban éreznek.
Hogyan kezdj bele
Ha már beállítottad az enuchat-et, az API-kapcsolatok itt találhatók: Beállítások → API-kapcsolatok. Válassz egy végpontot, ami egy olyan kérdésre válaszol, amelyet a csapatod hetente százszor begépel — a rendelési státusz általában a legjobban megtérülő kezdés. Állítsd be a kapcsolatot, add hozzá a végpontot, kösd egy szabályhoz, és teszteld egyszer, mielőtt élesbe tennéd. A teljes átfutáshoz lásd az API-kapcsolatok útmutatót.
Ha új vagy az enuchat-en, regisztrálj az enuchat.com-on. A díjmentes csomag az első naptól tartalmazza az API-kapcsolatokat — kártya nélkül, beszélgetésenkénti díj nélkül, próbaidőszak-lejárat nélkül.
Öt perc, hogy bekösd az első végpontot. Az első hasznos válasz általában még aznap megérkezik.