Razlika između znati i provjeriti
Postoje dvije vrste pitanja kupaca. Prva vrsta je opća: Koja je vaša politika povrata? Koliko traje dostava? Šaljete li u Njemačku? Dobro popunjena baza znanja s ovima se nosi.
Druga vrsta je specifična: Gdje je moja narudžba #4521? Je li plava verzija još na lageru? Koliko mi je u paketu ovaj mjesec preostalo? Ovi ne žive u bazi znanja. Žive u vašim sustavima — upravljanje narudžbama, zalihe, naplata — i mijenjaju se svake sekunde.
Chatbot koji se nosi samo s prvom vrstom je dotjerani FAQ. Chatbot koji se nosi i s drugom je asistent. Razlika između njih je pristup API-ju.
Zašto vas taj jaz košta kupaca
Većina današnjih „AI chatova“ izgrađena je samo na bazi znanja. Mogu parafrazirati vašu politiku dostave na sedamnaest jezika, ali kupcu ne mogu reći gdje je njegov paket zapravo upravo sada. Pa kupac pita, bot izbjegava, a kupac ili odustaje ili čeka operatera koji će potražiti iste podatke koje je bot mogao dohvatiti u milisekundama.
To je strop chatbota. Svako „dopustite da to provjerim“ propuštena je prilika da se odgovori u sekundama, na prvoj poruci, dok je namjera kupca još vruća.
Što API veze zapravo rade
U enuchatu, API veza je konfigurirana spona između chata i jedne od vaših backend usluga. Definirate je jednom: osnovni URL, način autentifikacije i nekoliko endpointa s njihovim parametrima i načinom mapiranja odgovora.
Od tog trenutka AI može tijekom razgovora pozivati te endpointe. Kada posjetitelj pita o narudžbi, AI izvuče broj narudžbe, pozove vaš endpoint, pročita status uživo i utka ga u odgovor. Posjetitelj vidi jednu rečenicu: „Vaša narudžba #4521 poslana je jučer i očekuje se da stigne u četvrtak.“ Iza te rečenice dogodio se pravi API poziv.
Kupac ne vidi cijevi. Vidi samo da chat doista zna.
Pet metoda autentifikacije, bez vlastitog koda
Većina API-ja koje biste željeli povezati već koristi standardnu autentifikaciju. enuchat podržava pet odmah:
- Bez — za javne API-je bez autentifikacije
- API Key — poslan kao zaglavlje ili parametar upita
- Bearer Token — jednostavna autentifikacija tokenom
- Basic Auth — za starije sustave
- OAuth 2.0 client credentials — za moderne pružatelje kao što su Salesforce, HubSpot ili vaš vlastiti OAuth poslužitelj
Za OAuth 2.0 enuchat automatski upravlja životnim ciklusom tokena — dohvaća ga pri prvom pozivu, drži u predmemoriji do isteka, obnavlja po potrebi. Vjerodajnice konfigurirate jednom i zaboravite na njih. Sve vjerodajnice šifrirane su u mirovanju s libsodiumom i nikada se ne pojavljuju u API odgovorima.
Varijable, predlošci i mapiranje odgovora
Endpointi su definirani kao predlošci. Putanja poput /orders/{orderId} ili JSON tijelo koje se odnosi na {customerId} interpolira vrijednosti iz varijabli sesije — varijabli koje AI ili statičko pravilo mogu postaviti tijekom razgovora.
Kada API odgovori, polja iz JSON odgovora mapirate natrag u varijable sesije pomoću točke kao zapisa. data.status postaje order_status. data.shipping.eta postaje delivery_eta. AI zatim te vrijednosti utka u prirodan odgovor — na jeziku posjetitelja.
Tri obrasca koja pokrivaju većinu slučajeva
U praksi, većina API integracija pripada jednom od tri oblika.
Provjeri i odgovori
Posjetitelj postavlja pitanje na koje se može odgovoriti jednim API pozivom. Pravilo aktivira CALL_API, a zatim REPLY_AI. AI dobivene podatke koristi za sastavljanje kontekstualnog, utemeljenog odgovora. Status narudžbe, stanje računa, dostupnost sobe, trenutne cijene, praćenje pošiljke — sve to spada ovamo.
Provjeri i preusmjeri
API poziv vraća dovoljno informacija da odluči o sljedećem koraku. Premium račun eskaliran je na seniornijeg agenta. Istekla pretplata preusmjerava se na naplatu. AI koristi CALL_API, a zatim ASSIGN_TO_OPERATOR kako bi donosio odluke o preusmjeravanju na temelju stvarnih podataka o kupcu, a ne nagađanja.
Višekoračni tijekovi
Prva poruka označava razgovor pomoću SET_VARIABLE, druga aktivira API poziv kada je kontekst dovoljan, a treća sastavlja odgovor. Korisno kada trebate potvrditi namjeru prije pinganja backenda ili kada upit za podatke ovisi o nečemu što je posjetitelj rekao dvije poruke prije.
Ugrađena sigurnost
Povezivanje backenda s chat widgetom čini neke timove nervoznima — i to s pravom. enuchat nudi nekoliko slojeva zaštite po zadanom:
- SSRF zaštita blokira pozive na localhost, privatne IP-jeve i interne hostnames
- Vremensko ograničenje od 5 sekundi sprječava da spori API zaglavi razgovor
- Tenant izolacija znači nula curenja podataka između tenanata — vaši endpointi vidljivi su samo vašim widgetima
- Test gumbi neovisno provjeravaju i vezu i svaki endpoint prije nego ih povežete u pravila
- Šifrirane vjerodajnice nikada se ne vraćaju u dashboard u čistom obliku
Što se mijenja za vaše kupce
Chat prelazi iz „dopustite da pronađem nekoga tko to može provjeriti“ u „provjereno, evo odgovora“ — na bilo kojem od više od 60 jezika, u nedjelju u 3 ujutro, dok vaš tim za podršku spava. Kupci koji bi inače napustili košaricu, narudžbu ili paket ostaju, jer odgovor stiže dok još pitaju.
To je razlika između chatbota i asistenta. I to je razlika koju vaši kupci doista osjete.
Kako započeti
Ako već imate postavljen enuchat, API veze nalaze se pod Postavke → API veze. Odaberite jedan endpoint koji odgovara na pitanje koje vaš tim tipka sto puta tjedno — status narudžbe obično je najučinkovitiji početak. Konfigurirajte vezu, dodajte endpoint, povežite ga s pravilom i jednom ga testirajte prije nego što krenete u produkciju. Pogledajte vodič za API veze za potpun prolazak.
Ako ste novi u enuchatu, registrirajte se na enuchat.com. Besplatni paket uključuje API veze od prvog dana — bez kartice, bez naknada po razgovoru, bez isteka probnog razdoblja.
Pet minuta da priključite prvi endpoint. Prvi koristan odgovor obično stiže istog dana.