Erinevus teadmise ja järelevaatamise vahel
Kliendi küsimusi on kahte sorti. Esimene sort on üldine: Mis on teie tagastuspoliitika? Kui kaua võtab tarne aega? Kas saadate Saksamaale? Hästi varustatud teadmistebaas saab nendega hakkama.
Teine sort on konkreetne: Kus on minu tellimus #4521? Kas sinine versioon on veel laos? Kui palju on mul tariifist sel kuul jäänud? Need ei ela teadmistebaasis. Need elavad teie süsteemides — tellimuste haldus, ladu, arveldus — ja muutuvad iga sekund.
Vestlusrobot, mis tuleb toime ainult esimese sordiga, on uhkeldav KKK. Vestlusrobot, mis tuleb toime ka teisega, on assistent. Nende kahe vahe on API-juurdepääs.
Miks see lõhe maksab teile kliente
Enamik tänaseid „AI-vestlusi“ on ehitatud üksnes teadmistebaasile. Nad oskavad teie tarnepoliitikat seitsmeteistkümnes keeles parafraseerida, kuid ei oska kliendile öelda, kus tema pakk päriselt praegu on. Nii klient küsib, robot väldib, ja klient kas annab alla või ootab operaatorit, kes vaatab samad andmed üle, mille robot oleks saanud millisekundite jooksul.
See on vestlusroboti lagi. Iga „lubage mul see üle vaadata“ on kaotatud võimalus vastata sekunditega, esimese sõnumi peale, kuni kliendi kavatsus on veel kuum.
Mida API-ühendused tegelikult teevad
enuchat-is on API-ühendus konfigureeritud sild vestluse ja ühe teie taustateenuse vahel. Te määratlete selle ühe korra: baas-URL, autentimismeetod ja peotäis lõpp-punkte koos parameetrite ja vastuse vastendusega.
Sealt edasi võib AI vestluse ajal neid lõpp-punkte kutsuda. Kui külastaja küsib tellimuse kohta, võtab AI tellimuse numbri, kutsub teie tellimuse lõpp-punkti, loeb otsestaatust ja põimib selle vastusesse. Külastaja näeb ühte lauset: „Teie tellimus #4521 saadeti välja eile ja jõuab eeldatavasti neljapäeval.“ Selle lause taga toimus päris API-kutse.
Klient ei näe torustikku. Ta näeb vaid, et vestlus tegelikult teab.
Viis autentimismeetodit, ilma kohandatud koodita
Enamik API-sid, mida sooviksite ühendada, kasutab juba standardset autentimist. enuchat toetab viit otse karbist:
- Puudub — avalikele API-dele, mis ei nõua autentimist
- API Key — saadetakse päise või päringu parameetrina
- Bearer Token — lihtne tokenipõhine autentimine
- Basic Auth — pärandsüsteemidele
- OAuth 2.0 client credentials — modernsetele teenusepakkujatele nagu Salesforce, HubSpot või teie enda OAuth-serverile
OAuth 2.0 puhul haldab enuchat tokeni elutsüklit automaatselt — hangib esimese kutse ajal, hoiab vahemälus kuni aegumiseni, värskendab vajadusel. Konfigureerite mandaadid ühe korra ja unustate. Kõik mandaadid krüpteeritakse libsodium-iga seisundis ega ilmu kunagi API-vastustes.
Muutujad, mallid ja vastuste vastendamine
Lõpp-punktid määratletakse mallidena. Tee nagu /orders/{orderId} või JSON-keha, mis viitab {customerId}-le, interpoleerib väärtused seansimuutujatest — muutujatest, mida AI või staatiline reegel saavad vestluse ajal seada.
Kui API vastab, vastendate JSON-vastuse väljad tagasi seansimuutujatesse punkti-notatsiooniga. data.status saab order_status-iks. data.shipping.eta saab delivery_eta-ks. AI seejärel põimib need väärtused loomulikku vastusesse — külastaja enda keeles.
Kolm mustrit, mis katavad enamiku kasutusjuhte
Praktikas langeb enamik API-integratsioone ühte kolmest vormist.
Vaata üle ja vasta
Külastaja esitab küsimuse, millele saab vastata ühe API-kutsega. Reegel käivitab CALL_API, millele järgneb REPLY_AI. AI kasutab toodud andmeid kontekstipärase, põhjendatud vastuse koostamiseks. Tellimuse staatus, konto saldo, toa saadavus, hetkehinnad, paki jälgimine — kõik need sobivad siia.
Vaata üle ja suuna
API-kutse tagastab piisavalt teavet, et otsustada järgmise sammu üle. Premium-konto eskaleerib vanemagendile. Aegunud tellimus suunab arveldusele. AI kasutab CALL_API-d, millele järgneb ASSIGN_TO_OPERATOR, et teha marsruutimisotsuseid päris kliendiandmete põhjal, mitte arvamise põhjal.
Mitmeetapilised vood
Esimene sõnum sildistab vestluse SET_VARIABLE-iga, teine käivitab API-kutse, kui konteksti on piisavalt, ja kolmas koostab vastuse. Kasulik, kui peate enne taustasüsteemi pingimist kavatsuse kinnitama või kui andmepäring sõltub millestki, mida külastaja kaks sõnumit varem ütles.
Sisseehitatud turvalisus
Taustarakendite ühendamine vestlusvidinaga teeb mõned meeskonnad närviliseks — õigustatult. enuchat tarnib vaikimisi mitut kaitsekihti:
- SSRF-i vältimine blokeerib kutsed localhost-i, privaatsetele IP-dele ja sisemistele hostinimedele
- 5-sekundi aegumine takistab aeglasel API-l vestlust kinni jätmast
- Üürniku eraldamine tähendab nullriski andmete lekkimisele üürnike vahel — teie lõpp-punktid on nähtavad ainult teie vidinatele
- Testimisnupud kontrollivad sõltumatult nii ühendust kui iga lõpp-punkti enne reeglitesse ühendamist
- Krüpteeritud mandaadid ei naase kunagi armatuurlauale loetaval kujul
Mis muutub teie klientide jaoks
Vestlus liigub fraasilt „lubage mul leida keegi, kes saab seda kontrollida“ fraasile „kontrollitud, siin on vastus“ — ükskõik millises 60+ keelest, pühapäeval kell 3 öösel, kui teie tugimeeskond magab. Kliendid, kes muidu oleks ostukorvi, tellimuse või paketi maha jätnud, jäävad alles, sest vastus saabub veel siis, kui nad küsivad.
See on erinevus vestlusroboti ja assistendi vahel. Ja see on erinevus, mida teie kliendid päriselt tunnevad.
Kuidas alustada
Kui teil on enuchat juba seadistatud, asuvad API-ühendused jaotises Sätted → API-ühendused. Valige üks lõpp-punkt, mis vastab küsimusele, mida teie meeskond kirjutab sada korda nädalas — tellimuse staatus on tavaliselt suurima võimendusega lähtekoht. Konfigureerige ühendus, lisage lõpp-punkt, ühendage see reegliga ja testige üks kord enne otseülekannet. Täielikuks ülevaateks vt API-ühenduste juhendit.
Kui olete enuchat-is uus, registreeruge aadressil enuchat.com. Tasuta tase sisaldab API-ühendusi alates esimesest päevast — kaarti pole vaja, vestlusepõhist tasu pole, prooviperiood ei aegu.
Viis minutit oma esimese lõpp-punkti ühendamiseks. Esimene kasulik vastus saabub tavaliselt sama päevaga.