Razlika med vedeti in pogledati
Obstajata dve vrsti vprašanj strank. Prva vrsta je splošna: Kakšna je vaša politika vračil? Koliko časa traja dostava? Pošiljate v Nemčijo? Dobro založena baza znanja s temi obvladuje.
Druga vrsta je specifična: Kje je moje naročilo #4521? Je modra različica še na zalogi? Koliko mi je v paketu ta mesec še ostalo? Te ne živijo v bazi znanja. Živijo v vaših sistemih — upravljanje naročil, zaloga, obračun — in se spreminjajo vsako sekundo.
Chatbot, ki obvlada le prvo vrsto, je polepšan FAQ. Chatbot, ki obvlada tudi drugo, je asistent. Razlika med njima je dostop do API.
Zakaj vas ta vrzel stane strank
Večina današnjih „AI klepetov“ stoji izključno na bazi znanja. Vedo parafrazirati vašo politiko dostave v sedemnajstih jezikih, a stranki ne morejo povedati, kje je njen paket dejansko zdaj. Stranka torej vpraša, bot se izogne, in stranka bodisi obupa bodisi čaka na operaterja, ki bo iskal iste podatke, ki bi jih bot lahko pridobil v milisekundah.
To je strop chatbota. Vsak „naj preverim“ je zamujena priložnost odgovoriti v sekundah, na prvem sporočilu, dokler je namera stranke še topla.
Kaj API povezave dejansko počnejo
V enuchatu je API povezava konfigurirana vez med klepetom in eno od vaših backend storitev. Definirate jo enkrat: osnovni URL, način avtentikacije in nekaj endpointov z njihovimi parametri ter načinom mapiranja odgovora.
Od tega trenutka lahko AI med pogovorom kliče te endpointe. Ko obiskovalec vpraša po naročilu, AI izvleče številko, pokliče vaš endpoint za naročila, prebere status v živo in ga vplete v odgovor. Obiskovalec vidi en stavek: „Vaše naročilo #4521 je bilo včeraj odposlano in pričakovano prispe v četrtek.“ Za tem stavkom se je zgodil resničen API klic.
Stranka ne vidi cevi. Vidi le, da klepet resnično ve.
Pet metod avtentikacije, brez prilagojene kode
Večina API-jev, ki jih želite povezati, že uporablja standardno avtentikacijo. enuchat podpira pet kar takoj:
- Brez — za javne API-je brez avtentikacije
- API Key — poslan kot glava ali parameter poizvedbe
- Bearer Token — preprosta avtentikacija s tokenom
- Basic Auth — za starejše sisteme
- OAuth 2.0 client credentials — za moderne ponudnike kot Salesforce, HubSpot ali vaš lasten OAuth strežnik
Pri OAuth 2.0 enuchat samodejno upravlja življenjski cikel tokena — pridobi ga pri prvem klicu, ga shrani v predpomnilnik do izteka, obnovi po potrebi. Poverilnice nastavite enkrat in pozabite na njih. Vse poverilnice so šifrirane v mirovanju z libsodium in se v API odgovorih nikoli ne pojavijo.
Spremenljivke, predloge in mapiranje odgovorov
Endpointi so definirani kot predloge. Pot kot /orders/{orderId} ali JSON telo, ki se sklicuje na {customerId}, interpolira vrednosti iz spremenljivk seje — spremenljivk, ki jih AI ali statično pravilo lahko nastavita med pogovorom.
Ko API odgovori, polja iz JSON odgovora preslikate nazaj v spremenljivke seje s piknim zapisom. data.status postane order_status. data.shipping.eta postane delivery_eta. AI nato te vrednosti vtke v naravni odgovor — v jeziku obiskovalca.
Trije vzorci, ki pokrivajo večino primerov
V praksi večina API integracij sodi v eno od treh oblik.
Poišči in odgovori
Obiskovalec postavi vprašanje, na katerega je mogoče odgovoriti z enim API klicem. Pravilo sproži CALL_API, ki mu sledi REPLY_AI. AI uporabi pridobljene podatke za sestavo kontekstualnega, utemeljenega odgovora. Status naročila, stanje računa, razpoložljivost sobe, trenutne cene, sledenje paketa — vse to spada sem.
Poišči in usmeri
API klic vrne dovolj informacij za odločitev o naslednjem koraku. Premium račun se eskalira k starejšemu agentu. Potekla naročnina se preusmeri v obračun. AI uporabi CALL_API, ki mu sledi ASSIGN_TO_OPERATOR, da sprejme odločitve o usmerjanju na podlagi resničnih podatkov o stranki, ne na podlagi ugibanja.
Več-koračni tokovi
Prvo sporočilo z SET_VARIABLE označi pogovor, drugo sproži API klic, ko je dovolj konteksta, in tretje sestavi odgovor. Uporabno, ko morate potrditi namero, preden povprašate backend, ali ko poizvedba podatkov odvisi od nečesa, kar je obiskovalec rekel dve sporočili nazaj.
Vgrajena varnost
Povezovanje backendov s klepetalnim widgetom nekatere ekipe živčnost. Upravičeno. enuchat privzeto ponuja več zaščitnih plasti:
- Preprečevanje SSRF blokira klice na localhost, zasebne IP-je in interna gostiteljska imena
- 5-sekundni časovni odmik prepreči, da bi počasen API obesil pogovor
- Ločevanje po tenantih pomeni nič uhajanja podatkov med tenanti — vaši endpointi so vidni le vašim widgetom
- Testni gumbi neodvisno preverijo povezavo in vsak endpoint, preden ga povežete v pravilo
- Šifrirane poverilnice se v nadzorno ploščo nikoli ne vrnejo v jasnem zapisu
Kaj se spremeni za vaše stranke
Klepet preide iz „dovolite, da poiščem nekoga, ki to preveri“ v „preverjeno, tukaj je odgovor“ — v katerem koli od 60+ jezikov, v nedeljo ob 3. uri zjutraj, ko vaša ekipa za podporo spi. Stranke, ki bi sicer zapustile košarico, naročilo ali paket, ostanejo, ker odgovor prispe, medtem ko še sprašujejo.
To je razlika med chatbotom in asistentom. In je razlika, ki jo vaše stranke dejansko čutijo.
Kako začeti
Če enuchat že imate postavljen, API povezave najdete pod Nastavitve → API povezave. Izberite endpoint, ki odgovarja na vprašanje, ki ga vaša ekipa tipka stokrat na teden — status naročila je običajno najboljši začetni vzvod. Nastavite povezavo, dodajte endpoint, povežite ga s pravilom in ga enkrat preizkusite, preden pojdete v produkcijo. Glejte vodnik za API povezave za celoten sprehod.
Če ste v enuchat novi, se prijavite na enuchat.com. Brezplačni paket vsebuje API povezave od prvega dne — brez kartice, brez stroška na pogovor, brez izteka preizkusne dobe.
Pet minut, da priklopite prvi endpoint. Prvi koristen odgovor običajno prispe še istega dne.